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 Microsoft SQL Server 2005. Cette procédure stockée permet de modifier les propriétés SQL Server 2005 lorsque le serveur de publication est exécuté sur une instance de Microsoft SQL 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. L'argument publisher est de type sysname et n'a pas de valeur par défaut.

• [ @publisher_db= ] 'publisher_db'
  Nom de la base de données de publication. L'argument publisher_db est de type sysname et n'a pas de valeur par défaut.

• [ @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 d'exécution de l'Agent de capture instantanée. frequency_type est de type int et peut prendre l'une des valeurs suivantes.

  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. L'argument frequency_interval est de type int, sans valeur par défaut.

• [ @frequency_subday=] frequency_subday
  Unités pour freq_subday_interval. L'argument frequency_subday est de type int et peut correspondre à une de ces valeurs :

  Valeur	Description
  1	Une fois
  2	Seconde
  4	Minute
  8	Heure

• [ @frequency_subday_interval=] frequency_subday_interval
  Intervalle pour frequency_subday. L'argument 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. L'argument 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. L'argument 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. L'argument active_end_date est de type int, sans valeur par défaut.

• [ @active_start_time_of_day=] active_start_time_of_day
  Heure du jour 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 d'Agent de capture instantanée existant 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.

• [ @publisher_login= ] 'publisher_login'
  Nom de connexion utilisé pour se connecter au serveur de publication. publisher_login est de type sysname, sans valeur par défaut. L'argument 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 une sécurité maximale, les noms de connexion et les mots de passe doivent être fournis au moment de l'exécution.

• [ @job_login= ] 'job_login'
  Nom de connexion pour le compte Windows sous lequel l'agent s'exécute. job_login est de type nvarchar(257) et ne possède aucune 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 pour le 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 une sécurité maximale, les noms de connexion et les mots de passe doivent être fournis au moment de l'exécution.

• [ @publisher_type= ] 'publisher_type'
  Spécifie le type de serveur de publication lorsque le serveur de publication n'est pas en cours d'exécution dans une instance de SQL Server. publisher_type est de type sysname et peut prendre l'une des valeurs suivantes.

  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, 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 de 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)

Autres ressources

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

Aide et Informations

Assistance sur SQL Server 2005