sp_changedynamicsnapshot_job (Transact-SQL)sp_changedynamicsnapshot_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

Modifie le travail de l'Agent qui crée l'instantané d'un abonnement vers une publication avec un filtre de lignes paramétrable.Modifies the agent job that generates the snapshot for a subscription to a publication with a parameterized row filter. 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_changedynamicsnapshot_job [ @publication = ] 'publication'  
    [ , [ @dynamic_snapshot_jobname = ] 'dynamic_snapshot_jobname' ]  
    [ , [ @dynamic_snapshot_jobid = ] 'dynamic_snapshot_jobid' ]  
    [ , [ @frequency_type = ] frequency_type ]   
    [ , [ @frequency_interval = ] frequency_interval ]   
    [ , [ @frequency_subday = ] frequency_subday ]   
    [ , [ @frequency_subday_interval = ] frequency_subday_interval ]   
    [ , [ @frequency_relative_interval = ] frequency_relative_interval ]   
    [ , [ @frequency_recurrence_factor = ] frequency_recurrence_factor ]   
    [ , [ @active_start_date = ] active_start_date ]   
    [ , [ @active_end_date = ] active_end_date ]   
    [ , [ @active_start_time_of_day = ] active_start_time_of_day ]   
    [ , [ @active_end_time_of_day = ] active_end_time_of_day ]   
    [ , [ @job_login = ] 'job_login' ]   
    [ , [ @job_password = ] 'job_password' ]   

ArgumentsArguments

[ @publication = ] 'publication'Nom de la publication.[ @publication = ] 'publication' Is the name of the publication. publication est de type sysname, sans valeur par défaut.publication is sysname, with no default.

[ @dynamic_snapshot_jobname = ] 'dynamic_snapshot_jobname'Nom du travail d’instantané en cours de modification.[ @dynamic_snapshot_jobname = ] 'dynamic_snapshot_jobname' Is the name of the snapshot job being changed. dynamic_snapshot_jobnameest de type sysname, avec N'% 'comme valeur par défaut.dynamic_snapshot_jobnameis sysname, with default value of N'%'. Si dynamic_snapshot_jobid est spécifié, vous devez utiliser la valeur par défaut pour dynamic_snapshot_jobname.If dynamic_snapshot_jobid is specified, you must use the default value for dynamic_snapshot_jobname.

[ @dynamic_snapshot_jobid = ] 'dynamic_snapshot_jobid'ID du travail d’instantané en cours de modification.[ @dynamic_snapshot_jobid = ] 'dynamic_snapshot_jobid' Is the ID of the snapshot job being changed. dynamic_snapshot_jobid est de type uniqueidentifier, avec NULL comme valeur par défaut.dynamic_snapshot_jobid is uniqueidentifier, with default value of NULL. Si dynamic_snapshot_jobnameest spécifié, vous devez utiliser la valeur par défaut pour dynamic_snapshot_jobid.If dynamic_snapshot_jobnameis specified, you must use the default value for dynamic_snapshot_jobid.

[ @frequency_type = ] frequency_typeFréquence de planification de l’agent.[ @frequency_type = ] frequency_type Is the frequency with which to schedule the agent. frequency_type est de type intet peut prendre l’une des valeurs suivantes.frequency_type is int, and can be one of the following values.

ValueValue DescriptionDescription
11 Une foisOne time
22 À la demandeOn demand
44 Tous les joursDaily
88 SemaineWeekly
1616 MoisMonthly
3232 Mensuelle relativeMonthly relative
6464 Démarrage automatiqueAutostart
128128 PériodiqueRecurring
NULL (par défaut)NULL (default)

[ @frequency_interval = ] frequency_intervalJours d’exécution de l’agent.[ @frequency_interval = ] frequency_interval The days that the agent runs. frequency_interval est de type intet peut prendre l’une des valeurs suivantes.frequency_interval is int, and can be one of the following values.

ValueValue DescriptionDescription
11 DimancheSunday
22 LundiMonday
33 MardiTuesday
44 MercrediWednesday
55 JeudiThursday
66 VendrediFriday
77 SamediSaturday
88 JourDay
99 Jours de la semaineWeekdays
1010 Jours de week-endWeekend days
NULL (par défaut)NULL (default)

[ @frequency_subday = ] frequency_subdayFréquence de replanification au cours de la période définie.[ @frequency_subday = ] frequency_subday Is how often to reschedule during the defined period. frequency_subday est de type intet peut prendre l’une des valeurs suivantes.frequency_subday is int, and can be one of the following values.

ValueValue DescriptionDescription
11 Une foisOnce
22 SecondeSecond
44 MinuteMinute
88 HeureHour
NULL (par défaut)NULL (default)

[ @frequency_subday_interval = ] frequency_subday_intervalIntervalle de frequency_subday.[ @frequency_subday_interval = ] frequency_subday_interval Is the interval for frequency_subday. frequency_subday_interval est de type int, avec NULL comme valeur par défaut.frequency_subday_interval is int, with a default of NULL.

