sp_changemergearticle (Transact-SQL)sp_changemergearticle (Transact-SQL)

CETTE RUBRIQUE S’APPLIQUE À :ouiSQL Server (à partir de la version 2008)nonAzure SQL DatabasenonAzure SQL Data Warehouse nonParallel Data Warehouse THIS TOPIC APPLIES TO:yesSQL Server (starting with 2008)noAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse

Modifie les propriétés d'un article de fusion.Changes the properties of a merge article. Cette procédure stockée est exécutée sur le serveur de publication dans la base de données de publication.This stored procedure is executed at the Publisher on the publication database.

Icône de lien de rubrique Conventions de la syntaxe Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SyntaxeSyntax


sp_changemergearticle [ @publication = ] 'publication'  
        , [ @article = ] 'article'  
    [ , [ @property = ] 'property' ]  
    [ , [ @value = ] 'value' ]  
    [ , [ @force_invalidate_snapshot = ] force_invalidate_snapshot ]  
    [ , [ @force_reinit_subscription = ] force_reinit_subscription ]  

ArgumentsArguments

[ @publication=] 'publication'[ @publication=] 'publication'
Nom de la publication dans laquelle existe l'article.Is the name of the publication in which the article exists. publication est sysname, sans valeur par défaut.publication is sysname, with no default.

[ @article=] 'article'[ @article=] 'article'
Nom de l'article à modifier.Is the name of the article to change. article est sysname, sans valeur par défaut.article is sysname, with no default.

[ @property=] 'propriété'[ @property=] 'property'
Propriété à modifier pour l'article et la publication donnés.Is the property to change for the given article and publication. propriété est nvarchar (30), et peut prendre l’une des valeurs répertoriées dans le tableau.property is nvarchar(30), and can be one of the values listed in the table.

[ @value=] 'valeur'[ @value=] 'value'
Est la nouvelle valeur pour la propriété spécifiée.Is the new value for the specified property. valeur est nvarchar (1000), et peut prendre l’une des valeurs répertoriées dans le tableau.value is nvarchar(1000), and can be one of the values listed in the table.

Le tableau ci-dessous décrit les propriétés des articles et les valeurs de ces propriétés.This table describes the properties of articles and the values for those properties.

PropriétéProperty ValeursValues DescriptionDescription
allow_interactive_resolverallow_interactive_resolver truetrue Permet d'utiliser un outil de résolution interactif pour l'article.Enables the use of an interactive resolver for the article.
falsefalse Désactive l'utilisation d'un outil de résolution interactif pour l'article.Disables the use of an interactive resolver for the article.
article_resolverarticle_resolver Outil de résolution personnalisé pour l'articleCustom resolver for the article. S’applique uniquement à un article de table.Applies only to a table article.
check_permissions (bitmap)check_permissions (bitmap) 0 x 000x00 Les autorisations au niveau de la table ne sont pas vérifiées.Table-level permissions are not checked.
0 x 100x10 Les autorisations au niveau de la table sont vérifiées dans le serveur de publication avant que les instructions INSERT effectuées sur l'Abonné ne soient appliquées dans le serveur de publication.Table-level permissions are checked at the Publisher before INSERT statements made at the Subscriber are applied at the Publisher.
0 x 200x20 Les autorisations au niveau de la table sont vérifiées dans le serveur de publication avant que les instructions UPDATE effectuées sur l'Abonné ne soient appliquées dans le serveur de publication.Table-level permissions are checked at the Publisher before UPDATE statements made at the Subscriber are applied at the Publisher.
0 x 400x40 Les autorisations au niveau de la table sont vérifiées sur le serveur de publication avant que les instructions DELETE effectuées sur l'Abonné ne soient appliquées dans le serveur de publication.Table-level permissions are checked at the Publisher before DELETE statements at the Subscriber are applied at the Publisher.
column_trackingcolumn_tracking truetrue Active le suivi au niveau de la colonne.Turns on column level tracking. S’applique uniquement à un article de table.Applies only to a table article.

Remarque : Suivi au niveau colonne ne peut pas être utilisé lors de la publication des tables avec plus de 246 colonnes.Note: Column level tracking cannot be used when publishing tables with more than 246 columns.
falsefalse Désactive le suivi au niveau de la colonne et conserve la détection des conflits au niveau de la ligne.Turns off column level tracking and leaves conflict detection at the row level. S’applique uniquement à un article de table.Applies only to a table article.
compensate_for_errorscompensate_for_errors truetrue Des actions de compensation sont effectuées lorsque des erreurs se produisent au cours de la synchronisation.Compensating actions are performed when errors occur during synchronization. Pour plus d’informations, consultez sp_addmergearticle.For more information, see sp_addmergearticle.
falsefalse Les actions de compensation ne sont pas effectuées, ce qui est le comportement par défaut.Compensating actions are not performed, which is the default behavior. Pour plus d’informations, consultez sp_addmergearticle.For more information, see sp_addmergearticle.

