sp_changedynamicsnapshot_job (Transact-SQL)

Modifica el trabajo de agente que genera la instantánea para una suscripción a una publicación con un filtro de fila con parámetros. Este procedimiento almacenado se ejecuta en el publicador de la base de datos de publicaciones.

Icono de vínculo a temasConvenciones de sintaxis de Transact-SQL

Sintaxis

sp_changedynamicsnapshot_job [ @publication = ] 'publication'
    [ , [ @dynamic_snapshot_jobname = ] 'dynamic_snapshot_jobname' ]
    [ , [ @dynamic_snapshot_jobid = ] 'dynamic_snapshot_jobid' ]
    [ , [ @frequency_type = ] frequency_type ] 
    [ , [ @frequency_interval = ] frequency_interval ] 
    [ , [ @frequency_subday = ] frequency_subday ] 
    [ , [ @frequency_subday_interval = ] frequency_subday_interval ] 
    [ , [ @frequency_relative_interval = ] frequency_relative_interval ] 
    [ , [ @frequency_recurrence_factor = ] frequency_recurrence_factor ] 
    [ , [ @active_start_date = ] active_start_date ] 
    [ , [ @active_end_date = ] active_end_date ] 
    [ , [ @active_start_time_of_day = ] active_start_time_of_day ] 
    [ , [ @active_end_time_of_day = ] active_end_time_of_day ] 
    [ , [ @job_login = ] 'job_login' ] 
    [ , [ @job_password = ] 'job_password' ] 

Argumentos

  • [ @publication=] 'publication'
    Es el nombre de la publicación. publication es de tipo sysname y no tiene ningún valor predeterminado.

  • [ @dynamic_snapshot_jobname = ] 'dynamic_snapshot_jobname'
    Es el nombre del trabajo de instantánea que se cambia. dynamic_snapshot_jobname es de tipo sysname y su valor predeterminado es N'%'. Si se especifica dynamic_snapshot_jobid, se debe utilizar el valor predeterminado de dynamic_snapshot_jobname.

  • [ @dynamic_snapshot_jobid = ] 'dynamic_snapshot_jobid'
    Es el Id. del trabajo de instantánea que se cambia. dynamic_snapshot_jobid es de tipo uniqueidentifier y su valor predeterminado es NULL. Si se especifica dynamic_snapshot_jobname, se debe utilizar el valor predeterminado de dynamic_snapshot_jobid.

  • [ @frequency_type = ] frequency_type
    Es la frecuencia con que se programa el agente. frequency_type es de tipo int y puede tener uno de estos valores.

    Valor

    Descripción

    1

    Una vez

    2

    A petición

    4

    Diariamente

    8

    Semanalmente

    16

    Mensualmente

    32

    Mensualmente relativa

    64

    Iniciar automáticamente

    128

    Periódica

    NULL (predeterminado)

     

  • [ @frequency_interval = ] frequency_interval
    Los días en los que se ejecuta el agente. frequency_interval es de tipo int y puede tener uno de los valores siguientes.

    Valor

    Descripción

    1

    Domingo

    2

    Lunes

    3

    Martes

    4

    Miércoles

    5

    Jueves

    6

    Viernes

    7

    Sábado

    8

    Día

    9

    Días laborables

    10

    Días del fin de semana

    NULL (predeterminado)

     

  • [ @frequency_subday = ] frequency_subday
    Es la frecuencia con la que se vuelve a programar durante el período definido. frequency_subday es de tipo int y puede tener uno de los siguientes valores.

    Valor

    Descripción

    1

    Una vez

    2

    Segundo

    4

    Minuto

    8

    Hora

    NULL (predeterminado)

     

  • [ @frequency_subday_interval = ] frequency_subday_interval
    Es el intervalo de frequency_subday. frequency_subday_interval es de tipo int y su valor predeterminado es NULL.

  • [ @frequency_relative_interval = ] frequency_relative_interval
    Es la fecha de ejecución del Agente de mezcla. Este parámetro se utiliza cuando frequency_type se ha establecido en 32 (mensual relativa). frequency_relative_interval es de tipo int y puede tener uno de los siguientes valores.

    Valor

    Descripción

    1

    Primero

    2

    Segundo

    4

    Tercero

    8

    Cuarto

    16

    Último

    NULL (predeterminado)

     

  • [ @frequency_recurrence_factor = ] frequency_recurrence_factor
    Es el factor de periodicidad utilizado por frequency_type. frequency_recurrence_factor es de tipo int y su valor predeterminado es NULL.

  • [ @active_start_date = ] active_start_date
    Es la fecha en la que comienza la programación del Agente de mezcla, en formato YYYYMMDD. active_start_date es de tipo int y su valor predeterminado es NULL.

  • [ @active_end_date = ] active_end_date
    Es la fecha en que se detiene la programación del Agente de mezcla, en formato YYYYMMDD. active_end_date es de tipo int y su valor predeterminado es NULL.

  • [ @active_start_time_of_day = ] active_start_time_of_day
    Hora del día de la primera programación del Agente de mezcla, con el formato HHMMSS. active_start_time_of_day es de tipo int y su valor predeterminado es NULL.

  • [ @active_end_time_of_day = ] active_end_time_of_day
    Hora del día de en que se detiene la programación del Agente de mezcla, con el formato HHMMSS. active_end_time_of_day es de tipo int y su valor predeterminado es NULL.

  • [ @job_login= ] 'job_login'
    Es la cuenta de Microsoft Windows con la que se ejecuta el Agente de instantáneas al generar la instantánea para una suscripción con un filtro de fila con parámetros. job_login es de tipo nvarchar(257) y su valor predeterminado es NULL.

  • [ @job_password= ] 'job_password'
    Es la contraseña de la cuenta de Windows con la que se ejecuta el Agente de instantáneas al generar la instantánea para una suscripción con un filtro de fila con parámetros. job_password es de tipo nvarchar(257) y su valor predeterminado es NULL.

    Nota de seguridadNota de seguridad

    Cuando sea posible, pida a los usuarios que proporcionen credenciales de seguridad en tiempo de ejecución. Si debe almacenar las credenciales en un archivo de script, proteja el archivo para evitar el acceso no autorizado.

Valores de código de retorno

0 (correcto) o 1 (error)

Notas

sp_changedynamicsnapshot_job se utiliza en la replicación de mezcla para publicaciones con filtros de fila con parámetros.

Después de cambiar un inicio de sesión o una contraseña de agente, debe detener y reiniciar el agente para que el cambio surta efecto.

Permisos

Sólo los miembros de la función fija de servidor sysadmin o de la función fija de base de datos db_owner pueden ejecutar sp_changedynamicsnapshot_job.