sp_changedynamicsnapshot_job (Transact-SQL)
Se aplica a: SQL Server Azure SQL Managed Instance
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 publicación.
Convenciones de sintaxis de Transact-SQL
Sintaxis
sp_changedynamicsnapshot_job
[ @publication = ] N'publication'
[ , [ @dynamic_snapshot_jobname = ] N'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 = ] N'job_login' ]
[ , [ @job_password = ] N'job_password' ]
[ ; ]
Argumentos
[ @publication = ] N'publication'
Nombre de la publicación. @publication es sysname, sin ningún valor predeterminado.
[ @dynamic_snapshot_jobname = ] N'dynamic_snapshot_jobname'
Nombre del trabajo de instantánea que se va a cambiar. @dynamic_snapshot_jobname es sysname, con un valor predeterminado de %
.
Si se especifica @dynamic_snapshot_jobid , debe usar el valor predeterminado para @dynamic_snapshot_jobname.
[ @dynamic_snapshot_jobid = ] 'dynamic_snapshot_jobid'
Identificador del trabajo de instantánea que se va a cambiar. @dynamic_snapshot_jobid es uniqueidentifier, con un valor predeterminado de NULL
.
Si se especifica @dynamic_snapshot_jobname , debe usar el valor predeterminado para @dynamic_snapshot_jobid.
[ @frequency_type = ] frequency_type
Especifica la frecuencia con la que programar 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 |
Diario |
8 |
Semanal |
16 |
Mensual |
32 |
Mensualmente relativa |
64 |
Iniciar automáticamente |
128 |
Periódico |
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
Especifica la frecuencia con la que se vuelve a programar durante el período definido. @frequency_subday es int y puede ser uno de los siguientes valores.
Valor | Descripción |
---|---|
1 |
Una vez |
2 |
Second |
4 |
Minute |
8 |
Hora |
NULL (valor predeterminado) |
[ @frequency_subday_interval = ] frequency_subday_interval
Intervalo de @frequency_subday. @frequency_subday_interval es int, con un valor predeterminado de NULL
.
[ @frequency_relative_interval = ] frequency_relative_interval
Fecha en que se ejecuta el Agente de mezcla. Este parámetro se usa cuando @frequency_type se establece 32
en (relativo mensual). @frequency_relative_interval es int y puede ser uno de los siguientes valores.
Valor | Descripción |
---|---|
1 |
First |
2 |
Segundo |
4 |
Tercero |
8 |
Cuarta |
16 |
Último |
NULL (valor predeterminado) |
[ @frequency_recurrence_factor = ] frequency_recurrence_factor
Factor de periodicidad utilizado por @frequency_type. @frequency_recurrence_factor es int, con un valor predeterminado de NULL
.
[ @active_start_date = ] active_start_date
Fecha en la que el Agente de mezcla se programa por primera vez, con el formato yyyyMMdd
. @active_start_date es int, con un valor predeterminado de NULL
.
[ @active_end_date = ] active_end_date
Fecha en la que el Agente de mezcla deja de programarse, con el formato yyyyMMdd
. @active_end_date es int, con un valor predeterminado de NULL
.
[ @active_start_time_of_day = ] active_start_time_of_day
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 int, con un valor predeterminado de NULL
.
[ @active_end_time_of_day = ] active_end_time_of_day
Hora del día en que el Agente de mezcla deja de programarse, con formato HHmmss
. @active_end_time_of_day es int, con un valor predeterminado de NULL
.
[ @job_login = ] N'job_login'
La cuenta de Windows con la que se ejecuta el Agente de instantáneas al generar la instantánea para una suscripción mediante un filtro de fila con parámetros. @job_login es nvarchar(257), con un valor predeterminado de NULL
.
[ @job_password = ] N'job_password'
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 mediante un filtro de fila con parámetros. @job_password es sysname, con un valor predeterminado de NULL
.
Importante
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
(erróneo).
Comentarios
sp_changedynamicsnapshot_job
se usa 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 db_owner rol fijo de base de datos pueden ejecutar sp_changedynamicsnapshot_job
.