** Important * \* bien que les données des lignes affectées peuvent sembler être hors de convergence, dès que vous résolvez les éventuelles erreurs, modifications peuvent être appliquées et les données convergent.** Important *\* Although data in the affected rows might appear to be out of convergence, as soon as you address any errors, changes can be applied and data will converge. Si la table source pour un article est déjà publiée dans une autre publication, la valeur de compensate_for_errors doivent être identiques pour les deux articles.If the source table for an article is already published in another publication, then the value of compensate_for_errors must be the same for both articles.
creation_scriptcreation_script Chemin d'accès et nom d'un script de schéma d'article facultatif utilisé pour créer l'article dans la base de données d'abonnement.Path and name of an optional article schema script used to create the article in the subscription database.
delete_trackingdelete_tracking truetrue Les instructions DELETE sont répliquées, ce qui est le comportement par défaut.DELETE statements are replicated, which is the default behavior.
falsefalse Les instructions DELETE ne sont pas répliquées.DELETE statements are not replicated.

** Important * \* paramètre delete_tracking à false entraîne une non-convergence et supprimés les lignes doivent être supprimées manuellement.** Important *\* Setting delete_tracking to false results in non-convergence, and deleted rows need to be manually removed.
descriptiondescription Entrée descriptive de l'articleDescriptive entry for the article.
destination_ownerdestination_owner Nom du propriétaire de l’objet dans la base de données abonnement, dans le cas contraire dbo.Name of the owner of the object in the subscription database, if not dbo.
identity_rangeidentity_range bigint qui spécifie la taille de la plage à utiliser lors de l’attribution de nouvelles valeurs d’identité si l’article a identityrangemanagementoption la valeur automatique ou auto_identity_ plage la valeur true.bigint that specifies the range size to use when assigning new identity values if the article has identityrangemanagementoption set to auto or auto_identity_range set to true. S'applique à un article de table uniquement.Applies to a table article only. Pour plus d’informations, consultez la section « Réplication de fusion » de répliquer des colonnes d’identité.For more information, see the "Merge Replication" section of Replicate Identity Columns.
identityrangemanagementoptionidentityrangemanagementoption Manuellemanual Désactive la gestion automatique des plages d'identité.Disables automatic identity range management. Marque les colonnes d'identité en utilisant NOT FOR REPLICATION pour permettre la gestion manuelle des plages d'identité.Marks identity columns using NOT FOR REPLICATION to enable manual identity range handling. Pour plus d’informations, consultez Répliquer des colonnes d’identité.For more information, see Replicate Identity Columns.
Aucunnone Désactive toute la gestion des plages d'identité.Disables all identity range management.
logical_record_level_conflict_detectionlogical_record_level_conflict_detection truetrue Un conflit est détecté si des modifications sont apportées à un point quelconque de l'enregistrement logique.A conflict is detected if changes are made anywhere in the logical record. Requiert que logical_record_level_conflict_resolution avoir la valeur true.Requires that logical_record_level_conflict_resolution be set to true.
falsefalse Détection de conflit par défaut est utilisée comme spécifié par column_tracking.Default conflict detection is used as specified by column_tracking.
logical_record_level_conflict_resolutionlogical_record_level_conflict_resolution truetrue L'enregistrement logique gagnant complet remplace l'enregistrement logique perdant.Entire winning logical record overwrites the losing logical record.
falsefalse Les lignes gagnantes ne sont pas limitées à l'enregistrement logique.Winning rows are not constrained to the logical record.
partition_optionspartition_options 00 Le filtrage de l'article est statique ou il ne produit pas un sous-ensemble unique de données pour chaque partition, c'est-à-dire une partition en « chevauchement ».The filtering for the article either is static or does not yield a unique subset of data for each partition, i.e. an "overlapping" partition.
11 Les partitions se chevauchent, et les mises à jour DML effectuées sur l'Abonné ne peuvent pas modifier la partition à laquelle une ligne appartient.The partitions are overlapping, and DML updates made at the Subscriber cannot change the partition to which a row belongs.
22 Le filtrage de l'article produit des partitions qui ne se chevauchent pas, mais plusieurs abonnés peuvent recevoir la même partition.The filtering for the article yields non-overlapping partitions, but multiple Subscribers can receive the same partition.
33 Le filtrage de l'article produit des partitions qui ne se chevauchent pas et qui sont uniques pour chaque abonnement.The filtering for the article yields non-overlapping partitions that are unique for each subscription.

