sp_changepublication (Transact-SQL)

Mis à jour : 12 décembre 2006

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

Conventions de la syntaxe de 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 publication. L'argument publication est de type sysname, avec la valeur NULL par défaut.

• [ @property=] 'property'
  Propriété de publication à modifier. property est de type nvarchar(255).

• [ @value=] 'value'
  Nouvelle valeur de la propriété. value est de type nvarchar(255). Sa valeur par défaut est 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.

  Propriété

• [ @force_invalidate_snapshot = ] force_invalidate_snapshot
  Accepte que l'action exécutée par la procédure stockée puisse invalider une capture instantanée existante. force_invalidate_snapshot est de type bit, avec la valeur par défaut 0.

  0 indique que les modifications apportées à l'article ne doivent pas invalider la capture instantanée. Si la procédure stockée détecte que la modification requiert une nouvelle capture instantanée, une erreur est générée et aucune modification n'est effectuée.

  1 indique que les modifications apportées à l'article peuvent invalider la capture instantanée. Si certains abonnements existants nécessitent une nouvelle capture instantanée, cette valeur autorise le marquage de la capture instantanée existante comme obsolète, et la génération d'une nouvelle capture instantanée.

  Consultez la section Remarques pour connaître les propriétés dont la modification nécessite la génération d'une nouvelle capture instantanée.

• [@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. L'argument force_reinit_subscription est de type bit, avec 0 comme valeur par défaut.

  0 indique que les modifications apportées à l'article ne doivent pas provoquer la réinitialisation de l'abonnement. Si la procédure stockée détecte que la modification requiert la réinitialisation des abonnements existants, une erreur est générée et aucune modification n'est effectuée.

  1 indique que les modifications apportées à l'article entraînent la réinitialisation d'abonnements existants, et autorise la réinitialisation de ces abonnements.

• [ @publisher = ] 'publisher'
  Spécifie un serveur de publication non-SQL Server. publisher est de type sysname. Sa valeur par défaut est NULL.

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

Notes

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

Le changement de l'une quelconque des propriétés ci-dessous nécessite la génération d'une nouvelle capture instantanée, et vous devez spécifier une valeur de 1 pour 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

Les objets de publication figurant dans l'annuaire Active Directory ne peuvent être affichés à l'aide du paramètre @publish_to_Active_Directory que si l'objet SQL Server est déjà créé dans l'annuaire.

Autorisations

Seuls les membres du rôle de serveur fixe sysadmin ou du rôle de base de données fixe db_owner peuvent exécuter sp_changepublication.

Valeurs des codes renvoyés

0 (succès) ou 1 (échec)

Exemple

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

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

Voir aussi

Référence

sp_addpublication (Transact-SQL)
sp_droppublication (Transact-SQL)
sp_helppublication (Transact-SQL)
Procédures stockées de réplication (Transact-SQL)

Autres ressources

How to: View and Modify Publication Properties (Replication Transact-SQL Programming)
Modification des propriétés des publications et des articles

Aide et Informations

Assistance sur SQL Server 2005

Historique des modifications