sp_changedynamicsnapshot_job (Transact-SQL)

Article
02/01/2024

S’applique à :SQL Server Azure SQL Managed Instance

Modifie le travail de l'Agent qui crée l'instantané d'un abonnement vers une publication avec un filtre de lignes paramétrable. 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_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' ]

Arguments

[ @publication = ] 'publication' Nom de la composition. la publication est sysname, sans valeur par défaut.

[ @dynamic_snapshot_jobname = ] 'dynamic_snapshot_jobname'Nom du travail instantané en cours de modification. dynamic_instantané_jobname est sysname, avec la valeur par défaut N'%'. Si dynamic_instantané_jobid est spécifié, vous devez utiliser la valeur par défaut pour dynamic_instantané_jobname.

[ @dynamic_snapshot_jobid = ] 'dynamic_snapshot_jobid'ID du travail instantané en cours de modification. dynamic_instantané_jobid est uniqueidentifier, avec la valeur par défaut NULL. Si dynamic_instantané_jobnameest spécifié, vous devez utiliser la valeur par défaut pour dynamic_instantané_jobid.

[ @frequency_type = ] frequency_type Fréquence à laquelle planifier l’agent. frequency_type est int et peut être l’une des valeurs suivantes.

Valeur	Description
1	Ponctuelle
2	À la demande
4	Journalier
8	Hebdomadaire
16	Mensuelle
32	Mensuelle relative
64	Autostart
128	Récurrent
NULL (par défaut)

[ @frequency_interval = ] frequency_interval Jours pendant lesquels l’agent s’exécute. frequency_interval est int et peut être l’une des valeurs suivantes.

Valeur	Description
1	Dimanche
2	Lundi
3	Mardi
4	Mercredi
5	Jeudi
6	Vendredi
7	Samedi
8	Jour
9	Jours de la semaine
10	Jours de week-end
NULL (par défaut)

[ @frequency_subday = ] frequency_subday Fréquence à replanifier pendant la période définie. frequency_subday est int et peut être l’une des valeurs suivantes.

Valeur	Description
1	Une fois
2	Second
4	Minute
8	Hour
NULL (par défaut)

[ @frequency_subday_interval = ] frequency_subday_interval Intervalle de frequency_subday. frequency_subday_interval est int, avec une valeur par défaut null.

[ @frequency_relative_interval = ] frequency_relative_intervalDate à laquelle le Agent de fusion s’exécute. Ce paramètre est utilisé lorsque frequency_type est défini sur 32 (relatif mensuel). frequency_relative_interval est int et peut être l’une des valeurs suivantes.

Valeur	Description
1	Premier
2	Second
4	Troisième
8	Quatrième
16	Dernier
NULL (par défaut)

[ @frequency_recurrence_factor = ] frequency_recurrence_factor Facteur de périodicité utilisé par frequency_type. frequency_recurrence_factor est int, avec une valeur par défaut null.

[ @active_start_date = ] active_start_dateDate à laquelle la Agent de fusion est planifiée pour la première fois, mise en forme comme yyyyMMddsuit : active_start_date est int, avec la valeur null par défaut.

[ @active_end_date = ] active_end_dateDate à laquelle la Agent de fusion cesse d’être planifiée, mise en forme comme yyyyMMddsuit : active_end_date est int, avec une valeur par défaut null.

[ @active_start_time_of_day = ] active_start_time_of_dayHeure du jour où le Agent de fusion est planifié pour la première fois, mis en forme comme HHmmss. active_start_time_of_day est int, avec la valeur null par défaut.

[ @active_end_time_of_day = ] active_end_time_of_dayHeure du jour où l’Agent de fusion cesse d’être planifiée, mise en forme comme HHmmss. active_end_time_of_day est int, avec une valeur par défaut null.

[ @job_login = ] 'job_login'Compte Microsoft Windows sous lequel l’Agent d’instantané s’exécute lors de la génération du instantané d’un abonnement à l’aide d’un filtre de lignes paramétrable. job_login est nvarchar(257), avec une valeur par défaut null.

[ @job_password = ] 'job_password'Mot de passe du compte Windows sous lequel l’Agent d’instantané s’exécute lors de la génération du instantané pour un abonnement à l’aide d’un filtre de lignes paramétrable. job_password est nvarchar(257), avec une valeur par défaut null.

Important

Lorsque c'est possible, demande aux utilisateurs de fournir les informations d'identification au moment de l'exécution. 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é.

Codet de retour

0 (réussite) ou 1 (échec)

Notes

sp_changedynamicinstantané_job est utilisé dans la réplication de fusion pour les publications avec des filtres de lignes paramétrés.

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.

Autorisations

Seuls les membres du rôle serveur fixe sysadmin ou db_owner rôle de base de données fixe peuvent exécuter sp_changedynamicinstantané_job.

Voir aussi

Afficher et modifier les paramètres de sécurité de la réplication
Instantanés des publications de fusion avec des filtres paramétrés