Remarque : Si vous spécifiez une valeur de 3 pour partition_options, il peut y avoir qu’un seul abonnement pour chaque partition de données dans cet article.Note: If you specify a value of 3 for partition_options, there can be only a single subscription for each partition of data in that article. Si un deuxième abonnement est créé dans lequel le critère de filtrage du nouvel abonnement produit la même partition que l'abonnement existant, ce dernier est supprimé.If a second subscription is created in which the filtering criterion of the new subscription resolves to the same partition as the existing subscription, the existing subscription is dropped.
pre_creation_commandpre_creation_command Aucunnone Si la table existe déjà côté abonné, aucune action n'est effectuée.If the table already exists at the Subscriber, no action is taken.
deletedelete Entraîne une suppression basée sur la clause WHERE dans le filtre de sous-ensemble.Issues a delete based on the WHERE clause in the subset filter.
DROPdrop Supprime la table avant de la recréer.Drops the table before re-creating it.
truncatetruncate Tronque la table de destination.Truncates the destination table.
processing_orderprocessing_order int qui indique l’ordre de traitement des articles dans une publication de fusion.int that indicates the processing order of articles in a merge publication.
pub_identity_rangepub_identity_range bigint qui spécifie la taille de plage allouée à un abonné disposant d’un abonnement serveur si l’article a identityrangemanagementoption la valeur automatique ou auto_ identity_range la valeur true.bigint that specifies the range size allocated to a Subscriber with a server subscription if the article has identityrangemanagementoption set to auto or auto_identity_range set to true. Cette plage d'identité est réservée à un Abonné de republication qui peut l'allouer à ses propres Abonnés.This identity range is reserved for a republishing Subscriber to allocate to its own Subscribers. S'applique à un article de table uniquement.Applies to a table article only. Pour plus d’informations, consultez la section « Réplication de fusion » de répliquer des colonnes d’identité.For more information, see the "Merge Replication" section of Replicate Identity Columns.
published_in_tran_pubpublished_in_tran_pub truetrue L'article est également publié dans une publication transactionnelle.Article is also published in a transactional publication.
falsefalse L'article n'est pas également publié dans une publication transactionnelle.Article is not also published in a transactional publication.
resolver_inforesolver_info Permet de définir les informations supplémentaires requises par un outil de résolution personnalisé.Is used to specify additional information required by a custom resolver. Certains outils de résolution MicrosoftMicrosoft nécessitent une colonne en guise d'entrée.Some of the MicrosoftMicrosoft Resolvers require a column provided as input to the resolver. resolver_info est nvarchar (255), avec NULL comme valeur par défaut.resolver_info is nvarchar(255), with a default of NULL. Pour plus d’informations, consultez Programmes de résolution COM Microsoft.For more information, see Microsoft COM-Based Resolvers.
schema_option (bitmap)schema_option (bitmap) Pour plus d’informations, consultez la section Notes plus loin dans cette rubrique.For more information, see the Remarks section later in this topic.
0 x 000x00 Désactive la génération de scripts par l’Agent d’instantané et utilise le script fourni dans creation_script.Disables scripting by the Snapshot Agent and uses the script provided in creation_script.
0 x 010x01 Génère le script de création d'objet (CREATE TABLE, CREATE PROCEDURE, etc.).Generates the object creation script (CREATE TABLE, CREATE PROCEDURE, and so on).
0 x 100x10 Génère un index cluster correspondant.Generates a corresponding clustered index.
0 x 200x20 Convertit les types de données définis par l'utilisateur en types de données de base auprès de l'Abonné.Converts user-defined data types to base data types at the Subscriber. Cette option ne peut pas être utilisée lorsqu’il existe une contrainte CHECK ou DEFAULT sur une colonne de type défini par l’utilisateur (UDT), si une colonne UDT fait partie de la clé primaire, ou si une colonne calculée fait référence à une colonne UDT.This option cannot be used when there is a CHECK or DEFAULT constraint on a user-defined type (UDT) column, if a UDT column is part of the primary key, or if a computed column references a UDT column.
0 x 400x40 Génère les index non-cluster correspondants.Generates corresponding nonclustered indexes.
0 x 800x80 Inclut l'intégrité référentielle déclarée dans les clés primaires.Includes declared referential integrity on the primary keys.
0 x 1000x100 Réplique les déclencheurs utilisateur, si ceux-ci sont définis, sur un article de table.Replicates user triggers on a table article, if defined.
0 x 2000x200 Réplique les contraintes FOREIGN KEY.Replicates FOREIGN KEY constraints. Si la table référencée ne fait pas partie d'une publication, aucune contrainte FOREIGN KEY appliquée à une table publiée n'est répliquée.If the referenced table is not part of a publication, all FOREIGN KEY constraints on a published table are not replicated.
0 x 4000x400 Réplique les contraintes CHECK.Replicates CHECK constraints.
0 x 8000x800 Réplique les valeurs par défaut.Replicates defaults.
0 x 10000x1000 Réplique le classement au niveau des colonnes.Replicates column-level collation.
0 x 20000x2000 Réplique les propriétés étendues associées à l'objet source de l'article publié.Replicates extended properties associated with the published article source object.
0 x 40000x4000 Réplique les clés uniques, si celles-ci sont définies, sur un article de table.Replicates unique keys if defined on a table article.
0 x 80000x8000 Génère des instructions ALTER TABLE lors de la création d'un script de contraintes.Generates ALTER TABLE statements when scripting constraints.
0 x 100000x10000 Réplique les contraintes CHECK en tant que NOT FOR REPLICATION afin que les contraintes ne soient pas appliquées durant la synchronisation.Replicates CHECK constraints as NOT FOR REPLICATION so that the constraints are not enforced during synchronization.
0 x 200000x20000 Réplique les contraintes FOREIGN KEY en tant que NOT FOR REPLICATION afin que les contraintes ne soient pas appliquées durant la synchronisation.Replicates FOREIGN KEY constraints as NOT FOR REPLICATION so that the constraints are not enforced during synchronization.
0 x 400000x40000 Réplique les groupes de fichiers associés à une table ou un index partitionné.Replicates filegroups associated with a partitioned table or index.
0 x 800000x80000 Réplique le schéma de partition d'une table partitionnée.Replicates the partition scheme for a partitioned table.
0 x 1000000x100000 Réplique le schéma de partition d'un index partitionné.Replicates the partition scheme for a partitioned index.
0 x 2000000x200000 Réplique les statistiques d'une table.Replicates table statistics.
0 x 4000000x400000 Réplique des liaisons par défautReplicates default Bindings
0x8000000x800000 Réplique des liaisons de règle.Replicates rule Bindings
0 x 10000000x1000000 Réplique l'index de texte intégral.Replicates the full-text index
0x20000000x2000000 Collections de schémas XML lié à xml colonnes ne sont pas répliquées.XML schema collections bound to xml columns are not replicated.
0x40000000x4000000 Réplique les index sur xml colonnes.Replicates indexes on xml columns.
0 x 80000000x8000000 Crée tout schéma non encore présent chez l'abonné.Create any schemas not already present on the subscriber.
0 x 100000000x10000000 Convertit xml colonnes à ntext sur l’abonné.Converts xml columns to ntext on the Subscriber.
0 x 200000000x20000000 Types de données de l’objet convertit de grande taille (nvarchar (max), varchar (max), et varbinary (max)) qui ont été introduits dans SQL Server 2005SQL Server 2005 aux types de données qui sont prises en charge sur SQL Server 2000 (8.x)SQL Server 2000 (8.x).Converts large object data types (nvarchar(max), varchar(max), and varbinary(max)) that were introduced in SQL Server 2005SQL Server 2005 to data types that are supported on SQL Server 2000 (8.x)SQL Server 2000 (8.x).
0 x 400000000x40000000 Réplique les autorisations.Replicate permissions.
0 x 800000000x80000000 Tente de supprimer les dépendances envers tous les objets qui ne font pas partie de la publication.Attempt to drop dependencies to any objects that are not part of the publication.
0 x 1000000000x100000000 Utilisez cette option pour répliquer l’attribut FILESTREAM s’il est spécifié sur varbinary (max) colonnes.Use this option to replicate the FILESTREAM attribute if it is specified on varbinary(max) columns. Ne spécifiez pas cette option si vous répliquez des tables sur des Abonnés SQL Server 2005SQL Server 2005.Do not specify this option if you are replicating tables to SQL Server 2005SQL Server 2005 Subscribers. Réplication de tables qui possèdent des colonnes FILESTREAM sur SQL Server 2000 (8.x)SQL Server 2000 (8.x) abonnés n'est pas pris en charge, quelle que soit la manière dont cette option de schéma.Replicating tables that have FILESTREAM columns to SQL Server 2000 (8.x)SQL Server 2000 (8.x) Subscribers is not supported, regardless of how this schema option is set. Consultez l’option connexe 0 x 800000000.See related option 0x800000000.
0x2000000000x200000000 Convertit les types de données de date et heure (date, temps, datetimeoffset, et datetime2) qui sont introduits dans SQL Server 2008SQL Server 2008 aux types de données qui sont prises en charge dans les versions antérieures de SQL ServerSQL Server.Converts date and time data types (date, time, datetimeoffset, and datetime2) that are introduced in SQL Server 2008SQL Server 2008 to data types that are supported on earlier versions of SQL ServerSQL Server.
0x4000000000x400000000 Réplique l'option de compression pour les données et les index.Replicates the compression option for data and indexes. Pour plus d'informations, consultez Data Compression.For more information, see Data Compression.
0 x 8000000000x800000000 Définissez cette option pour stocker les données FILESTREAM dans leur propre groupe de fichiers sur l'Abonné.Set this option to store FILESTREAM data on its own filegroup at the Subscriber. Si cette option n'est pas définie, les données FILESTREAM sont stockées dans le groupe de fichiers par défaut.If this option is not set, FILESTREAM data is stored on the default filegroup. La réplication ne crée pas de groupes de fichiers ; par conséquent, si vous définissez cette option, vous devez créer le groupe de fichiers avant d'appliquer l'instantané à l'Abonné.Replication does not create filegroups; therefore, if you set this option, you must create the filegroup before you apply the snapshot at the Subscriber. Pour plus d’informations sur la façon de créer des objets avant d’appliquer l’instantané, consultez exécuter des Scripts avant et après l’instantané est appliqué.For more information about how to create objects before you apply the snapshot, see Execute Scripts Before and After the Snapshot Is Applied.