[ @frequency_relative_interval = ] frequency_relative_intervalDate à laquelle le Agent de fusion s’exécute.[ @frequency_relative_interval = ] frequency_relative_interval Is the date that the Merge Agent runs. Ce paramètre est utilisé lorsque frequency_type a la valeur 32 (mensuelle relative).This parameter is used when frequency_type is set to 32 (monthly relative). frequency_relative_interval est de type intet peut prendre l’une des valeurs suivantes.frequency_relative_interval is int, and can be one of the following values.

ValueValue DescriptionDescription
11 PremièreFirst
22 SecondeSecond
44 TroisièmeThird
88 QuatrièmeFourth
1616 DernièreLast
NULL (par défaut)NULL (default)

[ @frequency_recurrence_factor = ] frequency_recurrence_factorFacteur de récurrence utilisé par frequency_type.[ @frequency_recurrence_factor = ] frequency_recurrence_factor Is the recurrence factor used by frequency_type. frequency_recurrence_factor est de type int, avec NULL comme valeur par défaut.frequency_recurrence_factor is int, with a default of NULL.

[ @active_start_date = ] active_start_dateDate à laquelle le Agent de fusion est planifié pour la première fois, au format AAAAMMJJ.[ @active_start_date = ] active_start_date Is the date when the Merge Agent is first scheduled, formatted as YYYYMMDD. active_start_date est de type int, avec NULL comme valeur par défaut.active_start_date is int, with a default of NULL.

[ @active_end_date = ] active_end_dateDate à laquelle le Agent de fusion cesse d’être planifié, au format AAAAMMJJ.[ @active_end_date = ] active_end_date Is the date when the Merge Agent stops being scheduled, formatted as YYYYMMDD. active_end_date est de type int, avec NULL comme valeur par défaut.active_end_date is int, with a default of NULL.

[ @active_start_time_of_day = ] active_start_time_of_dayHeure de la journée à laquelle le Agent de fusion est planifié pour la première fois, au format HHMMSS.[ @active_start_time_of_day = ] active_start_time_of_day Is the time of day when the Merge Agent is first scheduled, formatted as HHMMSS. active_start_time_of_day est de type int, avec NULL comme valeur par défaut.active_start_time_of_day is int, with a default of NULL.

[ @active_end_time_of_day = ] active_end_time_of_dayHeure de la journée à laquelle le Agent de fusion cesse d’être planifié, au format HHMMSS.[ @active_end_time_of_day = ] active_end_time_of_day Is the time of day when the Merge Agent stops being scheduled, formatted as HHMMSS. active_end_time_of_day est de type int, avec NULL comme valeur par défaut.active_end_time_of_day is int, with a default of NULL.

[ @job_login = ] 'job_login'MicrosoftMicrosoft Compte Windows sous lequel le agent d’instantané s’exécute lors de la génération de l’instantané pour un abonnement à l’aide d’un filtre de lignes paramétrable.[ @job_login = ] 'job_login' Is the MicrosoftMicrosoft Windows Account under which the Snapshot Agent runs when generating the snapshot for a subscription using a parameterized row filter. job_login est de type nvarchar (257) , avec NULL comme valeur par défaut.job_login is nvarchar(257), with a default value of NULL.

[ @job_password = ] 'job_password'Mot de passe du compte Windows sous lequel le Agent d’instantané s’exécute lors de la génération de l’instantané pour un abonnement à l’aide d’un filtre de lignes paramétrable.[ @job_password = ] 'job_password' Is the password for the Windows Account under which the Snapshot Agent runs when generating the snapshot for a subscription using a parameterized row filter. job_password est de type nvarchar (257) , avec NULL comme valeur par défaut.job_password is nvarchar(257), with a default value of NULL.

Important

Lorsque c'est possible, demande aux utilisateurs de fournir les informations d'identification au moment de l'exécution.When possible, prompt users to enter security credentials at runtime. Si vous devez enregistrer les informations d'identification dans un fichier de script, vous devez sécuriser le fichier pour empêcher un accès non autorisé.If you must store credentials in a script file, you must secure the file to prevent unauthorized access.

Valeurs des codes de retourReturn Code Values

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

NotesRemarks

sp_changedynamicsnapshot_job est utilisé dans la réplication de fusion pour les publications avec des filtres de lignes paramétrables.sp_changedynamicsnapshot_job is used in merge replication for publications with parameterized row filters.

Après avoir modifié le nom de connexion ou le mot de passe d'un Agent, vous devez arrêter et redémarrer celui-ci avant que la modification prenne effet.After changing an agent login or password, you must stop and restart the agent before the change takes effect.

AutorisationsPermissions

Seuls les membres du rôle serveur fixe sysadmin ou du rôle de base de données fixe db_owner peuvent exécuter sp_changedynamicsnapshot_job.Only members of the sysadmin fixed server role or db_owner fixed database role can execute sp_changedynamicsnapshot_job.

Voir aussiSee Also

Afficher et modifier les paramètres de sécurité de la réplication View and Modify Replication Security Settings
Instantanés des publications de fusion avec des filtres paramétrésSnapshots for Merge Publications with Parameterized Filters