sp_MSchange_snapshot_agent_properties (Transact-SQL)

Modifie les propriétés d'un travail d'Agent de capture instantanée exécuté sur un serveur de distribution MicrosoftSQL Server 2005 ou version ultérieure. Cette procédure stockée est utilisée pour modifier des propriétés lorsque le serveur de publication s'exécute sur une instance de MicrosoftSQL Server 2000. Elle est exécutée sur la base de données de distribution du serveur de distribution.

Conventions de la syntaxe de Transact-SQL

Syntaxe

sp_MSchange_snapshot_agent_properties [ @publisher = ] 'publisher'
        , [ @publisher_db = ] 'publisher_db'
        , [ @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_type = ] 'publisher_type'

Arguments

• [ @publisher = ] 'publisher'
  Nom du serveur de publication. publisher est de type sysname, sans valeur par défaut.

• [ @publisher_db= ] 'publisher_db'
  Nom de la base de données de publication. publisher_db est de type sysname, sans valeur par défaut.

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

• [ @frequency_type=] frequency_type
  Fréquence d'exécution de l'Agent de capture instantanée. frequency_type est de type int et peut prendre l'une des valeurs ci-dessous.

  Valeur	Description
  1	Une fois
  2	Sur demande
  4	Quotidiennement
  8	Hebdomadairement
  10	Mensuellement
  20	Mensuellement, en fonction de l'intervalle de fréquence
  40	Au démarrage de l'Agent SQL Server

• [ @frequency_interval=] frequency_interval
  Valeur à appliquer à la fréquence définie par frequency_type. frequency_interval est de type int, sans valeur par défaut.

• [ @frequency_subday=] frequency_subday
  Unités de freq_subday_interval. frequency_subday est de type int et peut prendre l'une des valeurs ci-dessous.

  Valeur	Description
  1	Une fois
  2	Seconde
  4	Minute
  8	Heure

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

• [ @frequency_relative_interval=] frequency_relative_interval
  Date d'exécution de l'Agent de capture instantanée. frequency_relative_interval est de type int, sans 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, sans valeur par défaut.

• [ @active_start_date = ] active_start_date
  Date de première planification de l'Agent de capture instantanée, au format AAAAMMJJ. active_start_date est de type int, sans valeur par défaut.

• [ @active_end_date = ] active_end_date
  Date d'arrêt de la planification de l'Agent de capture instantanée, au format AAAAMMJJ. active_end_date est de type int, sans valeur par défaut.

• [ @active_start_time_of_day=] active_start_time_of_day
  Heure de la journée de la première planification de l'Agent de capture instantanée, au format HHMMSS. active_start_time_of_day est de type int, sans valeur par défaut.

• [ @active_end_time_of_day=] active_end_time_of_day
  Heure d'arrêt de la planification de l'Agent de capture instantanée, au format HHMMSS. active_end_time_of_day est de type int, sans valeur par défaut.

• [ @snapshot_job_name = ] 'snapshot_agent_name'
  Nom d'un travail existant de l'Agent de capture instantanée si un travail existant est en cours d'utilisation. snapshot_agent_name est de type nvarchar(100), sans 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 int, sans valeur par défaut. 0 spécifie l'authentification SQL Server et 1 l'authentification Windows. La valeur 0 doit être spécifiée pour les serveurs de publication non SQL Server. Lorsque c'est possible, utilisez l'authentification Windows.

• [ @publisher_login= ] 'publisher_login'
  Nom de connexion utilisé pour la connexion au serveur de publication. publisher_login est de type sysname, sans 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 *_*security_mode est 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é pour se connecter au serveur de publication. publisher_password est de type nvarchar(524) et n'a pas de valeur par défaut.

  Remarque relative à la sécurité
  Ne stockez pas les informations d'authentification dans des fichiers de script. Pour améliorer la sécurité, nous vous recommandons de fournir les noms de connexion et les mots de passe au moment de l'exécution.

• [ @job_login= ] 'job_login'
  Nom de connexion du compte Windows sous lequel l'Agent s'exécute. job_login est de type nvarchar(257), sans valeur par défaut. Ce compte Windows est toujours utilisé pour les connexions d'Agent au serveur de distribution. Vous devez fournir ce paramètre lorsque vous créez un nouveau travail d'Agent de capture instantanée. 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, sans valeur par défaut. Vous devez fournir ce paramètre lorsque vous créez un nouveau travail d'Agent de capture instantanée.

  Remarque relative à la sécurité
  Ne stockez pas les informations d'authentification dans des fichiers script. Pour améliorer la sécurité, nous vous recommandons de fournir les noms de connexion et les mots de passe au moment de l'exécution.

• [ @publisher_type= ] 'publisher_type'
  Spécifie le type de serveur de publication lorsque le serveur de publication n'exécute pas une instance de SQL Server. publisher_type est de type sysname et peut prendre l'une des valeurs ci-dessous.

  Valeur	Description
  MSSQLSERVER	Spécifie un serveur de publication SQL Server.
  ORACLE	Spécifie un serveur de publication Oracle standard.
  ORACLE GATEWAY	Spécifie un serveur de publication Oracle Gateway.

  Pour plus d'informations sur les différences entre un serveur de publication Oracle et un serveur de publication Oracle Gateway, consultez Présentation de la publication Oracle.

Valeurs des codes de retour

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

Notes

sp_MSchange_snapshot_agent_properties est utilisée lors des réplications transactionnelles, de capture instantanée et de fusion.

Vous devez spécifier tous les paramètres lorsque vous exécutez sp_MSchange_snapshot_agent_properties. Exécutez sp_helppublication_snapshot pour retourner les propriétés actuelles du travail d'Agent de capture instantanée.

Lorsque le serveur de publication s'exécute sur une instance de SQL Server 2005 ou version ultérieure, vous devez utiliser sp_changepublication_snapshot pour modifier les propriétés d'un travail d'Agent de capture instantanée.

Autorisations

Seuls les membres du rôle serveur fixe sysadmin sur le serveur de distribution peuvent exécuter sp_MSchange_snapshot_agent_properties.

Voir aussi

Référence

sp_addpublication_snapshot (Transact-SQL)

Concepts

Utilisation de plusieurs versions de SQL Server dans une topologie de réplication