Partager via

  • Article

sp_helpdynamicsnapshot_job (Transact-SQL)

Renvoie des informations sur les travaux d'un Agent qui génèrent des captures instantanées filtrées. Cette procédure stockée est exécutée sur la base de données de publication du serveur de publication.

Icône Lien de rubriqueConventions de la syntaxe de Transact-SQL

Syntaxe

sp_helpdynamicsnapshot_job [ [ @publication = ] 'publication' ] 
    [ , [ @dynamic_snapshot_jobname = ] 'dynamic_snapshot_jobname' ]
    [ , [ @dynamic_snapshot_jobid = ] 'dynamic_snapshot_jobid' ]

Arguments

  • [ @publication = ] 'publication'
    Nom de la publication. publication est de type sysname, avec % comme valeur par défaut ; celle-ci renvoie des informations sur tous les travaux de capture instantanée de données filtrées correspondant aux valeurs dynamic_snapshot_jobid et dynamic_snapshot_jobname spécifiées pour toutes les publications.

  • [ @dynamic_snapshot_jobname = ] 'dynamic_snapshot_jobname'
    Nom d'un travail de capture instantanée de données filtrées. dynamic_snapshot_jobname est de type sysname, avec %' comme valeur par défaut ; celle-ci renvoie tous les travaux dynamiques d'une publication correspondant à la valeur dynamic_snapshot_jobid spécifiée. Si aucun nom de travail n'est défini explicitement lors de la création du travail, le nom du travail a le format suivant :

    'dyn_' + <name of the standard snapshot job> + <GUID>

  • [ @dynamic_snapshot_jobid = ] 'dynamic_snapshot_jobid'
    Identificateur d'un travail de capture instantanée de données filtrées. dynamic_snapshot_jobid est de type uniqueidentifier, avec NULL comme valeur par défaut ; celle-ci renvoie tous les travaux de capture instantanée correspondant à la valeur dynamic_snapshot_jobname spécifiée.

Ensembles de résultats

Nom de la colonne

Type de données

Description

id

int

Identifie le travail de capture instantanée de données filtrées.

job_name

sysname

Nom du travail de capture instantanée de données filtrées.

job_id

uniqueidentifier

Identifie le travail de l'Agent MicrosoftSQL Server sur le serveur de distribution.

dynamic_filter_login

sysname

Valeur utilisée pour évaluer la fonction SUSER_SNAME dans un filtre de lignes paramétrable défini pour la publication.

dynamic_filter_hostname

sysname

Valeur utilisée pour évaluer la fonction HOST_SNAME dans un filtre de lignes paramétrable défini pour la publication.

dynamic_snapshot_location

nvarchar(255)

Chemin d'accès au dossier où les fichiers de capture instantanée sont lus si un filtre de lignes paramétrable est utilisé.

frequency_type

int

Fréquence à laquelle l'Agent s'exécute. La valeur peut être l'une des valeur suivantes.

1 = Une seule fois

2 = À la demande

4 = Une fois par jour

8 = Une fois par semaine

16 = Une fois par mois

32 = Relative mensuelle

64 = Démarrage automatique

128 = Périodique

frequency_interval

int

Jours d'exécution de l'Agent. La valeur peut être l'une des valeur suivantes.

1 = Dimanche

2 = Lundi

3 = Mardi

4 = Mercredi

5 = Jeudi

6 = Vendredi

7 = Samedi

8 = Jour

9 = Jours de la semaine

10 = Jours de fin de semaine

frequency_subday_type

int

Type qui définit la fréquence d'exécution de l'Agent lorsque frequency_type prend la valeur 4 (tous les jours). Ce type peut prendre l'une des valeurs suivantes.

1 = Au moment spécifié

2 = Secondes

4 = Minutes

8 = Heures

frequency_subday_interval

int

Nombre d'intervalles de frequency_subday_type entre les exécutions planifiées de l'Agent.

frequency_relative_interval

int

Semaine où l'Agent s'exécute dans un mois donné lorsque frequency_type a la valeur 32 (fréquence mensuelle relative). L'une des valeurs suivantes peut être utilisée.

1 = Première

2 = Deuxième

4 = Troisième

8 = Quatrième

16 = Dernière

frequency_recurrence_factor

int

Nombre de semaines ou de mois entre les exécutions planifiées de l'Agent.

active_start_date

int

Date de la première exécution planifiée de l'Agent, au format AAAAMMJJ.

active_end_date

int

Date de la dernière exécution planifiée de l'Agent, au format AAAAMMJJ.

active_start_time

int

Heure de la première exécution planifiée de l'Agent, au format HHMMSS.

active_end_time

int

Heure de la dernière exécution planifiée de l'Agent, au format HHMMSS.

Valeurs des codes de retour

0 (succès) ou 1 (échec)

Notes

sp_helpdynamicsnapshot_job est utilisé dans la réplication de fusion.

Si toutes les valeurs par défaut des paramètres sont utilisées, les informations sur tous les travaux de capture instantanée de données partitionnées pour l'ensemble de la base de données de publication sont renvoyées.

Autorisations

Seuls les membres du rôle serveur fixe sysadmin, du rôle de base de données fixe db_owner et de la liste d'accès à la publication pour la publication peuvent exécuter sp_helpdynamicsnapshot_job.