Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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
Lorsque vous configurez un serveur de publication avec un serveur de distribution distant, les valeurs fournies pour tous les paramètres, notamment @job_login et @job_password, sont envoyées au serveur de distribution sous forme de texte brut. 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 Configurer le moteur de base de données SQL Server pour le chiffrement des connexions.
Transact-SQL Conventions syntaxiques
Syntaxe
sys.sp_changepublication_snapshot
[ @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 = ] N'publisher' ]
[ , [ @job_security_mode = ] job_security_mode ]
[ ; ]
Arguments
[ @publication = ] N’publication'
Nom de la publication. @publication est sysname, sans défaut.
[ @frequency_type = ] frequency_type
Spécifie la fréquence avec laquelle planifier l’agent. @frequency_type est int, et peut être l’une des valeurs suivantes.
| Valeur | Description |
|---|---|
1 |
Ponctuelle |
2 |
À la demande |
4 |
Quotidiennement |
8 |
Hebdomadaire |
16 |
Mensuelle |
32 |
Mensuelle relative |
64 |
Démarrage automatique |
128 |
Récurrent |
NULL (valeur par défaut) |
[ @frequency_interval = ] frequency_interval
Spécifie les jours d'exécution de l'Agent. @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 |
Day |
9 |
Jours de la semaine |
10 |
Jours de week-end |
NULL (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.
| Valeur | Description |
|---|---|
1 |
Une fois |
2 |
Second |
4 |
Minute |
8 |
Heure |
NULL (valeur par défaut) |
[ @frequency_subday_interval = ] frequency_subday_interval
Intervalle de @frequency_subday.
@frequency_subday_interval est int, avec pour 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 pour défaut de NULL.
[ @frequency_recurrence_factor = ] frequency_recurrence_factor
Facteur de périodicité utilisé par @frequency_type.
@frequency_recurrence_factor est int, avec pour 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 en tant que yyyyMMdd.
@active_start_date est int, avec pour valeur par défaut .NULL
[ @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, avec un défaut de 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 HHmmsssuit :
@active_start_time_of_day est int, avec un défaut de NULL.
[ @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 pour défaut de NULL.
[ @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), avec pour 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 int, avec un défaut de NULL. Une valeur de 0 doit être spécifiée pour les serveurs de publication non-SQL Server.
-
0spécifie l’authentification SQL Server -
1spécifie l’authentification Windows -
5spécifie l’authentification d’identité gérée Microsoft Entra en utilisant l’identité gérée par défaut du Distributeur. Applicable uniquement lorsque Distributor et Publisher sont tous deux des ressources Azure SQL Managed Instance.
Important
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, avec pour valeur par défaut NULL.
@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. Non utilisé si @publisher_security_mode est 5.
[ @publisher_password = ] N’publisher_password'
Mot de passe utilisé lors de la connexion au serveur de publication.
@publisher_password est sysname, avec pour valeur par défaut .NULL Non utilisé si @publisher_security_mode est 5.
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 = ] N’job_login'
Connexion pour le compte Windows sous lequel l’agent s’exécute.
@job_login est nvarchar(257), avec un défaut de 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 éditeur non-SQL Server. Non utilisé si @job_security_mode est 5.
[ @job_password = ] N’job_password'
Mot de passe du compte Windows sous lequel l’agent s’exécute.
@job_password est sysname, avec pour valeur par défaut .NULL Vous devez fournir ce paramètre lorsque vous créez un nouveau travail d'Agent d'instantané. Non utilisé si @job_security_mode est 5.
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 = ] N’publisher'
Spécifie un serveur de publication non-SQL Server.
@publisher est un nom sys, avec pour valeur par défaut .NULL
Remarque
@publisher ne doit pas être utilisé lors de la création d'un Agent d'instantané à un SQL Server Publisher.
[ @job_security_mode = ] job_security_mode
-
0spécifie l’authentification SQL Server de l’agent auprès du distributeur. -
1spécifie l’Authentification Windows de l’agent au Distributeur. -
5spécifie l’authentification de l’identité gérée Microsoft Entra de l’agent au Distributeur en utilisant l’identité gérée par défaut du Distributeur. Cette valeur est applicable uniquement en réplication transactionnelle lorsque le Distributeur et le Publisher sont tous deux des ressources Azure SQL Managed Instance.
Valeurs des codes de retour
0 (succès) ou 1 (échec).
Notes
sp_changepublication_snapshot est utilisé dans la réplication par snapshot, la réplication transactionnelle et la réplication par fusion.
autorisations
Seuls les membres du rôle serveur fixe sysadmin ou db_owner rôle de base de données fixe peuvent s’exécuter sp_changepublication_snapshot.