sp_helpdynamicsnapshot_job (Transact-SQL)sp_helpdynamicsnapshot_job (Transact-SQL)

S’APPLIQUE À : ouiSQL Server ouiAzure SQL Database (Managed Instance uniquement) nonAzure SQL Data Warehouse nonParallel Data Warehouse APPLIES TO: yesSQL Server yesAzure SQL Database (Managed Instance only) noAzure SQL Data Warehouse noParallel Data Warehouse

Renvoie des informations sur les travaux d'un Agent qui génèrent des instantanés filtrés.Returns information on agent jobs that generate filtered data snapshots. Cette procédure stockée est exécutée sur le serveur de publication dans la base de données de publication.This stored procedure is executed at the Publisher on the publication database.

Icône de lien de rubrique Conventions de la syntaxe Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SyntaxeSyntax

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

ArgumentsArguments

[ @publication = ] 'publication'Nom de la publication.[ @publication = ] 'publication' Is the name of the publication. publication % est de type sysname, avec la valeur par défaut, qui retourne des informations sur tous les travaux d’instantané de données filtrées qui correspondent aux dynamic_snapshot_jobidet dynamic_snapshot_jobnamespécifiés pour tous publications.publication is sysname, with a default of %, which returns information on all filtered data snapshot jobs that match the specified dynamic_snapshot_jobidand dynamic_snapshot_jobnamefor all publications.

[ @dynamic_snapshot_jobname = ] 'dynamic_snapshot_jobname'Nom d’un travail d’instantané de données filtrées.[ @dynamic_snapshot_jobname = ] 'dynamic_snapshot_jobname' Is the name of a filtered data snapshot job. dynamic_snapshot_jobnameest de % type sysname, avec', par défaut, qui retourne toutes les tâches dynamiques pour une publication avec le dynamic_snapshot_jobidspécifié.dynamic_snapshot_jobnameis sysname, with default of %', which returns all dynamic jobs for a publication with the specified dynamic_snapshot_jobid. 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 :If a job name was not explicitly specified when the job was created, the job name is in the following 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ées.[ @dynamic_snapshot_jobid = ] 'dynamic_snapshot_jobid' Is an identifier for a filtered data snapshot job. dynamic_snapshot_jobidest de type uniqueidentifier, avec NULL comme valeur par défaut, qui retourne tous les travaux d’instantané correspondant au dynamic_snapshot_jobnamespécifié.dynamic_snapshot_jobidis uniqueidentifier, with default of NULL, which returns all snapshot jobs that match the specified dynamic_snapshot_jobname.

Jeux de résultatsResult Sets

Nom de la colonneColumn name Type de donnéesData type DescriptionDescription
idid intint Identifie le travail d'instantané de données filtrées.Identifies the filtered data snapshot job.
job_namejob_name sysnamesysname Nom du travail d'instantané de données filtrées.Name of the filtered data snapshot job.
job_idjob_id uniqueidentifieruniqueidentifier Identifie le MicrosoftMicrosoft SQL ServerSQL Server travail de l’agent sur le serveur de distribution.Identifies the MicrosoftMicrosoft SQL ServerSQL Server Agent job at the Distributor.
dynamic_filter_logindynamic_filter_login sysnamesysname Valeur utilisée pour évaluer la fonction SUSER_SNAME dans un filtre de lignes paramétrable défini pour la publication.Value used for evaluating the SUSER_SNAME function in a parameterized row filter defined for the publication.
dynamic_filter_hostnamedynamic_filter_hostname sysnamesysname Valeur utilisée pour l’évaluation de la fonction HOST_NAME dans un filtre de lignes paramétrable défini pour la publication.Value used for evaluating the HOST_NAME function in a parameterized row filter defined for the publication.
dynamic_snapshot_locationdynamic_snapshot_location nvarchar(255)nvarchar(255) Chemin d'accès au dossier où les fichiers d'instantané sont lus si un filtre de lignes paramétrable est utilisé.Path to the folder where the snapshot files are read from if a parameterized row filter is used.
frequency_typefrequency_type intint Fréquence à laquelle l'Agent s'exécute. La valeur peut être l'une des valeur suivantes.Is the frequency with which the agent is scheduled to run, which can be one of these values.

