sp_MSchange_snapshot_agent_properties (Transact-SQL)

  • Article

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 sql Server 2005 (9.x) ou version ultérieure. Cette procédure stockée est utilisée pour modifier les propriétés lorsque le serveur de publication s’exécute sur une instance de 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 = ] N'publisher'
    , [ @publisher_db = ] N'publisher_db'
    , [ @publication = ] N'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 = ] N'snapshot_job_name'
    , [ @publisher_security_mode = ] publisher_security_mode
    , [ @publisher_login = ] N'publisher_login'
    , [ @publisher_password = ] N'publisher_password'
    , [ @job_login = ] N'job_login'
    , [ @job_password = ] N'job_password'
    , [ @publisher_type = ] N'publisher_type'
[ ; ]

Arguments

[ @publisher = ] N’publisher'

Nom du serveur de publication. @publisher est sysname, sans valeur par défaut.

[ @publisher_db = ] N’publisher_db'

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

[ @publication = ] N’publication'

Nom de la publication. @publication est sysname, sans valeur par défaut.

[ @frequency_type = ] frequency_type

Spécifie la fréquence à laquelle l’Agent d’instantané est exécuté. @frequency_type est int et peut être l’une de ces valeurs.

Valeur Description
1 Une fois
2 À la demande
4 Quotidiennement
8 Hebdomadaire
10 Mensuelle
20 Mensuellement, en fonction de l'intervalle de fréquence
40 Quand SQL Server Agent démarre

[ @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 @frequency_subday_interval. @frequency_subday est int et peut être l’une de ces valeurs.

Valeur Description
1 Une fois
2 Second
4 Minute
8 Heure

[ @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 en tant que 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 en tant que yyyyMMdd. @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 HHmmsssuit : @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 = ] N’snapshot_job_name'

Nom d’un nom de travail de l’Agent d’instantané existant si un travail existant est utilisé. @snapshot_job_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. Une valeur de 0 doit être spécifiée pour les serveurs de publication non-SQL Server.

  • 0 spécifie l’authentification SQL Server
  • 1spécifie Authentification Windows

Lorsque c'est possible, utilisez l'authentification Windows.

[ @publisher_login = ] N’publisher_login'

Connexion utilisée lors de la connexion au serveur de publication. @publisher_login est sysname, sans valeur par défaut. @publisher_login doit ê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 est utilisé lors de la connexion au serveur de publication.

[ @publisher_password = ] N’publisher_password'

Mot de passe utilisé lors de la connexion au serveur de publication. @publisher_password est nvarchar(524), sans valeur par défaut.

Important

Ne stockez pas les informations d’authentification dans les 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 = ] N’job_login'

Connexion pour le 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é. Cette propriété ne peut pas être modifiée pour un serveur de publication non-SQL Server.

[ @job_password = ] N’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é.

Important

Ne stockez pas les informations d’authentification dans les 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.

[ @publisher_type = ] N’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.

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 Vue d’ensemble de la publication Oracle.

Valeurs des codes de retour

0 (réussite) or 1 (échec).

Notes

sp_MSchange_snapshot_agent_properties est utilisé dans la réplication d’instantanés, la réplication transactionnelle et la réplication de fusion.

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

Vous pouvez utiliser sp_changepublication_snapshot sur le serveur de publication 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 s’exécuter sp_MSchange_snapshot_agent_properties.

Contenu connexe