Consultez l’option connexe 0 x 100000000.See related option 0x100000000.
0x10000000000x1000000000 Convertit les types common language runtime (CLR) définis par l’utilisateur (UDT) varbinary (max) afin que les colonnes de type UDT puissent être répliquées sur les abonnés qui sont en cours d’exécution SQL Server 2005SQL Server 2005.Converts common language runtime (CLR) user-defined types (UDTs) to varbinary(max) so that columns of type UDT can be replicated to Subscribers that are running SQL Server 2005SQL Server 2005.
0 x 20000000000x2000000000 Convertit le hierarchyid type de données à varbinary (max) afin que les colonnes de type hierarchyid peuvent être répliquées sur les abonnés qui sont en cours d’exécution SQL Server 2005SQL Server 2005.Converts the hierarchyid data type to varbinary(max) so that columns of type hierarchyid can be replicated to Subscribers that are running SQL Server 2005SQL Server 2005. Pour plus d’informations sur l’utilisation de hierarchyid colonnes dans les tables répliquées, consultez hierarchyid (Transact-SQL).For more information about how to use hierarchyid columns in replicated tables, see hierarchyid (Transact-SQL).
0x40000000000x4000000000 Réplique tous les index filtrés sur la table.Replicates any filtered indexes on the table. Pour plus d’informations sur les index filtrés, consultez Create Filtered Indexes.For more information about filtered indexes, see Create Filtered Indexes.
0x80000000000x8000000000 Convertit le geography et geometry types de données varbinary (max) afin que les colonnes de ces types peuvent être répliquées sur les abonnés qui sont en cours d’exécution SQL Server 2005SQL Server 2005.Converts the geography and geometry data types to varbinary(max) so that columns of these types can be replicated to Subscribers that are running SQL Server 2005SQL Server 2005.
0x100000000000x10000000000 Réplique les index sur des colonnes de type geography et geometry.Replicates indexes on columns of type geography and geometry.
NULLNULL Le système génère automatiquement une option de schéma valide pour l'article.System auto-generates a valid schema option for the article.
statusstatus Activeactive Exécution du script de traitement initial pour publier la table.Initial processing script to publish the table is run.
unsyncedunsynced Le script de traitement initial servant à publier la table sera exécuté lors de la prochaine exécution de l'Agent d'instantané.The initial processing script to publish the table is run the next time the Snapshot Agent runs.
stream_blob_columnsstream_blob_columns truetrue Une optimisation de flux de données est utilisée lors de la réplication de colonnes d'objets binaires volumineux (BLOB).A data stream optimization is used when replicating binary large object columns. Toutefois, certaines fonctionnalités de réplication de fusion, telles que les enregistrements logiques, peuvent tout de même empêcher d'utiliser l'optimisation de flux.However, certain merge replication functionalities, such as logical records, can still prevent the stream optimization from being used. stream_blob_columns a la valeur true lorsque FILESTREAM est activé.stream_blob_columns is set to true when FILESTREAM is enabled. Cela permet la réplication des données FILESTREAM dans le but d'optimiser et de réduire l'utilisation de la mémoire.This allows replication of FILESTREAM data to perform optimally and reduce memory utilization. Pour forcer les articles de la table FILESTREAM à ne pas utiliser l’objet blob de diffusion en continu, définissez stream_blob_columns avec la valeur false.To force FILESTREAM table articles to not use blob streaming, set stream_blob_columns to false.

