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.

Convenciones 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_jobnamees 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 identificador 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 int, y puede ser uno de los siguientes 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 (valor predeterminado)

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

  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 de la semana
  10	Días del fin de semana
  NULL (valor predeterminado)

• [ @frequency_subday = ] frequency_subday
  Es la frecuencia de repetición de la programación durante el periodo definido. frequency_subday es int, y puede ser uno de los siguientes valores.

  Valor	Descripción
  1	Una vez
  2	Segundo
  4	Minute
  8	Hour
  NULL (valor 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 establece en 32 (mensualmente relativa). frequency_relative_interval es int, y puede ser uno de los siguientes valores.

  Valor	Descripción
  1	Primero
  2	Segundo
  4	Tercero
  8	Cuarto
  16	Último
  NULL (valor predeterminado)

• [ @frequency_recurrence_factor = ] frequency_recurrence_factor
  Es el factor de repetición que se utiliza en 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 que el agente de mezcla se programa por primera vez, con el formato AAAAMMDD. active_start_date es de tipo int y su valor predeterminado es NULL.

• [ @active_end_date = ] active_end_date
  Es la fecha en la que el agente de mezcla deja de estar programado, con el formato AAAAMMDD. active_end_date es de tipo int y su valor predeterminado es NULL.

• [ @active_start_time_of_day = ] active_start_time_of_day
  Es la hora del día en que el agente de mezcla se programa por primera vez, 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
  Es la hora del día en que el agente de mezcla deja de estar programado, 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 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)

Comentarios

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

Solo los miembros del rol fijo de servidor sysadmin o del rol fijo de base de datos db_owner pueden ejecutar sp_changedynamicsnapshot_job.

Vea también

Conceptos

Ver y modificar la configuración de seguridad de la replicación

Instantáneas para publicaciones de combinación con filtros con parámetros