sp_changepublication (Transact-SQL)

S’applique à :SQL ServerAzure SQL Managed Instance

Modifie les propriétés d'une publication. 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_changepublication [ [ @publication = ] 'publication' ]  
    [ , [ @property = ] 'property' ]  
    [ , [ @value = ] 'value' ]  
    [ , [ @force_invalidate_snapshot = ] force_invalidate_snapshot ]  
    [ , [ @force_reinit_subscription = ] force_reinit_subscription ]  
    [ , [ @publisher = ] 'publisher' ]

Arguments

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

[ @property = ] 'property' Propriété de publication à modifier. estnvarchar(255).

[ @value = ] 'value' Valeur de la nouvelle propriété. la valeur est nvarchar(255), avec la valeur NULL par défaut.

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

[ @force_invalidate_snapshot = ] force_invalidate_snapshotReconnaît que l’action effectuée par cette procédure stockée peut invalider une instantané existante. force_invalidate_instantané est un peu, avec une valeur par défaut de 0.

• 0 spécifie que les modifications apportées à l’article n’entraînent pas l’instantané non valide. 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 les modifications apportées à l’article peuvent entraîner l’instantané non valide. Si certains abonnements existants nécessitent un nouvel instantané, cette valeur autorise le marquage de l'instantané existant comme obsolète, et la génération d'un nouvel instantané.
  Consultez la section Remarques pour connaître les propriétés dont la modification nécessite la génération d'un nouvel instantané.

[@force_reinit_subscription = ] force_reinit_subscription
Reconnaît que l’action effectuée par cette procédure stockée peut nécessiter la réinitialisation des abonnements existants. force_reinit_subscription est un peu avec une valeur par défaut de 0.

• 0 spécifie que les modifications apportées à l’article n’entraînent pas la réinitialisation de l’abonnement. 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 effectuée.
• 1 spécifie que les modifications apportées à l’article entraînent la réinitialisation de l’abonnement existant et donnent l’autorisation de réinitialiser l’abonnement.

[ @publisher = ] 'publisher' Spécifie un serveur de publication non-SQL Server. publisher est sysname, avec une valeur par défaut null.

Codet de retour

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

Notes

sp_changepublication est utilisé dans la réplication instantané et la réplication transactionnelle.

Après avoir modifié l’une des propriétés suivantes, vous devez générer une nouvelle instantané, et vous devez spécifier la valeur 1 pour le paramètre force_invalidate_instantané.

• alt_snapshot_folder
• compress_snapshot
• enabled_for_het_sub
• ftp_address
• ftp_login
• ftp_password
• ftp_port
• ftp_subdirectory
• post_snapshot_script
• pre_snapshot_script
• snapshot_in_defaultfolder
• sync_mode

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

Impact de la synchronisation immédiate

Lorsque la synchronisation immédiate est activée, toutes les modifications dans le journal sont suivies immédiatement après la génération de la instantané initiale, même s’il n’existe aucun abonnement. Les modifications journalisées sont utilisées lorsqu’un client utilise la sauvegarde pour ajouter un nouveau nœud homologue. Une fois la sauvegarde restaurée, l’homologue est synchronisé avec toutes les autres modifications qui se produisent après la sauvegarde. Étant donné que les commandes sont suivies dans la base de données de distribution, la logique de synchronisation peut examiner le dernier LSN sauvegardé et l’utiliser comme point de départ, sachant que la commande est disponible si la sauvegarde a été effectuée au cours de la période de rétention maximale. (La valeur par défaut de la période de rétention minimale est de 0 heures et la période de rétention maximale est de 24 heures.)

Lorsque la synchronisation immédiate est désactivée, les modifications sont conservées au moins la période de rétention minimale et propre immédiatement pour toutes les transactions déjà répliquées. Si la synchronisation immédiate est désactivée et configurée avec la période de rétention par défaut, il est probable que les modifications nécessaires après la sauvegarde aient été nettoyées et que le nouveau nœud homologue ne soit pas correctement initialisé. La seule option conssite à suspendre la topologie. L'activation de la synchronisation immédiate offre davantage de flexibilité et est le paramètre recommandé pour la réplication P2P.

Exemple

DECLARE @publication AS sysname
SET @publication = N'AdvWorksProductTran' 

-- Turn off DDL replication for the transactional publication.
USE [AdventureWorks2022]
EXEC sp_changepublication 
  @publication = @publication, 
  @property = N'replicate_ddl', 
  @value = 0
GO

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.

Voir aussi

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