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.

Icono de vínculo a temasConvenciones 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 sysnamey 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 del trabajo de instantáneas de datos filtrados. dynamic_snapshot_jobnamees de tipo sysname, 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

Es la frecuencia con que se programa la ejecución del agente y puede tener uno de los valores siguientes.

1 = Una vez

2 = A petición

4 = Diario

8 = Semanal

16 = Mensual

32 = Relativo mensual

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 = Segunda

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

Sólo los miembros de la función fija de servidor sysadmin, la función fija de base de datos db_owner o la lista de acceso a la publicación para la publicación actual pueden ejecutar sp_helpdynamicsnapshot_job.