sp_changedynamicsnapshot_job (Transact-SQL)
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 = ] N'publication'
[ , [ @dynamic_snapshot_jobname = ] N'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 = ] N'job_login' ]
[ , [ @job_password = ] N'job_password' ]
[ ; ]
Arguments
[ @publication = ] N’publication'
Nom de la publication. @publication est sysname, sans valeur par défaut.
[ @dynamic_snapshot_jobname = ] N’dynamic_snapshot_jobname'
Nom du travail d’instantané en cours de modification. @dynamic_snapshot_jobname est sysname, avec la valeur par défaut %
.
Si @dynamic_snapshot_jobid est spécifié, vous devez utiliser la valeur par défaut pour @dynamic_snapshot_jobname.
[ @dynamic_snapshot_jobid = ] 'dynamic_snapshot_jobid'
ID du travail d’instantané en cours de modification. @dynamic_snapshot_jobid est uniqueidentifier, avec la valeur par défaut NULL
.
Si @dynamic_snapshot_jobname est spécifié, vous devez utiliser la valeur par défaut pour @dynamic_snapshot_jobid.
[ @frequency_type = ] frequency_type
Spécifie la fréquence avec laquelle planifier l’agent. @frequency_type est int et peut être l’une des valeurs suivantes.
Valeur | Description |
---|---|
1 |
Ponctuelle |
2 |
À la demande |
4 |
Quotidiennement |
8 |
Hebdomadaire |
16 |
Mensuelle |
32 |
Mensuelle relative |
64 |
Démarrage automatique |
128 |
Récurrent |
NULL (valeur par défaut) |
[ @frequency_interval = ] frequency_interval
Jours où l'Agent est exécuté. @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 |
Day |
9 |
Jours de la semaine |
10 |
Jours de week-end |
NULL (valeur par défaut) |
[ @frequency_subday = ] frequency_subday
Spécifie la 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 |
Heure |
NULL (valeur par défaut) |
[ @frequency_subday_interval = ] frequency_subday_interval
Intervalle de @frequency_subday. @frequency_subday_interval est int, avec la valeur par défaut NULL
.
[ @frequency_relative_interval = ] frequency_relative_interval
Date à laquelle le Agent de fusion s’exécute. Ce paramètre est utilisé lorsque @frequency_type est défini 32
sur (relatif mensuel). @frequency_relative_interval est int et peut être l’une des valeurs suivantes.
Valeur | Description |
---|---|
1 |
First |
2 |
Second |
4 |
Third |
8 |
Quatrième |
16 |
Dernière |
NULL (valeur par défaut) |
[ @frequency_recurrence_factor = ] frequency_recurrence_factor
Facteur de périodicité utilisé par @frequency_type. @frequency_recurrence_factor est int, avec la valeur par défaut NULL
.
[ @active_start_date = ] active_start_date
Date à laquelle la Agent de fusion est planifiée pour la première fois, mise en forme en tant que yyyyMMdd
. @active_start_date est int, avec une valeur par défaut de NULL
.
[ @active_end_date = ] active_end_date
Date à laquelle la Agent de fusion cesse d’être planifiée, mise en forme comme yyyyMMdd
suit : @active_end_date est int, avec une valeur par défaut de NULL
.
[ @active_start_time_of_day = ] active_start_time_of_day
Heure du jour où la Agent de fusion est planifiée pour la première fois, mise en forme comme HHmmss
. @active_start_time_of_day est int, avec la valeur par défaut NULL
.
[ @active_end_time_of_day = ] active_end_time_of_day
Heure du jour où la Agent de fusion cesse d’être planifiée, mise en forme comme HHmmss
. @active_end_time_of_day est int, avec la valeur par défaut NULL
.
[ @job_login = ] N’job_login'
Compte Windows sous lequel l’Agent d’instantané s’exécute lors de la génération de l’instantané d’un abonnement à l’aide d’un filtre de lignes paramétrable. @job_login est nvarchar(257), avec la valeur par défaut NULL
.
[ @job_password = ] N’job_password'
Mot de passe du compte Windows sous lequel l’Agent d’instantané s’exécute lors de la génération de l’instantané d’un abonnement à l’aide d’un filtre de lignes paramétrable. @job_password est sysname, avec la 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é.
Valeurs des codes de retour
0
(réussite) or 1
(échec).
Notes
sp_changedynamicsnapshot_job
est utilisé dans la réplication de fusion pour les publications avec des filtres de lignes paramétrables.
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 s’exécuter sp_changedynamicsnapshot_job
.