Partager via


sp_changedynamicsnapshot_job (Transact-SQL)

Modifie le travail de l'Agent qui crée la capture instantanée d'un abonnement vers une publication avec un filtre de lignes paramétrable. Cette procédure stockée est exécutée au niveau du serveur de publication dans la base de données de publication.

Icône Lien de rubriqueConventions de la syntaxe de 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 publication. publication est de type sysname, sans valeur par défaut.

  • [ @dynamic_snapshot_jobname = ] 'dynamic_snapshot_jobname'
    Nom du travail de capture instantanée en cours de modification. dynamic_snapshot_jobname est de type sysname, avec N'%' comme valeur par défaut. Si l'argument dynamic_snapshot_jobid est spécifié, vous devez utiliser la valeur par défaut de dynamic_snapshot_jobname.

  • [ @dynamic_snapshot_jobid = ] 'dynamic_snapshot_jobid'
    ID du travail de capture instantanée en cours de modification. dynamic_snapshot_jobid est de type uniqueidentifier, avec NULL comme valeur par défaut. Si l'argument dynamic_snapshot_jobname est spécifié, vous devez utiliser la valeur par défaut de dynamic_snapshot_jobid.

  • [ @frequency_type = ] frequency_type
    Fréquence de planification de l'Agent. frequency_type est de type int et peut prendre l'une des valeurs suivantes.

    Valeur

    Description

    1

    Une fois

    2

    À la demande

    4

    Chaque jour

    8

    Chaque semaine

    16

    Chaque mois

    32

    Mensuel relatif

    64

    Démarrage automatique

    128

    Périodique

    NULL (par défaut)

     

  • [ @frequency_interval = ] frequency_interval
    Jours où l'Agent est exécuté. frequency_interval est de type int et peut prendre 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 de replanification au cours de la période définie. frequency_subday est de type int et peut prendre l'une des valeurs suivantes.

    Valeur

    Description

    1

    Une fois

    2

    Seconde

    4

    Minute

    8

    Heure

    NULL (par défaut)

     

  • [ @frequency_subday_interval = ] frequency_subday_interval
    Intervalle pour frequency_subday. frequency_subday_interval est de type int, avec NULL comme valeur par défaut.

  • [ @frequency_relative_interval = ] frequency_relative_interval
    Date d'exécution de l'Agent de fusion. Ce paramètre est utilisé lorsque frequency_type a la valeur 32 (fréquence mensuelle relative). frequency_relative_interval est de type int et peut prendre l'une des valeurs suivantes.

    Valeur

    Description

    1

    Premier

    2

    Deuxième

    4

    Troisième

    8

    Quatrième

    16

    Dernier

    NULL (par défaut)

     

  • [ @frequency_recurrence_factor = ] frequency_recurrence_factor
    Facteur de récurrence utilisé par frequency_type. frequency_recurrence_factor est de type int, avec NULL comme valeur par défaut.

  • [ @active_start_date = ] active_start_date
    Date à laquelle l'Agent de fusion est planifié pour la première fois, représentée au format AAAAMMJJ. active_start_date est de type int, avec NULL comme valeur par défaut.

  • [ @active_end_date = ] active_end_date
    Date à laquelle l'Agent de fusion cesse d'être planifié, représentée au format AAAAMMJJ. active_end_date est de type int, avec NULL comme valeur par défaut.

  • [ @active_start_time_of_day=] active_start_time_of_day
    Heure de la journée à laquelle l'Agent de fusion est planifié pour la première fois, représentée au format HHMMSS. active_start_time_of_day est de type int, avec NULL comme valeur par défaut.

  • [ @active_end_time_of_day=] active_end_time_of_day
    Heure de la journée à laquelle l'Agent de fusion cesse d'être planifié, représentée au format HHMMSS. active_end_time_of_day est de type int, avec NULL comme valeur par défaut.

  • [ @job_login= ] 'job_login'
    Compte Microsoft Windows sous lequel l'Agent de capture instantanée s'exécute lors de la création d'une capture instantanée d'un abonnement qui utilise un filtre de lignes paramétrable. job_login est de type nvarchar(257), avec NULL comme valeur par défaut.

  • [ @job_password= ] 'job_password'
    Mot de passe du compte Windows sous lequel l'Agent de capture instantanée s'exécute lors de la création d'une capture instantanée d'un abonnement qui utilise un filtre de lignes paramétrable. job_password est de type nvarchar(257), avec NULL comme valeur par défaut.

    Remarque relative à la sécuritéRemarque relative à la sécurité

    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 renvoyés

0 (succès) ou 1 (échec)

Notes

sp_changedynamicsnapshot_job s'utilise 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 du rôle de base de données fixe db_owner peuvent exécuter sp_changedynamicsnapshot_job.