1 = une fois1 = One time

2 = à la demande2 = On demand

4 = tous les jours4 = Daily

8 = hebdomadaire8 = Weekly

16 = mensuelle16 = Monthly

32 = mensuelle relative32 = Monthly relative

64 = démarrage automatique64 = Autostart

128 = périodique128 = Recurring
frequency_intervalfrequency_interval Intint Jours d'exécution de l'Agent. La valeur peut être l'une des valeur suivantes.The days that the agent runs, which can be one of these values.

1 = dimanche1 = Sunday

2 = lundi2 = Monday

3 = mardi3 = Tuesday

4 = mercredi4 = Wednesday

5 = jeudi5 = Thursday

6 = vendredi6 = Friday

7 = samedi7 = Saturday

8 = jour8 = Day

9 = jours de la semaine9 = Weekdays

10 = jours de week-end10 = Weekend days
frequency_subday_typefrequency_subday_type intint Type qui définit la fréquence à laquelle l’agent s’exécute lorsque frequency_type a la valeur 4 (quotidienne) et peut prendre l’une des valeurs suivantes.Is the type that defines how often the agent runs when frequency_type is 4 (daily), and can be one of these values.

1 = à l’heure spécifiée1 = At the specified time

2 = secondes2 = Seconds

4 = minutes4 = Minutes

8 = heures8 = Hours
frequency_subday_intervalfrequency_subday_interval Intint Nombre d’intervalles de frequency_subday_type qui se produisent entre l’exécution planifiée de l’agent.Number of intervals of frequency_subday_type that occur between scheduled execution of the agent.
frequency_relative_intervalfrequency_relative_interval intint Semaine pendant laquelle l’agent s’exécute dans un mois donné lorsque frequency_type est 32 (mensuelle relative) et peut prendre l’une des valeurs suivantes.Is the week that the agent runs in a given month when frequency_type is 32 (monthly relative), and can be one of these values.

1 = premier1 = First

2 = seconde2 = Second

4 = troisième4 = Third

8 = quatrième8 = Fourth

16 = dernier16 = Last
frequency_recurrence_factorfrequency_recurrence_factor Intint Nombre de semaines ou de mois entre les exécutions planifiées de l'Agent.Number of weeks or months between the scheduled execution of the agent.
active_start_dateactive_start_date intint Date de la première exécution planifiée de l'Agent, au format AAAAMMJJ.Date when the agent is first scheduled to run, formatted as YYYYMMDD.
active_end_dateactive_end_date intint Date de la dernière exécution planifiée de l'Agent, au format AAAAMMJJ.Date when the agent is last scheduled to run, formatted as YYYYMMDD.
active_start_timeactive_start_time Intint Heure de la première exécution planifiée de l'Agent, au format HHMMSS.Time when the agent is first scheduled to run, formatted as HHMMSS.
active_end_timeactive_end_time intint Heure de la dernière exécution planifiée de l'Agent, au format HHMMSS.Time when the agent is last scheduled to run, formatted as HHMMSS.

Valeurs des codes de retourReturn Code Values

0 (succès) ou 1 (échec)0 (success) or 1 (failure)

NotesRemarks

sp_helpdynamicsnapshot_job est utilisé dans la réplication de fusion.sp_helpdynamicsnapshot_job is used in merge replication.

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.If all of the default parameter values are used, information on all partitioned data snapshot jobs for the entire publication database is returned.

AutorisationsPermissions

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.Only members of the sysadmin fixed server role, the db_owner fixed database role, and the publication access list for the publication can execute sp_helpdynamicsnapshot_job.

Voir aussiSee Also

Procédures stockées système (Transact-SQL)System Stored Procedures (Transact-SQL)