** Important * \* l’activation de cette optimisation de la mémoire peut dégrader les performances de l’Agent de fusion lors de la synchronisation.** Important *\* Enabling this memory optimization might hurt the performance of the Merge Agent during synchronization. Cette option ne doit être utilisée que lors de la réplication de colonnes contenant des mégaoctets de données.This option should only be used when replicating columns that contain megabytes of data.
falsefalse L'optimisation n'est pas utilisée lors de la réplication de colonnes BLOB.The optimization is not used when replicating binary large object columns.
subscriber_upload_optionssubscriber_upload_options 00 Aucune restriction sur les mises à jour effectuées sur un Abonné disposant d'un abonnement client ; les modifications sont téléchargées sur le serveur de publication.No restrictions on updates made at a Subscriber with a client subscription; changes are uploaded to the Publisher. La modification de cette propriété peut exiger la réinitialisation des Abonnés existants.Changing this property may require that existing Subscribers be reinitialized.
11 Les modifications sont autorisées sur un Abonné disposant d'un abonnement client, mais elles ne sont pas téléchargées sur le serveur de publication.Changes are allowed at a Subscriber with a client subscription, but they are not uploaded to the Publisher.
22 Les modifications ne sont pas autorisées sur un Abonné disposant d'un abonnement client.Changes are not allowed at a Subscriber with a client subscription.
subset_filterclausesubset_filterclause Clause WHERE spécifiant le filtrage horizontal.WHERE clause specifying the horizontal filtering. S’applique uniquement à un article de table.Applies only to a table article.

