sp_MSchange_snapshot_agent_properties (Transact-SQL)

S’applique à :SQL Server

Modifie les propriétés d’un travail de l’Agent d’instantané qui s’exécute sur un serveur de distribution microsoft SQL Server 2005 (9.x) ou version ultérieure. Cette procédure stockée permet de modifier les propriétés lorsque le serveur de publication s’exécute sur une instance de Microsoft SQL Server 2000 (8.x). Cette procédure stockée est exécutée au niveau du serveur de distribution sur la base de données de distribution.

Conventions de la syntaxe 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 sysname, sans valeur par défaut.

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

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

[ @frequency_type = ] frequency_type Fréquence à laquelle l’Agent d’instantané est exécuté. frequency_type est int et peut être l’une de ces valeurs.

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

[ @frequency_subday = ] frequency_subday Unités de freq_subday_interval. frequency_subday est int et peut être l’une de ces valeurs.

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

[ @frequency_relative_interval = ] frequency_relative_interval Date à laquelle l’Agent d’instantané s’exécute. frequency_relative_interval est int, sans valeur par défaut.

[ @frequency_recurrence_factor = ] frequency_recurrence_factor Facteur de périodicité utilisé par frequency_type. frequency_recurrence_factor est int, sans valeur par défaut.

[ @active_start_date = ] active_start_date Date à laquelle l’Agent d’instantané est planifié pour la première fois, mis en forme comme yyyyMMdd. active_start_date est int, sans valeur par défaut.

[ @active_end_date = ] active_end_date Date à laquelle l’Agent d’instantané cesse d’être planifié, mis en forme comme yyyyMMddsuit : active_end_date est int, sans valeur par défaut.

[ @active_start_time_of_day = ] active_start_time_of_day Heure du jour où l’Agent d’instantané est planifié pour la première fois, mis en forme comme HHmmss. active_start_time_of_day est int, sans valeur par défaut.

[ @active_end_time_of_day = ] active_end_time_of_day Heure du jour où l’Agent d’instantané cesse d’être planifié, mis en forme en tant que HHmmss. active_end_time_of_day est int, sans valeur par défaut.

[ @snapshot_job_name = ] 'snapshot_agent_name' Nom d’un travail de l’Agent d’instantané existant si un travail existant est utilisé. instantané_agent_name est 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 int, sans valeur par défaut. 0 spécifie l’authentification SQL Server et 1 spécifie l’authentification Windows. Une valeur de 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 utilisée lors de la connexion au serveur de publication. publisher_login est sysname, sans valeur par défaut. publisher_login devez être spécifié lorsque publisher_security_mode est 0. Si publisher_login est NULL et publisher*_*security_mode est 1, le compte Windows spécifié dans job_login sera 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 nvarchar(524), sans valeur par défaut.

[ @job_login = ] 'job_login' Connexion du compte Windows sous lequel l’agent s’exécute. job_login est nvarchar(257), sans valeur par défaut. Ce compte Windows est toujours utilisé pour les connexions des agents au serveur de distribution. Vous devez fournir ce paramètre lorsque vous créez un nouveau travail d'Agent d'instantané. Cela ne peut pas être modifié 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 sysname, sans valeur par défaut. Vous devez fournir ce paramètre lorsque vous créez un nouveau travail d'Agent d'instantané.

[ @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 sysname et peut être l’une des valeurs suivantes.

Pour plus d’informations sur les différences entre un serveur de publication Oracle et un serveur de publication Oracle Gateway, consultez Vue d’ensemble de la publication Oracle.

Codet de retour

0 (réussite) ou 1 (échec)

Notes

sp_MSchange_instantané_agent_properties est utilisé dans la réplication instantané, la réplication transactionnelle et la réplication de fusion.

Vous devez spécifier tous les paramètres lors de l’exécution de sp_MSchange_instantané_agent_properties. Exécutez sp_helppublication_instantané pour retourner les propriétés actuelles du travail de l’Agent d’instantané.

Lorsque le serveur de publication s’exécute sur une instance de SQL Server 2005 (9.x) ou version ultérieure, vous devez utiliser sp_changepublication_instantané pour modifier les propriétés d’un travail de l’Agent d’instantané.

Autorisations

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

Voir aussi

sp_addpublication_instantané (Transact-SQL)