sp_changearticle (Transact-SQL)

S’applique à :SQL ServerAzure SQL Managed Instance

Modifie les propriétés d'un article dans une publication transactionnelle ou d'instantané. 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_changearticle [ [@publication= ] 'publication' ]  
    [ , [ @article= ] 'article' ]  
    [ , [ @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 qui contient l’article. la publication est sysname, avec une valeur par défaut null.

[ @article = ] 'article' Nom de l’article dont la propriété doit être modifiée. l’article est sysname, avec une valeur par défaut null.

[ @property = ] 'property' Propriété d’article à modifier. estnvarchar(100).

[ @value = ] 'value' Nouvelle valeur de la propriété d’article. la valeur est nvarchar(255).

Le tableau ci-dessous décrit les propriétés des articles et les 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 rendre les instantané non valides et, s’il existe des abonnements existants qui nécessitent un nouveau instantané, donne l’autorisation à l’instantané existante d’être marquée comme obsolète et qu’une nouvelle instantané générée.

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 des abonnements existants et autorisent la réinitialisation de l’abonnement.

Voir la section Remarques pour connaître les propriétés dont la modification requiert la réinitialisation de tous les abonnements existants.

[ @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_changearticle est utilisé dans la réplication instantané et la réplication transactionnelle.

Lorsqu’un article appartient à une publication qui prend en charge la réplication transactionnelle d’égal à égal, vous pouvez uniquement modifier la description, ins_cmd, upd_cmd et les propriétés de del_cmd .

La modification de l’une des propriétés suivantes nécessite qu’une nouvelle instantané soit générée et que vous devez spécifier la valeur 1 pour le paramètre force_invalidate_instantané :

• del_cmd

• dest_table

• destination_owner

• ins_cmd

• pre_creation_cmd

• schema_options

• upd_cmd

La modification de l’une des propriétés suivantes nécessite que les abonnements existants soient réinitialisés et que vous devez spécifier la valeur 1 pour le paramètre force_reinit_subscription.

• del_cmd

• dest_table

• destination_owner

• filter

• ins_cmd

• statut

• upd_cmd

Dans une composition existante, vous pouvez utiliser sp_changearticle pour modifier un article sans avoir à supprimer et recréer la composition entière.

Options de schéma valides

Le tableau suivant décrit les valeurs autorisées d’schema_option en fonction du type de réplication (affiché en haut) et du type d’article (indiqué dans la première colonne).

Exemple

DECLARE @publication AS sysname;
DECLARE @article AS sysname;
DECLARE @option AS int;
SET @publication = N'AdvWorksProductTran';
SET @article = N'Product';
SET @option = (SELECT CAST(0x0000000002030073 AS int));

-- Change the schema options to replicate schema with XML.
USE [AdventureWorks2022]
EXEC sp_changearticle 
  @publication = @publication,
  @article = @article, 
  @property = N'schema_option', 
  @value = @option,
  @force_invalidate_snapshot = 1;
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_changearticle.

Voir aussi

Afficher et modifier les propriétés d’un article
Changer les propriétés des publications et des articles
sp_addarticle (Transact-SQL)
sp_articlecolumn (Transact-SQL)
sp_droparticle (Transact-SQL)
sp_helparticle (Transact-SQL)
sp_helparticlecolumns (Transact-SQL)