** Important * \* pour des raisons de performances, il est recommandé que vous pas appliquez de fonctions aux noms de colonnes dans les clauses de filtre de lignes paramétrable, tel que LEFT([MyColumn]) = SUSER_SNAME().** Important *\* For performance reasons, we recommended that you not apply functions to column names in parameterized row filter clauses, such as LEFT([MyColumn]) = SUSER_SNAME(). Si vous utilisez HOST_NAME dans une clause de filtre et que vous remplacez la valeur HOST_NAME, vous devrez peut-être convertir les types de données à l’aide de convertir.If you use HOST_NAME in a filter clause and override the HOST_NAME value, you might have to convert data types by using CONVERT. Pour plus d’informations sur les meilleures pratiques pour ce cas, consultez la section « Substitution de la valeur de HOST_NAME() » dans Parameterized Row Filters.For more information about best practices for this case, see the section "Overriding the HOST_NAME() Value" in Parameterized Row Filters.
Seuilthreshold Pourcentage de valeur utilisé pour les abonnés exécutant SQL Server CompactSQL Server Compact ou des versions antérieures de SQL ServerSQL Server.Percentage value used for Subscribers running SQL Server CompactSQL Server Compact or earlier versions of SQL ServerSQL Server. seuil contrôle lorsque l’Agent de fusion affecte une nouvelle plage d’identité.threshold controls when the Merge Agent assigns a new identity range. Lorsque le pourcentage de valeurs spécifié dans le seuil est utilisé, l'Agent de fusion crée une nouvelle plage d'identité.When the percentage of values specified in threshold is used, the Merge Agent creates a new identity range. Utilisé lorsque identityrangemanagementoption a la valeur automatique ou auto_identity_range a la valeur true.Used when identityrangemanagementoption is set to auto or auto_identity_range is set to true. S'applique à un article de table uniquement.Applies to a table article only. Pour plus d’informations, consultez la section « Réplication de fusion » de répliquer des colonnes d’identité.For more information, see the "Merge Replication" section of Replicate Identity Columns.
verify_resolver_signatureverify_resolver_signature 11 La signature numérique d'un outil de résolution personnalisé est vérifiée pour déterminer s'il provient d'une source approuvée.Digital signature on a custom resolver is verified to determine if it is from a trusted source.
00 La signature numérique d'un outil de résolution personnalisé n'est pas vérifiée pour déterminer s'il provient d'une source approuvée.Digital signature on a custom resolver is not verified to determine if it is from a trusted source.
NULL (par défaut)NULL (default) Retourne la liste des valeurs prises en charge pour propriété.Returns the list of supported values for property.

