sp_changepublication_snapshot (Transact-SQL)

Modifie les propriétés de l'Agent d'instantané pour la publication spécifiée. Cette procédure stockée est exécutée au niveau du serveur de publication dans la base de données de publication.

Remarque relative à la sécurité

Lors de la configuration d'un serveur de publication avec un serveur de distribution distant, les valeurs fournies pour tous les paramètres, y compris job_login et job_password, sont envoyées en texte brut au serveur de distribution. Vous devriez chiffrer la connexion entre le serveur de publication et son serveur de distribution distant avant d'exécuter cette procédure stockée. Pour plus d'informations, consultez Activer les connexions chiffrées dans le moteur de base de données (Gestionnaire de configuration SQL Server).

Conventions de la syntaxe de Transact-SQL

Syntaxe

sp_changepublication_snapshot [ @publication= ] 'publication'
    [ , [ @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 ]
    [ , [ @snapshot_job_name = ] 'snapshot_agent_name' ]
    [ , [ @publisher_security_mode = ] publisher_security_mode ]
    [ , [ @publisher_login = ] 'publisher_login' ]
    [ , [ @publisher_password = ] 'publisher_password' ] 
    [ , [ @job_login = ] 'job_login' ]
    [ , [ @job_password = ] 'job_password' ]
    [ , [ @publisher = ] 'publisher' ]

Arguments

• [ @publication =] 'publication'
  Nom de la publication. publication est de type sysname et n'a pas de valeur par défaut.

• [ @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	Quotidienne
  8	Hebdomadaire
  16	Mensuelle
  32	Mensuelle relative
  64	Démarrage automatique
  128	Périodique
  NULL (par défaut)

• [ @frequency_interval =] frequency_interval
  Spécifie les jours d'exécution de l'Agent. 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
  Unités pour freq_subday_interval. 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 d'instantané. frequency_relative_interval est de type int, avec NULL comme valeur 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 d'instantané est planifié pour la première fois, 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 d'instantané cesse d'être planifié, 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 à laquelle l’Agent d'instantané est planifié pour la première fois, 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 à laquelle l’Agent d'instantané cesse d'être planifié, au format HHMMSS. active_end_time_of_day est de type int, avec NULL comme valeur par défaut.

• [ @snapshot_job_name = ] 'snapshot_agent_name'
  Nom d'un travail existant de l'Agent d'instantané si un travail existant est en cours d'utilisation. snapshot_agent_name est de type nvarchar(100), avec NULL comme valeur par défaut.

• [ @publisher_security_mode = ] publisher_security_mode
  Mode de sécurité utilisé par l'agent lors de la connexion au serveur de publication. publisher_security_mode est de type smallint, avec NULL comme valeur par défaut. La valeur 0 spécifie une authentification SQL Server, tandis que la valeur 1 indique une authentification Windows. La valeur 0 doit être spécifiée pour les serveurs de publication non-SQL Server.

  Remarque relative à la sécurité
  Lorsque c'est possible, utilisez l'authentification Windows.

• [ @publisher_login = ] 'publisher_login'
  Connexion au serveur de publication. publisher_login est de type sysname, avec NULL comme valeur par défaut. publisher_login doit être spécifié lorsque publisher_security_mode a la valeur 0. Si publisher_login prend la valeur NULL et que publisher_security_modeest défini sur 1, le compte Windows spécifié dans job_login est utilisé lors de la connexion au serveur de publication.

• [ @publisher_password = ] 'publisher_password'
  Mot de passe utilisé lors de la connexion au serveur de publication. publisher_password est de type sysname, avec NULL comme valeur par défaut.

  Remarque relative à la sécurité
  N'utilisez pas de mot de passe vide. Utilisez un mot de passe fort. Dans la mesure du possible, invitez les utilisateurs à entrer les informations d'identification de sécurité 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é.

• [ @job_login = ] 'job_login'
  Nom de connexion du compte Windows sous lequel l'Agent s'exécute. job_login est de type nvarchar(257), avec NULL comme valeur par défaut. Ce compte Windows est toujours utilisé pour les connexions de l'Agent au serveur de distribution. Vous devez fournir ce paramètre lors de la création d'un nouveau travail de l'Agent d'instantané. Vous ne pouvez pas le modifier pour un serveur de publication non-SQL Server.

• [ @job_password = ] 'job_password'
  Mot de passe du compte Windows sous lequel l'Agent s'exécute. job_password est de type sysname, avec NULL comme valeur par défaut. Vous devez fournir ce paramètre lors de la création d'un nouveau travail de l'Agent d'instantané.

  Remarque relative à la sécurité
  Lorsque c'est possible, demandez aux utilisateurs d'entrer leurs 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 ce fichier pour empêcher un accès non autorisé.

• [ @publisher = ] 'publisher'
  Spécifie un serveur de publication non SQL Server. publisher est de type sysname, avec NULL comme valeur par défaut.

  [!REMARQUE]

  publisher ne doit pas être utilisé lors de la création d'un Agent d'instantané sur un serveur de publication SQL Server.

Valeurs des codes de retour

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

Notes

sp_changepublication_snapshot est utilisée au cours d'une réplication transactionnelle, d'instantané et de fusion.

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 la procédure sp_changepublication_snapshot.

Voir aussi

Référence

sp_addpublication_snapshot (Transact-SQL)

Procédures stockées système (Transact-SQL)

Concepts

Afficher et modifier les propriétés d'une publication

Modifier les propriétés des publications et des articles