sp_helpdynamicsnapshot_job (Transact-SQL)

S’applique à : SQL Server Azure SQL Managed Instance

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

Conventions de la syntaxe Transact-SQL

Syntaxe

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

Arguments

[ @publication = ] N’publication'

Nom de la publication. @publication est sysname, avec une valeur par défaut %, qui retourne des informations sur tous les travaux d’instantané de données filtrés qui correspondent aux @dynamic_snapshot_jobid et @dynamic_snapshot_jobname spécifiés pour toutes les publications.

[ @dynamic_snapshot_jobname = ] N’dynamic_snapshot_jobname'

Nom d’un travail d’instantané de données filtré. @dynamic_snapshot_jobname est sysname, avec une valeur par défaut , %qui retourne tous les travaux dynamiques d’une publication avec la @dynamic_snapshot_jobname spécifiée. Si un nom de travail n’a pas été spécifié explicitement lors de la création du travail, le nom du travail est au format 'dyn_' + <name of the standard snapshot job> + <GUID>.

[ @dynamic_snapshot_jobid = ] 'dynamic_snapshot_jobid'

Identificateur d’un travail d’instantané de données filtré. @dynamic_snapshot_jobid est uniqueidentifier, avec une valeur par défaut NULL, qui retourne tous les travaux d’instantané qui correspondent à la @dynamic_snapshot_jobname spécifiée.

Jeu de résultats

Nom de la colonne Type de données Description
id int Identifie le travail d'instantané de données filtrées.
job_name sysname Nom du travail d'instantané de données filtrées.
job_id uniqueidentifier Identifie le travail SQL Server Agent 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 composition.
dynamic_filter_hostname sysname Valeur utilisée pour évaluer la fonction HOST_NAME 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 d'instantané 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 fois
2 = À la demande
4 = Quotidien
8 = Hebdomadaire
16 = Mensuel
32 = Relatif mensuel
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 à laquelle l’agent s’exécute quand frequency_type est 4 (quotidien) et peut être l’une de ces valeurs.

1 = Au moment spécifié
2 = Secondes
4 = Minutes
8 = Heures
frequency_subday_interval int Nombre d’intervalles de frequency_subday_type qui se produisent entre l’exécution planifiée de l’agent.
frequency_relative_interval int Semaine pendant laquelle l’agent s’exécute dans un mois donné lorsque frequency_type est 32 (relatif mensuel) et peut être l’une de ces valeurs.

1 = Premier
2 = Seconde
4 = Troisième
8 = Quatrième
16 = Dernier
frequency_recurrence_factor int Nombre de semaines ou de mois entre les exécutions planifiées de l'Agent.
active_start_date int Date à laquelle l’agent est planifié pour la première fois, mis en forme comme yyyyMMdd.
active_end_date int Date à laquelle l’agent est planifié pour la dernière exécution, mise en forme en tant que yyyyMMdd.
active_start_time int Heure à laquelle l’agent est planifié pour la première fois, mis en forme en tant que HHmmss.
active_end_time int Heure à laquelle l’agent est planifié pour la dernière exécution, mise en forme comme HHmmss.

Valeurs des codes de retour

0 (réussite) 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 d'instantané 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 , le rôle de base de données fixe db_owner et la liste d’accès à la publication pour la publication peuvent s’exécuter sp_helpdynamicsnapshot_job.