sp_helpdynamicsnapshot_job (Transact-SQL)
Devuelve información sobre trabajos del agente que generan instantáneas de datos filtrados. Este procedimiento almacenado se ejecuta en el publicador de la base de datos de publicaciones.
Convenciones de sintaxis de Transact-SQL
Sintaxis
sp_helpdynamicsnapshot_job [ [ @publication = ] 'publication' ]
[ , [ @dynamic_snapshot_jobname = ] 'dynamic_snapshot_jobname' ]
[ , [ @dynamic_snapshot_jobid = ] 'dynamic_snapshot_jobid' ]
Argumentos
[ @publication = ] 'publication'
Es el nombre de la publicación. publication es de tipo sysname y su valor predeterminado es %, que devuelve información sobre todos los trabajos de instantáneas de datos filtrados que coinciden con los parámetros dynamic_snapshot_jobidy dynamic_snapshot_jobnameespecificados para todas las publicaciones.[ @dynamic_snapshot_jobname = ] 'dynamic_snapshot_jobname'
Es el nombre de un trabajo de instantáneas de datos filtrados. dynamic_snapshot_jobnamees de tipo sysname y su valor predeterminado es %', que devuelve todos los trabajos dinámicos para una publicación con el parámetro dynamic_snapshot_jobid especificado. Si no se especificó un nombre de trabajo explícitamente cuando se creó el trabajo, el formato del nombre del trabajo es el siguiente:'dyn_' + <name of the standard snapshot job> + <GUID>
[ @dynamic_snapshot_jobid = ] 'dynamic_snapshot_jobid'
Es un identificador para un trabajo de instantáneas de datos filtrados. dynamic_snapshot_jobides de tipo uniqueidentifier y su valor predeterminado es NULL, que devuelve todos los trabajos de instantáneas que coinciden con el parámetro dynamic_snapshot_jobname especificado.
Conjuntos de resultados
Nombre de columna |
Tipo de datos |
Descripción |
---|---|---|
id |
int |
Identifica el trabajo de instantáneas de datos filtrados. |
job_name |
sysname |
Nombre del trabajo de instantáneas de datos filtrados. |
job_id |
uniqueidentifier |
Identifica el trabajo del Agente de Microsoft SQL Server en el distribuidor. |
dynamic_filter_login |
sysname |
Valor utilizado para evaluar la función SUSER_SNAME en un filtro de fila con parámetros definido para la publicación. |
dynamic_filter_hostname |
sysname |
Valor utilizado para evaluar la función HOST_NAME en un filtro de fila con parámetros definido para la publicación. |
dynamic_snapshot_location |
nvarchar(255) |
Ruta a la carpeta de la que se leen los archivos de instantáneas si se utiliza un filtro de fila con parámetros. |
frequency_type |
int |
Se trata de la frecuencia de ejecución programada del agente, que puede ser uno de estos valores. 1 = Una vez 2 = A petición 4 = Diario 8 = Semanal 16 = Mensual 32 = Mensualmente relativa 64 = Inicio automático 128 = Periódica |
frequency_interval |
int |
Los días en los que se ejecuta el agente; puede tener los valores siguientes. 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 |
frequency_subday_type |
int |
Es el tipo que define la frecuencia con que se ejecuta el agente cuando el valor de frequency_type es 4 (diario), y puede tener los valores siguientes. 1 = A la hora especificada 2 = Segundos 4 = Minutos 8 = Horas |
frequency_subday_interval |
int |
Número de intervalos de frequency_subday_type entre las ejecuciones programadas del agente. |
frequency_relative_interval |
int |
Es la semana de un mes dado en la que se ejecuta el agente cuando el valor de frequency_type es 32 (relativo mensual), y puede tener los valores siguientes. 1 = Primera 2 = Segundo 4 = Tercera 8 = Cuarta 16 = Última |
frequency_recurrence_factor |
int |
Número de semanas o meses entre las ejecuciones programadas del agente. |
active_start_date |
int |
Fecha en que se programa la primera ejecución del agente, con el formato AAAAMMDD. |
active_end_date |
int |
Fecha en que se programa la última ejecución del agente, con el formato AAAAMMDD. |
active_start_time |
int |
Hora en que se programa la primera ejecución del agente, con el formato HHMMSS. |
active_end_time |
int |
Hora en que se programa la última ejecución del agente, con el formato HHMMSS. |
Valores de código de retorno
0 (correcto) o 1 (error)
Comentarios
sp_helpdynamicsnapshot_job se utiliza en la replicación de mezcla.
Si se utilizan todos los valores de parámetros predeterminados, se devuelve información sobre todos los trabajos de instantáneas de datos con particiones para toda la base de datos de publicaciones.
Permisos
Solo los miembros del rol fijo de servidor sysadmin, del rol fijo de base de datos db_owner y de la lista de acceso a la publicación para la publicación actual pueden ejecutar sp_helpdynamicsnapshot_job.