sp_changemergepublication (Transact-SQL)

S'applique à : SQL Server

Modifie les propriétés d'une publication de fusion. Cette procédure stockée est exécutée sur le serveur de publication dans la base de données de publication.

Conventions de la syntaxe Transact-SQL

Syntaxe

sp_changemergepublication
    [ @publication = ] N'publication'
    [ , [ @property = ] N'property' ]
    [ , [ @value = ] N'value' ]
    [ , [ @force_invalidate_snapshot = ] force_invalidate_snapshot ]
    [ , [ @force_reinit_subscription = ] force_reinit_subscription ]
[ ; ]

Arguments

[ @publication = ] N’publication'

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

[ @property = ] N’property'

Propriété à modifier pour la publication donnée. @property est sysname et peut être l’une des valeurs répertoriées dans la table qui suit.

[ @value = ] N’value'

Nouvelle valeur de la propriété spécifiée. @value est nvarchar(255), avec la valeur par défaut NULL.

, et peut être l’une des valeurs répertoriées dans la table qui suit.

Le tableau ci-dessous décrit les propriétés modifiables de la publication ainsi que les limites liées aux valeurs de ces propriétés.

[ @force_invalidate_snapshot = ] force_invalidate_snapshot

Reconnaît que l’action effectuée par cette procédure stockée peut invalider un instantané existant. @force_invalidate_snapshot est bit, avec la valeur par défaut 0.

• 0 spécifie que la modification de la publication n’invalide pas l’instantané. Si la procédure stockée détecte que la modification requiert un nouvel instantané, une erreur se produit et aucune modification n'est effectuée.

• 1 spécifie que la modification de la publication peut invalider l’instantané. S’il existe des abonnements existants qui nécessitent un nouvel instantané, donne l’autorisation à l’instantané existant d’être marqué comme obsolète et pour qu’un nouvel instantané soit généré.

Consultez la section Remarques pour les propriétés qui, en cas de modification, nécessitent la génération d’un nouvel instantané.

[ @force_reinit_subscription = ] force_reinit_subscription

Confirme que l'action entreprise par cette procédure stockée peut nécessiter la réinitialisation des abonnements existants. @force_reinit_subscription est bit, avec la valeur par défaut 0.

• 0 spécifie que la modification de la publication ne nécessite pas que les abonnements soient réinitialisés. Si la procédure stockée détecte que la modification nécessite la réinitialisation des abonnements existants, une erreur se produit et aucune modification n’est apportée.

• 1 signifie que les modifications apportées à la publication réinitialisent les abonnements existants et autorisent la réinitialisation de l’abonnement.

Consultez la section Remarques pour les propriétés qui, en cas de modification, nécessitent que tous les abonnements existants soient réinitialisés.

Valeurs des codes de retour

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

Notes

sp_changemergepublication est utilisé dans la réplication de fusion.

La modification des propriétés suivantes nécessite qu’un nouvel instantané soit généré. Vous devez spécifier la valeur du 1 paramètre @force_invalidate_snapshot .

• alt_snapshot_folder
• compress_snapshot
• dynamic_filters
• ftp_address
• ftp_login
• ftp_password
• ftp_port
• ftp_subdirectory
• post_snapshot_script
• publication_compatibility_level (à 80SP3 seulement)
• pre_snapshot_script
• snapshot_in_defaultfolder
• sync_mode
• use_partition_groups

Vous devez réinitialiser les abonnements existants pour modifier les propriétés suivantes. Vous devez spécifier la valeur du 1 paramètre @force_reinit_subscription .

• dynamic_filters
• validate_subscriber_info

Pour répertorier les objets de publication dans Active Directory à l’aide publish_to_active_directoryde , l’objet SQL Server doit déjà être créé dans Active Directory.

Exemples

DECLARE @publication AS sysname;
SET @publication = N'AdvWorksSalesOrdersMerge'; 

-- Disable DDL replication for the publication.
USE [AdventureWorks2022]
EXEC sp_changemergepublication 
  @publication = @publication, 
  @property = N'replicate_ddl', 
  @value = 0,
  @force_invalidate_snapshot = 0, 
  @force_reinit_subscription = 0;
GO

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_changemergepublication.

Contenu connexe

• Afficher et modifier les propriétés d’une publication
• Changer les propriétés des publications et des articles
• sp_addmergepublication (Transact-SQL)
• sp_dropmergepublication (Transact-SQL)
• sp_helpmergepublication (Transact-SQL)
• Procédures stockées de réplication (Transact-SQL)