[ @force_invalidate_snapshot = ] force_invalidate_snapshot[ @force_invalidate_snapshot = ] force_invalidate_snapshot
Signale que l'action entreprise par cette procédure stockée peut invalider un instantané existant.Acknowledges that the action taken by this stored procedure may invalidate an existing snapshot. force_invalidate_snapshot est un bits, avec une valeur par défaut 0.force_invalidate_snapshot is a bit, with a default of 0.

0 Spécifie que les modifications apportées à l’article de fusion n’invalident pas l’instantané n’est pas valide.0 specifies that changes to the merge article do not cause the snapshot to be invalid. 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.If the stored procedure detects that the change does require a new snapshot, an error occurs and no changes are made.

1 signifie que les modifications apportées à l’article de fusion peuvent invalider l’instantané n’est pas valide, et s’il existe des abonnements nécessitant un nouvel instantané, donne l’autorisation de l’instantané existant soit marqué comme obsolète et de générer un nouvel instantané.1 means that changes to the merge article may cause the snapshot to be invalid, and if there are existing subscriptions that would require a new snapshot, gives permission for the existing snapshot to be marked as obsolete and a new snapshot generated.

Consultez la section Remarques pour connaître les propriétés dont la modification nécessite la génération d'un nouvel instantané.See the Remarks section for the properties that, when changed, require the generation of a new snapshot.

