sp_changemergearticle (Transact-SQL)

S'applique à : SQL Server

Modifie les propriétés d'un article 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_changemergearticle
    [ @publication = ] N'publication'
    , [ @article = ] N'article'
    [ , [ @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 dans laquelle l’article existe. @publication est sysname, sans valeur par défaut.

[ @article = ] N’article'

Nom de l’article à modifier. @article est sysname, sans valeur par défaut.

[ @property = ] N’property'

Propriété à modifier pour l’article et la publication donnés. @property est sysname et peut être l’une des valeurs répertoriées dans le tableau suivant.

[ @value = ] N’value'

Nouvelle valeur de la propriété spécifiée. @value est nvarchar(2000) et peut être l’une des valeurs répertoriées dans le tableau suivant.

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_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 de fusion 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 signifie que les modifications apportées à l’article de fusion peuvent entraîner l’échec de l’instantané et, s’il existe des abonnements existants qui nécessitent un nouvel instantané, donne l’autorisation de marquer l’instantané existant comme obsolète et un nouvel instantané 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 les modifications apportées à l’article de fusion 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 signifie que les modifications apportées à l’article de fusion entraînent la réinitialisation des 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) or 1 (échec).

Notes

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

Étant donné qu’il sp_changemergearticle est utilisé pour modifier les propriétés d’article qui ont été initialement spécifiées à l’aide de sp_addmergearticle, reportez-vous à sp_addmergearticle pour plus d’informations sur ces propriétés.

La modification des propriétés suivantes nécessite qu’un nouvel instantané soit généré et que vous devez spécifier une valeur pour 1 le paramètre @force_invalidate_snapshot :

• check_permissions
• column_tracking
• destination_owner
• pre_creation_command
• schema_options
• subset_filterclause

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

• check_permissions
• column_tracking
• destination_owner
• pre_creation_command
• identityrangemanagementoption
• subscriber_upload_options
• subset_filterclause
• creation_script
• schema_option
• logical_record_level_conflict_detection
• logical_record_level_conflict_resolution

Lorsque vous spécifiez une valeur pour 3 partition_options, les métadonnées sont nettoyées chaque fois que le Agent de fusion s’exécute et que l’instantané partitionné expire plus rapidement. Lorsque vous utilisez cette option, pensez à activer l'instantané partitionné requis par l'abonné. Pour plus d'informations, voir Créer un instantané d’une publication de fusion avec des filtres paramétrés.

Lorsque vous définissez la column_tracking propriété, si la table est déjà publiée dans d’autres publications de fusion, le suivi des colonnes doit être identique à la valeur utilisée par les articles existants en fonction de cette table. Ce paramètre concerne uniquement les articles de table.

Si plusieurs publications publient des articles basés sur la même table sous-jacente, la modification de la delete_tracking propriété ou de la compensate_for_errors propriété d’un article entraîne la même modification apportée aux autres articles basés sur la même table.

Si le compte de connexion/d’utilisateur du serveur de publication utilisé par le processus de fusion ne dispose pas des autorisations de table appropriées, les modifications non valides sont enregistrées en tant que conflits.

Lorsque vous modifiez la valeur de schema_option, le système n’effectue pas de mise à jour au niveau du bit. Cela signifie que lorsque vous définissez schema_option l’utilisation sp_changemergearticle, les paramètres de bits existants peuvent être désactivés. Pour conserver les paramètres existants, vous devez effectuer & (Bitwise AND) entre la valeur que vous définissez et la valeur actuelle de schema_option, qui peut être déterminée en exécutant sp_helpmergearticle.

Table d’options de schéma valide

Le tableau suivant décrit les valeurs autorisées schema_option , en fonction du type d’article.

Exemples

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

-- Enable column-level conflict tracking.
-- Changing this property requires that existing subscriptions
-- be reinitialized and that a new snapshot be generated.
USE [AdventureWorks2022]
EXEC sp_changemergearticle 
  @publication = @publication,
  @article = @article, 
  @property = N'column_tracking', 
  @value = N'true',
  @force_invalidate_snapshot = 1,
  @force_reinit_subscription = 1;
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_changemergearticle.

Contenu connexe

• Afficher et modifier les propriétés d’un article
• Changer les propriétés des publications et des articles
• sp_addmergearticle (Transact-SQL)
• sp_dropmergearticle (Transact-SQL)
• sp_helpmergearticle (Transact-SQL)
• Procédures stockées de réplication (Transact-SQL)