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 Jour
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 yyyyMMddsuit : @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.