[ @force_reinit_subscription = ] force_reinit_subscription[ @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.Acknowledges that the action taken by this stored procedure may require existing subscriptions to be reinitialized. force_reinit_subscription est un bits, avec une valeur par défaut 0.force_reinit_subscription is a bit, with a default of 0.

0 Spécifie que les modifications apportées à l’article de fusion ne provoquent pas la réinitialisation des abonnements.0 specifies that changes to the merge article do not cause the subscription to be reinitialized. 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.If the stored procedure detects that the change would require existing subscriptions to be reinitialized, an error occurs and no changes are made.

1 signifie que les modifications à l’article de fusion entraînent la réinitialisation des abonnements existants et autorise la réinitialisation des abonnements se produise.1 means that changes to the merge article cause existing subscriptions to be reinitialized, and gives permission for the subscription reinitialization to occur.

Voir la section Remarques pour connaître les propriétés dont la modification requiert la réinitialisation de tous les abonnements existants.See the Remarks section for the properties that, when changed, require that all existing subscriptions be reinitialized.

Valeurs des codes de retourReturn Code Values

0 (réussite) ou 1 (échec)0 (success) or 1 (failure)

NotesRemarks

sp_changemergearticle est utilisé dans la réplication de fusion.sp_changemergearticle is used in merge replication.

Étant donné que sp_changemergearticle est utilisée pour modifier les propriétés de l’article initialement spécifiées à l’aide de sp_addmergearticle, reportez-vous à sp_addmergearticle pour plus d’informations sur ces propriétés.Because sp_changemergearticle is used to change article properties that were initially specified by using sp_addmergearticle, refer to sp_addmergearticle for additional information about these properties.

Modifier les propriétés suivantes nécessite la génération d’un nouvel instantané, et vous devez spécifier une valeur de 1 pour le force_invalidate_snapshot paramètre :Changing the following properties requires that a new snapshot be generated, and you must specify a value of 1 for the force_invalidate_snapshot parameter:

  • check_permissionscheck_permissions

  • column_trackingcolumn_tracking

  • destination_ownerdestination_owner

  • pre_creation_commandpre_creation_command

  • schema_optionsschema_options

  • subset_filterclausesubset_filterclause

    Modifier les propriétés suivantes nécessite existants réinitialisation des abonnements, et vous devez spécifier une valeur de 1 pour le force_reinit_subscription paramètre :Changing the following properties requires that existing subscriptions be reinitialized, and you must specify a value of 1 for the force_reinit_subscription parameter:

  • check_permissionscheck_permissions

  • column_trackingcolumn_tracking

  • destination_ownerdestination_owner

  • pre_creation_commandpre_creation_command

  • identityrangemanagementoptionidentityrangemanagementoption

  • subscriber_upload_optionssubscriber_upload_options

  • subset_filterclausesubset_filterclause

  • creation_scriptcreation_script

  • schema_optionschema_option

  • logical_record_level_conflict_detectionlogical_record_level_conflict_detection

  • logical_record_level_conflict_resolutionlogical_record_level_conflict_resolution

    Lorsque vous spécifiez la valeur 3 pour partition_options, métadonnées sont nettoyées chaque fois que l’Agent de fusion s’exécute et l’instantané partitionné expire plus rapidement.When specifying a value of 3 for partition_options, metadata is cleaned up whenever the Merge Agent runs and the partitioned snapshot expires more quickly. Lorsque vous utilisez cette option, pensez à activer l'instantané partitionné requis par l'abonné.When using this option, you should consider enabling subscriber requested partitioned snapshot. Pour plus d’informations, voir Instantanés des publications de fusion avec des filtres paramétrés.For more information, see Snapshots for Merge Publications with Parameterized Filters.

    Lors de la définition du column_tracking propriété, si la table est déjà publiée dans d’autres publications de fusion, la colonne de suivi doit être identique à la valeur utilisée par des articles existants basés sur cette table.When setting the column_tracking property, if the table is already published in other merge publications, the column tracking must be the same as the value being used by existing articles based on this table. Ce paramètre concerne uniquement les articles de table.This parameter is specific to table articles only.

    Si plusieurs publications publient des articles basés sur la même table sous-jacente, modifiez le delete_tracking propriété ou le compensate_for_errors propriété pour un article entraîne la même modification à apporter aux autres articles qui reposent sur la même table.If multiple publications publish articles based on the same underlying table, changing the delete_tracking property or the compensate_for_errors property for one article causes the same change to be made to the other articles that are based on the same table.

    Si la connexion d'accès/le compte d'utilisateur du serveur de publication utilisé par le processus de fusion ne possède pas les autorisations de table appropriées, les modifications non valides sont enregistrées en tant que conflits.If the Publisher login/user account used by the merge process does not have the correct table permissions, the invalid changes are logged as conflicts.

    Lorsque vous modifiez la valeur de schema_option, le système n’effectue pas une mise à jour au niveau du bit.When changing the value of schema_option, the system does not perform a bitwise update. Cela signifie que lorsque vous définissez schema_option à l’aide de sp_changemergearticleexistante les paramètres bits peuvent être désactivés.This means that when you set schema_option using sp_changemergearticle, existing bit settings may be turned off. 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.To retain the existing settings, you should perform & (Bitwise AND) between the value that you are setting and the current value of schema_option, which can be determined by executing sp_helpmergearticle.

Attention

Lorsque vous nombreuses (peut-être des centaines) des articles dans une publication et que vous exécutez sp_changemergearticle pour l’un des articles, il peut prendre beaucoup de temps pour terminer l’exécution.When you many (perhaps hundreds) of articles in a publication and you execute sp_changemergearticle for one of the articles, it might take a long time to finish execution.

Tableau des options de schéma validesValid Schema Option Table

Le tableau suivant décrit autorisées schema_optionvaleurs, en fonction du type d’article.The following table describes the allowed schema_optionvalues, depending on article type.

Type de l'articleArticle type Valeurs de l'option de schémaSchema option values
schéma Func uniquementfunc schema only 0 x 01 et 0 x 20000x01 and 0x2000
schéma de vue indexée uniquementindexed view schema only 0 x 01, 0 x 040, 0 x 0100, 0 x 2000, 0 x 40000, 0 x 1000000et 0 x 2000000x01, 0x040, 0x0100, 0x2000, 0x40000, 0x1000000, and 0x200000
schéma de procédure uniquementproc schema only 0 x 01 et 0 x 20000x01 and 0x2000
tabletable Toutes les options.All options.
schéma de vue uniquementview schema only 0 x 01, 0 x 040, 0 x 0100, 0 x 2000, 0 x 40000, 0 x 1000000et 0 x 2000000x01, 0x040, 0x0100, 0x2000, 0x40000, 0x1000000, and 0x200000

ExempleExample

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 [AdventureWorks2012]
EXEC sp_changemergearticle 
  @publication = @publication,
  @article = @article, 
  @property = N'column_tracking', 
  @value = N'true',
  @force_invalidate_snapshot = 1,
  @force_reinit_subscription = 1;
GO

AutorisationsPermissions

Seuls les membres de la sysadmin rôle serveur fixe ou db_owner du rôle de base de données fixe peut exécuter sp_changemergearticle.Only members of the sysadmin fixed server role or db_owner fixed database role can execute sp_changemergearticle.

Voir aussiSee Also

Afficher et modifier les propriétés de l’Article View and Modify Article Properties
Changer les propriétés des publications et des articles Change Publication and Article Properties
sp_addmergearticle (Transact-SQL) sp_addmergearticle (Transact-SQL)
sp_dropmergearticle (Transact-SQL) sp_dropmergearticle (Transact-SQL)
sp_helpmergearticle (Transact-SQL) sp_helpmergearticle (Transact-SQL)
Procédures stockées de réplication (Transact-SQL)Replication Stored Procedures (Transact-SQL)