sp_changepublication (Transact-SQL)

S’applique à : SQL Server Azure 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 = ] N'publication' ]
    [ , [ @property = ] N'property' ]
    [ , [ @value = ] N'value' ]
    [ , [ @force_invalidate_snapshot = ] force_invalidate_snapshot ]
    [ , [ @force_reinit_subscription = ] force_reinit_subscription ]
    [ , [ @publisher = ] N'publisher' ]
[ ; ]

Arguments

[ @publication = ] N’publication'

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

[ @property = ] N’property'

Propriété de publication à modifier. @property est nvarchar(255), avec la valeur par défaut NULL.

[ @value = ] N’value'

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

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_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 les modifications apportées à l’article n’entraînent pas l’invalidation de 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 les modifications apportées à l’article peuvent entraîner l’échec de l’instantané. 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 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 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 autorise la réinitialisation de l’abonnement.

[ @publisher = ] N’publisher'

Spécifie un serveur de publication non-SQL Server. @publisher est sysname, avec la valeur par défaut NULL.

@publisher ne doit pas être utilisé lors de la modification des propriétés d’article sur un serveur de publication SQL Server.

Valeurs des codes de retour

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

Notes

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

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

• 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 publish_to_active_directory paramètre, l’objet SQL Server doit déjà être créé dans Active Directory.

Effet 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 l’instantané initial, 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 nettoyées 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 requises après la sauvegarde aient été nettoyées et que le nouveau nœud homologue ne sera pas initialisé correctement. 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.

Exemples

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 s’exécuter sp_changepublication.

Contenu connexe

• 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)