sp_MSchange_snapshot_agent_properties (Transact-SQL)

Article
05/07/2013

Modifie les propriétés d'un travail d'Agent d'instantané exécuté sur un serveur de distribution Microsoft SQL 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 Microsoft SQL Server 2000. Cette procédure stockée est exécutée sur la base de données de distribution du serveur de distribution.

Icône Lien de rubrique 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 et n'a pas de valeur par défaut.
[ @publisher_db= ] 'publisher_db'
Nom de la base de données de publication. 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 à laquelle l'Agent d'instantané est exécuté. 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
10	Mensuelle
20	Mensuellement, en fonction de l'intervalle de fréquence
40	Au démarrage de l'Agent SQL Server

[ @frequency_interval = ] frequency_interval
Valeur appliquée à la fréquence définie par frequency_type. frequency_interval est de type int et n'a pas de valeur 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
[ @frequency_subday_interval=] frequency_subday_interval
Intervalle pour frequency_subday. frequency_subday_interval est de type int et n'a pas de 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 et n'a pas de 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 et n'a pas de 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 et n'a pas de 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 et n'a pas de 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 et n'a pas de 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 et n'a pas de 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) et n'a pas de 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 et n'a pas de 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'
Connexion au serveur de publication. publisher_login est de type sysname et n'a pas de 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é lors de la connexion 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) et n'a pas de 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 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 et n'a pas de valeur par défaut. Vous devez fournir ce paramètre lorsque vous créez un nouveau travail d'Agent d'instantané.

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 celui-ci n'est pas une instance d'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, d'instantané 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 d'instantané.

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 d'instantané.

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)

Partager via