sp_changepublication_snapshot (Transact-SQL)
S’applique à : SQL Server Azure SQL Managed Instance
Modifie les propriétés de l'Agent d'instantané pour la publication spécifiée. Cette procédure stockée est exécutée sur le serveur de publication dans la base de données de publication.
Important
Lors de la configuration d'un serveur de publication avec un serveur de distribution distant, les valeurs fournies pour tous les paramètres, y compris job_login et job_password, sont envoyées en texte brut au serveur de distribution. Vous devez chiffrer la connexion entre le serveur de publication et son serveur de distribution distant avant d'exécuter cette procédure stockée. Pour plus d’informations, consultez Activer des connexions chiffrées dans le moteur de base de données (Gestionnaire de configuration SQL Server).
Conventions de la syntaxe Transact-SQL
Syntaxe
sp_changepublication_snapshot [ @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 = ] 'publisher' ]
Arguments
[ @publication = ] 'publication'
Nom de la composition. la publication est sysname, sans valeur par défaut.
[ @frequency_type = ] frequency_type
Fréquence à laquelle planifier l’agent. frequency_type est int et peut être l’une des valeurs suivantes.
Valeur | Description |
---|---|
1 | Ponctuelle |
2 | À la demande |
4 | Journalier |
8 | Hebdomadaire |
16 | Mensuelle |
32 | Mensuelle relative |
64 | Démarrage automatique |
128 | Récurrent |
NULL (par défaut) |
[ @frequency_interval = ] frequency_interval
Spécifie les jours pendant lesquels l’agent s’exécute. frequency_interval est int et peut être l’une des valeurs suivantes.
Valeur | Description |
---|---|
1 | Dimanche |
2 | Lundi |
3 | Mardi |
4 | Mercredi |
5 | Jeudi |
6 | Vendredi |
7 | Samedi |
8 | Jour |
9 | Jours de la semaine |
10 | Jours de week-end |
NULL (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.
Valeur | Description |
---|---|
1 | Une fois |
2 | Second |
4 | Minute |
8 | Heure |
NULL (par défaut) |
[ @frequency_subday_interval = ] frequency_subday_interval
Intervalle de frequency_subday. frequency_subday_interval est int, avec une valeur par défaut null.
[ @frequency_relative_interval = ] frequency_relative_interval
Date à laquelle l’Agent d’instantané s’exécute. frequency_relative_interval est int, avec la valeur null par défaut.
[ @frequency_recurrence_factor = ] frequency_recurrence_factor
Facteur de périodicité utilisé par frequency_type. frequency_recurrence_factor est int, avec une valeur par défaut null.
[ @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, avec la valeur null par défaut.
[ @active_end_date = ] active_end_date
Date à laquelle l’Agent d’instantané cesse d’être planifié, mis en forme comme yyyyMMdd
suit : active_end_date est int, avec une valeur par défaut null.
[ @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, avec la valeur null 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, avec une valeur par défaut null.
[ @snapshot_job_name = ] 'snapshot_agent_name'
Nom d’un travail de l’Agent d’instantané existant si un travail existant est utilisé. snapshot_agent_name est nvarchar(100) avec une valeur par défaut null.
[ @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 smallint, avec une valeur par défaut null. 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.
Important
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, avec la valeur null par défaut. publisher_login devez être spécifié lorsque publisher_security_mode est 0. Si publisher_login a la valeur 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 = ] 'publisher_password'
Mot de passe utilisé lors de la connexion au serveur de publication. publisher_password est sysname, avec la valeur null par défaut.
Important
N'utilisez pas de mot de passe vide. Utilisez un mot de passe fort. Lorsque c'est possible, demande aux utilisateurs de fournir les informations d'identification au moment de l'exécution. Si vous devez enregistrer les informations d'identification dans un fichier de script, vous devez sécuriser le fichier pour empêcher un accès non autorisé.
[ @job_login = ] 'job_login'
Connexion du compte Windows sous lequel l’agent s’exécute. job_login est nvarchar(257), avec une valeur par défaut null. 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, avec la valeur null par défaut. Vous devez fournir ce paramètre lorsque vous créez un nouveau travail d'Agent d'instantané.
Important
Lorsque c'est possible, demande aux utilisateurs de fournir les informations d'identification au moment de l'exécution. Si vous devez enregistrer les informations d'identification dans un fichier de script, vous devez sécuriser le fichier pour empêcher un accès non autorisé.
[ @publisher = ] 'publisher'
Spécifie un serveur de publication non-SQL Server. publisher est sysname, avec une valeur par défaut null.
Remarque
l’éditeur ne doit pas être utilisé lors de la création d’un agent d’instantané sur un serveur de publication SQL Server.
Codet de retour
0 (réussite) ou 1 (échec)
Notes
sp_changepublication_snapshot est utilisé dans la réplication d’instantanés, la réplication transactionnelle et la réplication de fusion.
autorisations
Seuls les membres du rôle serveur fixe sysadmin ou db_owner rôle de base de données fixe peuvent exécuter sp_changepublication_snapshot.
Voir aussi
Afficher et modifier les propriétés d’une publication
Changer les propriétés des publications et des articles
sp_addpublication_snapshot (Transact-SQL)
Procédures stockées système (Transact-SQL)
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour