sp_addmergearticle (Transact-SQL)sp_addmergearticle (Transact-SQL)

S’APPLIQUE À : ouiSQL Server ouiAzure SQL Database (Managed Instance uniquement) nonAzure SQL Data Warehouse nonParallel Data Warehouse APPLIES TO: yesSQL Server yesAzure SQL Database (Managed Instance only) noAzure SQL Data Warehouse noParallel Data Warehouse

Ajoute un article à une publication de fusion existante.Adds an article to an existing merge publication. 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_addmergearticle [ @publication = ] 'publication'   
        , [ @article = ] 'article'   
        , [ @source_object = ] 'source_object'   
    [ , [ @type = ] 'type' ]   
    [ , [ @description = ] 'description' ]   
    [ , [ @column_tracking = ] 'column_tracking' ]   
    [ , [ @status = ] 'status' ]   
    [ , [ @pre_creation_cmd = ] 'pre_creation_cmd' ]   
    [ , [ @creation_script = ] 'creation_script' ]   
    [ , [ @schema_option = ] schema_option ]   
    [ , [ @subset_filterclause = ] 'subset_filterclause' ]   
    [ , [ @article_resolver = ] 'article_resolver' ]   
    [ , [ @resolver_info = ] 'resolver_info' ]   
    [ , [ @source_owner = ] 'source_owner' ]   
    [ , [ @destination_owner = ] 'destination_owner' ]   
    [ , [ @vertical_partition = ] 'vertical_partition' ]   
    [ , [ @auto_identity_range = ] 'auto_identity_range' ]   
    [ , [ @pub_identity_range = ] pub_identity_range ]   
    [ , [ @identity_range = ] identity_range ]   
    [ , [ @threshold = ] threshold ]   
    [ , [ @verify_resolver_signature = ] verify_resolver_signature ]   
    [ , [ @destination_object = ] 'destination_object' ]   
    [ , [ @allow_interactive_resolver = ] 'allow_interactive_resolver' ]   
    [ , [ @fast_multicol_updateproc = ] 'fast_multicol_updateproc' ]   
    [ , [ @check_permissions = ] check_permissions ]   
    [ , [ @force_invalidate_snapshot = ] force_invalidate_snapshot ]  
    [ , [ @published_in_tran_pub = ] 'published_in_tran_pub' ]  
    [ , [ @force_reinit_subscription = ] force_reinit_subscription ]  
    [ , [ @logical_record_level_conflict_detection = ] 'logical_record_level_conflict_detection' ]  
    [ , [ @logical_record_level_conflict_resolution = ] 'logical_record_level_conflict_resolution' ]  
    [ , [ @partition_options = ] partition_options ]  
    [ , [ @processing_order = ] processing_order ]  
    [ , [ @subscriber_upload_options = ] subscriber_upload_options ]  
    [ , [ @identityrangemanagementoption = ] 'identityrangemanagementoption' ]  
    [ , [ @delete_tracking = ] delete_tracking ]  
    [ , [ @compensate_for_errors = ] 'compensate_for_errors' ]   
    [ , [ @stream_blob_columns = ] 'stream_blob_columns' ]  

ArgumentsArguments

[ @publication = ] 'publication'Nom de la publication qui contient l’article.[ @publication = ] 'publication' Is the name of the publication that contains the article. publication est de type sysname, sans valeur par défaut.publication is sysname, with no default.

[ @article = ] 'article'Nom de l’article.[ @article = ] 'article' Is the name of the article. Le nom doit être unique dans la publication.The name must be unique within the publication. article est de type sysnameet n’a pas de valeur par défaut.article is sysname, with no default. l' article doit se trouver sur l’ordinateur MicrosoftMicrosoft local exécutant SQL ServerSQL Serveret doit respecter les règles applicables aux identificateurs.article must be on the local computer running MicrosoftMicrosoft SQL ServerSQL Server, and must conform to the rules for identifiers.

[ @source_object = ] 'source_object'Objet de base de données à publier.[ @source_object = ] 'source_object' Is the database object to be published. source_object est de type sysname, sans valeur par défaut.source_object is sysname, with no default. Pour plus d’informations sur les types d’objets qui peuvent être publiés à l’aide de la réplication de fusion, consultez publier des données et des objets de base de données.For more information about the types of objects that can be published using merge replication, see Publish Data and Database Objects.

[ @type = ] 'type'Est le type d’article.[ @type = ] 'type' Is the type of article. type est de type sysname, avec tablecomme valeur par défaut et peut prendre l’une des valeurs suivantes.type is sysname, with a default of table, and can be one of the following values.

ValueValue DescriptionDescription
table valeurstable (default) Table avec schéma et données.Table with schema and data. La réplication surveille la table pour déterminer les données à répliquer.Replication monitors the table to determine data to be replicated.
schéma Func uniquementfunc schema only Fonction avec schéma uniquement.Function with schema only.
vue indexée schéma uniquementindexed view schema only Vue indexée avec schéma uniquement.Indexed view with schema only.
schéma de procédure uniquementproc schema only Procédure stockée avec schéma uniquement.Stored procedure with schema only.
schéma de synonyme uniquementsynonym schema only Synonyme avec schéma uniquement.Synonym with schema only.
afficher le schéma uniquementview schema only Vue avec schéma uniquement.View with schema only.

[ @description = ] 'description'Est une description de l’article.[ @description = ] 'description' Is a description of the article. Description est de type nvarchar (255) , avec NULL comme valeur par défaut.description is nvarchar(255), with a default of NULL.

[ @column_tracking = ] 'column_tracking'Est le paramètre pour le suivi au niveau des colonnes.[ @column_tracking = ] 'column_tracking' Is the setting for column-level tracking. column_tracking est de type nvarchar (10) , avec false comme valeur par défaut.column_tracking is nvarchar(10), with a default of FALSE. trueactive le suivi de colonne.trueturns on column tracking. false désactive le suivi des colonnes et conserve la détection des conflits au niveau de la ligne.false turns off column tracking and leaves conflict detection at the row level. Si la table est déjà publiée dans d'autres publications de fusion, vous devez utiliser la même valeur de suivi de colonne que celle des articles existants basés sur cette table.If the table is already published in other merge publications, you must use the same column tracking value 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.

Notes

Si le suivi de lignes est utilisé pour la détection de conflits (valeur par défaut), la table de base peut inclure 1 024 colonnes au maximum, mais les colonnes doivent être filtrées à partir de l'article afin que 246 colonnes au maximum soient publiées.If row tracking is used for conflict detection (the default), the base table can include a maximum of 1,024 columns, but columns must be filtered from the article so that a maximum of 246 columns is published. Si le suivi de colonnes est utilisé, la table de base peut inclure 246 colonnes au maximum.If column tracking is used, the base table can include a maximum of 246 columns.

[ @status = ] 'status'État de l’article.[ @status = ] 'status' Is the status of the article. Status est de type nvarchar (10) , avecunsyncd comme valeur par défaut.status is nvarchar(10), with a default of unsynced. S’il est actif, le script de traitement initial qui permet de publier la table est exécuté.If active, the initial processing script to publish the table is run. En cas de non synchronisation, le script de traitement initial permettant de publier la table est exécuté lors de la prochaine exécution du agent d’instantané.If unsynced, the initial processing script to publish the table is run at the next time the Snapshot Agent runs.

[ @pre_creation_cmd = ] 'pre_creation_cmd'Spécifie ce que le système doit faire si la table existe sur l’abonné lors de l’application de l’instantané.[ @pre_creation_cmd = ] 'pre_creation_cmd' Specifies what the system is to do if the table exists at the subscriber when applying the snapshot. pre_creation_cmd est de type nvarchar (10) et peut prendre l’une des valeurs suivantes.pre_creation_cmd is nvarchar(10), and can be one of the following values.

ValueValue DescriptionDescription
Nonenone 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.
supprimer valeursdrop (default) Supprime la table avant de la recréer.Drops the table before re-creating it. Requis pour prendre MicrosoftMicrosoft en charge SQL Server CompactSQL Server Compact les abonnés.Required to support MicrosoftMicrosoft SQL Server CompactSQL Server Compact Subscribers.
truncatetruncate Tronque la table de destination.Truncates the destination table.

[ @creation_script = ] 'creation_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.[ @creation_script = ] 'creation_script' Is the path and name of an optional article schema script used to create the article in the subscription database. creation_script est de type nvarchar (255) , avec NULL comme valeur par défaut.creation_script is nvarchar(255), with a default of NULL.

Notes

Les scripts de création ne sont pas exécutés sur les Abonnés SQL Server CompactSQL Server Compact.Creation scripts are not run on SQL Server CompactSQL Server Compact Subscribers.

[ @schema_option = ] schema_optionBitmap de l’option de génération de schéma pour l’article donné.[ @schema_option = ] schema_option Is a bitmap of the schema generation option for the given article. schema_option est binaire (8) et peut être | (Opérateur or au niveau du bit) produit d’une ou plusieurs de ces valeurs.schema_option is binary(8), and can be the | (Bitwise OR) product of one or more of these values.

ValueValue DescriptionDescription
0x000x00 Désactive les scripts par le Agent d’instantané et utilise le script de précréation de schéma fourni défini dans creation_script.Disables scripting by the Snapshot Agent and uses the provided schema precreation script defined in creation_script.
0x010x01 Génère la création d'objets (CREATE TABLE, CREATE PROCEDURE, etc.).Generates the object creation (CREATE TABLE, CREATE PROCEDURE, and so on). Cette valeur est la valeur par défaut pour les articles de procédure stockée.This is the default value for stored procedure articles.
0x100x10 Génère un index cluster correspondant.Generates a corresponding clustered index. Même si cette option n'est pas activée, les index relatifs aux clés primaires et aux contraintes UNIQUE sont générés s'ils sont déjà définis sur une table publiée.Even if this option is not set, indexes related to primary keys and UNIQUE constraints are generated if they are already defined on a published table.
0x200x20 Convertit les types de données définis par l'utilisateur (UDT) en types de données de base auprès de l'Abonné.Converts user-defined data types (UDT) to base data types at the Subscriber. Vous ne pouvez pas utiliser cette option 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 désigne une colonne UDT.This option cannot be used when there is a CHECK or DEFAULT constraint on a UDT column, if a UDT column is part of the primary key, or if a computed column references a UDT column.
0x400x40 Génère les index non-cluster correspondants.Generates corresponding nonclustered indexes. Même si cette option n'est pas activée, les index relatifs aux clés primaires et aux contraintes UNIQUE sont générés s'ils sont déjà définis sur une table publiée.Even if this option is not set, indexes related to primary keys and UNIQUE constraints are generated if they are already defined on a published table.
0x800x80 Réplique les contraintes PRIMARY KEY.Replicates PRIMARY KEY constraints. Tous les index associés à la contrainte sont également répliqués, même si les options 0x10 et 0x40 ne sont pas activées.Any indexes related to the constraint are also replicated, even if options 0x10 and 0x40 are not enabled.
0x1000x100 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.
0x2000x200 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.
0x4000x400 Réplique les contraintes CHECK.Replicates CHECK constraints.
0x8000x800 Réplique les valeurs par défaut.Replicates defaults.
0x10000x1000 Réplique le classement au niveau des colonnes.Replicates column-level collation.
0x20000x2000 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.
0x40000x4000 Réplique les contraintes UNIQUE.Replicates UNIQUE constraints. Tous les index associés à la contrainte sont également répliqués, même si les options 0x10 et 0x40 ne sont pas activées.Any indexes related to the constraint are also replicated, even if options 0x10 and 0x40 are not enabled.
0x80000x8000 Cette option n'est pas valide pour les serveurs de publication qui exécutent SQL Server 2005 (9.x)SQL Server 2005 (9.x) ou des versions ultérieures.This option is not valid for Publishers running SQL Server 2005 (9.x)SQL Server 2005 (9.x) or later versions.
0x100000x10000 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.
0x200000x20000 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.
0x400000x40000 Réplique les groupes de fichiers associés à une table ou un index partitionné.Replicates filegroups associated with a partitioned table or index.
0x800000x80000 Réplique le schéma de partition d'une table partitionnée.Replicates the partition scheme for a partitioned table.
0x1000000x100000 Réplique le schéma de partition d'un index partitionné.Replicates the partition scheme for a partitioned index.
0x2000000x200000 Réplique les statistiques d'une table.Replicates table statistics.
0x4000000x400000 Réplique des liaisons par défaut.Replicates default Bindings.
0x8000000x800000 Réplique les liaisons de règle.Replicates rule Bindings.
0x10000000x1000000 Réplique l’index de recherche en texte intégral.Replicates the full-text index.
0x20000000x2000000 Les collections de schémas XML liées aux colonnes XML ne sont pas répliquées.XML schema collections bound to xml columns are not replicated.
0x40000000x4000000 Réplique les index sur les colonnes XML .Replicates indexes on xml columns.
0x80000000x8000000 Crée n'importe quel schéma qui n'est pas déjà présent sur l'abonné.Creates any schemas not already present on the subscriber.
0x100000000x10000000 Convertit les colonnes XML en ntext sur l’abonné.Converts xml columns to ntext on the Subscriber.
0x200000000x20000000 Convertit les types de données d’objet volumineux (nvarchar (max) , varchar (max) et varbinary (max) ) introduits dans SQL Server 2005 (9.x)SQL Server 2005 (9.x) en types de SQL Server 2000 (8.x)SQL Server 2000 (8.x)données pris en charge sur.Converts large object data types (nvarchar(max), varchar(max), and varbinary(max)) introduced in SQL Server 2005 (9.x)SQL Server 2005 (9.x) to data types that are supported on SQL Server 2000 (8.x)SQL Server 2000 (8.x).
0x400000000x40000000 Réplique des autorisations.Replicates permissions.
to0x80000000 Tente de supprimer les dépendances à tous les objets ne faisant pas partie de la publication.Attempts to drop dependencies to any objects that are not part of the publication.
0x1000000000x100000000 Utilisez cette option pour répliquer l’attribut FILESTREAM s’il est spécifié sur des colonnes varbinary (max) .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 2005 (9.x)SQL Server 2005 (9.x).Do not specify this option if you are replicating tables to SQL Server 2005 (9.x)SQL Server 2005 (9.x) Subscribers. La réplication de tables qui possèdent des SQL Server 2000 (8.x)SQL Server 2000 (8.x) colonnes FILESTREAM sur des abonnés n’est pas prise en charge, quelle que soit la façon dont cette option de schéma est définie.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 associée 0x800000000.See related option 0x800000000.
0x2000000000x200000000 Convertit les types de données de date et d’heure (Date, Time, DateTimeOffsetet SQL Server 2008SQL Server 2008 datetime2) introduits dans en types de données pris SQL ServerSQL Serveren charge dans les versions antérieures de.Converts date and time data types (date, time, datetimeoffset, and datetime2) 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 Compression de données.For more information, see Data Compression.
0x8000000000x800000000 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 création d’objets avant l’application de l’instantané, consultez exécuter des scripts avant et après l’application de l’instantané.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 associée 0x100000000.See related option 0x100000000.
0x10000000000x1000000000 Convertit les types définis par l’utilisateur (UDT) common language runtime (CLR) en varbinary (max) afin que les colonnes de type UDT puissent être répliquées sur SQL Server 2005 (9.x)SQL Server 2005 (9.x)les abonnés qui exécutent.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 2005 (9.x)SQL Server 2005 (9.x).
0x20000000000x2000000000 Convertit le type de données hierarchyid en varbinary (max) afin que les colonnes de type hierarchyid puissent être répliquées sur les SQL Server 2005 (9.x)SQL Server 2005 (9.x)abonnés qui exécutent.Converts the hierarchyid data type to varbinary(max) so that columns of type hierarchyid can be replicated to Subscribers that are running SQL Server 2005 (9.x)SQL Server 2005 (9.x). Pour plus d’informations sur l’utilisation des colonnes hierarchyid 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 créer des index filtrés.For more information about filtered indexes, see Create Filtered Indexes.
0x80000000000x8000000000 Convertit les types de données Geography et Geometry en varbinary (max) afin que les colonnes de ces types puissent être répliquées sur SQL Server 2005 (9.x)SQL Server 2005 (9.x)les abonnés qui exécutent.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 2005 (9.x)SQL Server 2005 (9.x).
0x100000000000x10000000000 Réplique les index sur les colonnes de type Geography et Geometry.Replicates indexes on columns of type geography and geometry.

Si la valeur est NULL, le système génère automatiquement une option de schéma valide pour l'article.If this value is NULL, the system auto-generates a valid schema option for the article. La table option de schéma par défaut de la section Notes affiche la valeur choisie en fonction du type d’article.The Default Schema Option table in the Remarks section shows the value that is chosen based upon the article type. En outre, toutes les valeurs schema_option ne sont pas valides pour chaque type de réplication et de type d’article.Also, not all schema_option values are valid for every type of replication and article type. Le tableau des options de schéma valides indiqué dans les notes affiche les options qui peuvent être spécifiées pour un type d’article donné.The Valid Schema Option table given in the Remarks shows the options that can be specified for a given article type.

Notes

Le paramètre schema_option affecte uniquement les options de réplication pour l’instantané initial.The schema_option parameter only affects replication options for the initial snapshot. Une fois que le schéma initial a été généré par le Agent d’instantané et appliqué à l’abonné, la réplication des modifications de schéma de publication sur l’abonné se produit en fonction des règles de réplication de modification de schéma et du paramètre replicate_ddl spécifié dans sp_addmergepublication.Once the initial schema has been generated by the Snapshot Agent and applied at the Subscriber, the replication of publication schema changes to the Subscriber occur based on schema change replication rules and the replicate_ddl parameter setting specified in sp_addmergepublication. Pour plus d’informations, consultez Modifier le schéma dans les bases de données de publication.For more information, see Make Schema Changes on Publication Databases.

[ @subset_filterclause = ] 'subset_filterclause'Est une clause WHERE spécifiant le filtrage horizontal d’un article de table sans le mot WHERE inclus.[ @subset_filterclause = ] 'subset_filterclause' Is a WHERE clause specifying the horizontal filtering of a table article without the word WHERE included. subset_filterclause est de type nvarchar (1000) , avec une chaîne vide comme valeur par défaut.subset_filterclause is of nvarchar(1000), with a default of an empty string.

Important

Pour des raisons de performances, il est recommandé de ne pas appliquer de fonctions aux noms de colonnes dans les clauses de filtres de lignes paramétrables, comme LEFT([MyColumn]) = SUSER_SNAME().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 de HOST_NAME, vous devrez peut-être convertir les types de données à l’aide de Convert.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 filtres de lignes paramétrables.For more information about best practices for this case, see the section "Overriding the HOST_NAME() Value" in Parameterized Row Filters.

[ @article_resolver = ] 'article_resolver'Est le programme de résolution basé sur COM utilisé pour résoudre les conflits sur l’article de table ou l’assembly .NET Framework appelé pour exécuter une logique métier personnalisée sur l’article de table.[ @article_resolver = ] 'article_resolver' Is the COM-based resolver used to resolve conflicts on the table article or the .NET Framework assembly invoked to execute custom business logic on the table article. article_resolver est de type varchar (255) , avec NULL comme valeur par défaut.article_resolver is varchar(255), with a default of NULL. Les valeurs disponibles pour ce paramètre sont répertoriées dans la liste des outils de résolution personnalisés MicrosoftMicrosoft.Available values for this parameter are listed in MicrosoftMicrosoft Custom Resolvers. Si la valeur fournie ne correspond pas à l'un des outils de résolution MicrosoftMicrosoft, SQL ServerSQL Server utilise l'outil de résolution spécifié et non celui qui est fourni par le système.If the value provided is not one of the MicrosoftMicrosoft resolvers, SQL ServerSQL Server uses the specified resolver instead of the system-supplied resolver. Utilisez sp_enumcustomresolvers pour énumérer la liste des programmes de résolution personnalisés disponibles.Use sp_enumcustomresolvers to enumerate the list of available custom resolvers. Pour plus d’informations, consultez exécuter la logique métier pendant la synchronisation de fusion et détection et résolution avancées des conflits de réplication de fusion.For more information, see Execute Business Logic During Merge Synchronization and Advanced Merge Replication Conflict Detection and Resolution.

[ @resolver_info = ] 'resolver_info'Est utilisé pour spécifier des informations supplémentaires requises par un programme de résolution personnalisé.[ @resolver_info = ] 'resolver_info' 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 de type 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.

[ @source_owner = ] 'source_owner'Nom du propriétaire de la source_object.[ @source_owner = ] 'source_owner' Is the name of the owner of the source_object. source_owner est de type sysname, avec NULL comme valeur par défaut.source_owner is sysname, with a default of NULL. Si la valeur NULL est affectée à l'argument, l'utilisateur actuel est supposé être le propriétaire.If NULL, the current user is assumed to be the owner.

[ @destination_owner = ] 'destination_owner'Propriétaire de l’objet dans la base de données d’abonnement, s’il ne s’agit pas de «dbo».[ @destination_owner = ] 'destination_owner' Is the owner of the object in the subscription database, if not 'dbo'. destination_owner est de type sysname, avec NULL comme valeur par défaut.destination_owner is sysname, with a default of NULL. Si la valeur NULL est affectée à l'argument, « dbo » est supposé être le propriétaire.If NULL, 'dbo' is assumed to be the owner.

[ @vertical_partition = ] 'column_filter'Active et désactive le filtrage de colonne sur un article de table.[ @vertical_partition = ] 'column_filter' Enables and disables column filtering on a table article. vertical_partition est de type nvarchar (5), avec false comme valeur par défaut.vertical_partition is nvarchar(5) with a default of FALSE.

false indique qu’il n’y a pas de filtrage vertical et publie toutes les colonnes.false indicates there is no vertical filtering and publishes all columns.

true efface toutes les colonnes, à l’exception des colonnes de clé primaire et rowguid déclarées.true clears all columns except the declared primary key and ROWGUID columns. Les colonnes sont ajoutées à l’aide de sp_mergearticlecolumn.Columns are added by using sp_mergearticlecolumn.

[ @auto_identity_range = ] 'automatic_identity_range'Active et désactive la gestion automatique des plages d’identité pour cet article de table sur une publication au moment de sa création.[ @auto_identity_range = ] 'automatic_identity_range' Enables and disables automatic identity range handling for this table article on a publication at the time it is created. auto_identity_range est de type nvarchar (5) , avec false comme valeur par défaut.auto_identity_range is nvarchar(5), with a default of FALSE. true active la gestion automatique des plages d' identité, tandis que false la désactive.true enables automatic identity range handling, while false disables it.

Notes

auto_identity_range est déconseillé et n’est fourni qu’à des fins de compatibilité descendante.auto_identity_range has been deprecated and is provided for backward compatibility only. Vous devez utiliser identityrangemanagementoption pour spécifier les options de gestion des plages d’identité.You should use identityrangemanagementoption for specifying identity range management options. Pour plus d’informations, consultez Répliquer des colonnes d’identité.For more information, see Replicate Identity Columns.

[ @pub_identity_range = ] pub_identity_rangeContrôle la taille de la plage d’identité allouée à un abonné avec un abonnement serveur lorsque la gestion automatique des plages d’identité est utilisée.[ @pub_identity_range = ] pub_identity_range Controls the identity range size allocated to a Subscriber with a server subscription when automatic identity range management is used. 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. pub_identity_range est de type bigint, avec NULL comme valeur par défaut.pub_identity_range is bigint, with a default of NULL. Vous devez spécifier ce paramètre si identityrangemanagementoption est auto ou si auto_identity_range a la valeur true.You must specify this parameter if identityrangemanagementoption is auto or if auto_identity_range is true.

[ @identity_range = ] identity_rangeContrôle la taille de la plage d’identité allouée à la fois au serveur de publication et à l’abonné lorsque la gestion automatique des plages d’identité est utilisée.[ @identity_range = ] identity_range Controls the identity range size allocated both to the Publisher and to the Subscriber when automatic identity range management is used. identity_range est de type bigint, avec NULL comme valeur par défaut.identity_range is bigint, with a default of NULL. Vous devez spécifier ce paramètre si identityrangemanagementoption est auto ou si auto_identity_range a la valeur true.You must specify this parameter if identityrangemanagementoption is auto or if auto_identity_range is true.

Notes

identity_range contrôle la taille de la plage d’identité lors de la republication SQL ServerSQL Serverdes abonnés à l’aide de versions antérieures de.identity_range controls the identity range size at republishing Subscribers using previous versions of SQL ServerSQL Server.

[ @threshold = ] thresholdValeur de pourcentage qui contrôle le moment où l’Agent de fusion affecte une nouvelle plage d’identité.[ @threshold = ] threshold Percentage value that controls when the Merge Agent assigns a new identity range. Lorsque le pourcentage de valeurs spécifié dans seuil est utilisé, la 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. Threshold est de type int, avec NULL comme valeur par défaut.threshold is int, with a default of NULL. Vous devez spécifier ce paramètre si identityrangemanagementoption est auto ou si auto_identity_range a la valeur true.You must specify this parameter if identityrangemanagementoption is auto or if auto_identity_range is true.

[ @verify_resolver_signature = ] verify_resolver_signatureSpécifie si une signature numérique est vérifiée avant d’utiliser un programme de résolution dans la réplication de fusion.[ @verify_resolver_signature = ] verify_resolver_signature Specifies if a digital signature is verified before using a resolver in merge replication. verify_resolver_signature est de type int, avec 1 comme valeur par défaut.verify_resolver_signature is int, with a default of 1.

0 indique que la signature ne sera pas vérifiée.0 specifies that the signature will not be verified.

1 indique que la signature sera vérifiée pour déterminer si elle provient d’une source approuvée.1 specifies that the signature will be verified to see if it is from a trusted source.

[ @destination_object = ] 'destination_object'Nom de l’objet dans la base de données d’abonnement.[ @destination_object = ] 'destination_object' Is the name of the object in the subscription database. destination_object est de type sysname, avec la valeur par défaut de **@source_object** ce qui se trouve dans.destination_object is sysname, with a default value of what is in **@source_object**. Ce paramètre ne peut être spécifié que si l'article est un article de schéma exclusivement, tel que le sont les procédures stockées, vues et fonctions définies par l'utilisateur.This parameter can be specified only if the article is a schema-only article, such as stored procedures, views, and UDFs. Si l’article spécifié est un article de table, la valeur *@source_object* de remplace la valeur dans destination_object.If the article specified is a table article, the value in *@source_object* overrides the value in destination_object.

[ @allow_interactive_resolver = ] 'allow_interactive_resolver'Active ou désactive l’utilisation du programme de résolution interactif sur un article.[ @allow_interactive_resolver = ] 'allow_interactive_resolver' Enables or disables the use of the Interactive Resolver on an article. allow_interactive_resolver est de type nvarchar (5) , avec false comme valeur par défaut.allow_interactive_resolver is nvarchar(5), with a default of FALSE. la valeur true active l’utilisation du programme de résolution interactif sur l’article. false le désactive.true enables the use of the Interactive Resolver on the article; false disables it.

Notes

L'outil de résolution interactif n'est pas pris en charge par les Abonnés SQL Server CompactSQL Server Compact.Interactive Resolver is not supported by SQL Server CompactSQL Server Compact Subscribers.

[ @fast_multicol_updateproc = ] 'fast_multicol_updateproc'Ce paramètre est déconseillé et conservé pour la compatibilité descendante des scripts.[ @fast_multicol_updateproc = ] 'fast_multicol_updateproc' This parameter has been deprecated and is maintained for backward compatibility of scripts.

[ @check_permissions = ] check_permissionsEst une bitmap des autorisations au niveau de la table qui sont vérifiées lorsque l’Agent de fusion applique les modifications au serveur de publication.[ @check_permissions = ] check_permissions Is a bitmap of the table-level permissions that are verified when the Merge Agent applies changes to the Publisher. 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. check_permissions est de type intet peut être | (Opérateur or au niveau du bit) produit d’une ou plusieurs des valeurs suivantes.check_permissions is int, and can be the | (Bitwise OR) product of one or more of the following values.

ValueValue DescriptionDescription
0x00 (valeur par défaut)0x00 (default) Les autorisations ne sont pas vérifiées.Permissions are not checked.
0x100x10 Les autorisations sont vérifiées sur le serveur de publication avant que les opérations d'insertion exécutées sur l'Abonné puissent être téléchargées.Checks permissions at the Publisher before insert operations made at a Subscriber can be uploaded.
0x200x20 Les autorisations sont vérifiées sur le serveur de publication avant que les opérations de mise à jour exécutées sur l'Abonné puissent être téléchargées.Checks permissions at the Publisher before update operations made at a Subscriber can be uploaded.
0x400x40 Les autorisations sont vérifiées sur le serveur de publication avant que les opérations de suppression exécutées sur l'Abonné puissent être téléchargées.Checks permissions at the Publisher before delete operations made at a Subscriber can be uploaded.

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

0 indique que l’ajout d’un article n’entraîne pas la non-validité de l’instantané.0 specifies that adding an article does 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 indique que l’ajout d’un article peut entraîner la non-validité de l’instantané et, s’il existe des abonnements nécessitant un nouvel instantané, accorde l’autorisation de marquer l’instantané existant comme obsolète et de générer un nouvel instantané.1 specifies that adding an article may cause the snapshot to be invalid, and if there are existing subscriptions that require a new snapshot, gives permission for the existing snapshot to be marked as obsolete and a new snapshot generated. force_invalidate_snapshot a la valeur 1 lors de l’ajout d’un article à une publication avec un instantané existant.force_invalidate_snapshot is set to 1 when adding an article to a publication with an existing snapshot.

[ @published_in_tran_pub = ] 'published_in_tran_pub'Indique qu’un article d’une publication de fusion est également publié dans une publication transactionnelle.[ @published_in_tran_pub = ] 'published_in_tran_pub' Indicates that an article in a merge publication is also published in a transactional publication. published_in_tran_pub est de type nvarchar (5) , avec false comme valeur par défaut.published_in_tran_pub is nvarchar(5), with a default of FALSE. la valeur true indique que l’article est également publié dans une publication transactionnelle.true specifies that the article is also published in a transactional publication.

[ @force_reinit_subscription = ] force_reinit_subscriptionConfirme que l’action entreprise par cette procédure stockée peut nécessiter la réinitialisation des abonnements existants.[ @force_reinit_subscription = ] force_reinit_subscription Acknowledges that the action taken by this stored procedure may require existing subscriptions to be reinitialized. force_reinit_subscription est un bit, avec 0 comme valeur par défaut.force_reinit_subscription is a bit, with a default of 0.

0 indique que l’ajout d’un article n’entraîne pas la réinitialisation de l’abonnement.0 specifies that adding an article does 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 apportées à l’article de fusion entraînent la réinitialisation des abonnements existants et autorise la réinitialisation de l’abonnement.1 means that changes to the merge article causes existing subscriptions to be reinitialized, and gives permission for the subscription reinitialization to occur. force_reinit_subscription a la valeur 1 lorsque subset_filterclause spécifie un filtre de lignes paramétrable.force_reinit_subscription is set to 1 when subset_filterclause specifies a parameterized row filter.

[ @logical_record_level_conflict_detection = ] 'logical_record_level_conflict_detection'Spécifie le niveau de détection de conflit pour un article qui est membre d’un enregistrement logique.[ @logical_record_level_conflict_detection = ] 'logical_record_level_conflict_detection' Specifies the level of conflict detection for an article that is a member of a logical record. logical_record_level_conflict_detection est de type nvarchar (5) , avec false comme valeur par défaut.logical_record_level_conflict_detection is nvarchar(5), with a default of FALSE.

la valeur true indique qu’un conflit est détecté si des modifications sont effectuées n’importe où dans l’enregistrement logique.true specifies that a conflict will be detected if changes are made anywhere in the logical record.

false spécifie que la détection de conflit par défaut est utilisée comme spécifié par column_tracking.false specifies that the default conflict detection is used as specified by column_tracking. Pour plus d’informations, consultez Regrouper les modifications apportées à des lignes connexes à l’aide d’enregistrements logiques.For more information, see Group Changes to Related Rows with Logical Records.

Notes

Étant donné que les enregistrements logiques SQL Server CompactSQL Server Compact ne sont pas pris en charge par les abonnés, vous devez spécifier la valeur false pour que logical_record_level_conflict_detection prenne en charge ces abonnés.Because logical records are not supported by SQL Server CompactSQL Server Compact Subscribers, you must specify a value of false for logical_record_level_conflict_detection to support these Subscribers.

[ @logical_record_level_conflict_resolution = ] 'logical_record_level_conflict_resolution'Spécifie le niveau de résolution de conflit pour un article qui est membre d’un enregistrement logique.[ @logical_record_level_conflict_resolution = ] 'logical_record_level_conflict_resolution' Specifies the level of conflict resolution for an article that is a member of a logical record. logical_record_level_conflict_resolution est de type nvarchar (5) , avec false comme valeur par défaut.logical_record_level_conflict_resolution is nvarchar(5), with a default of FALSE.

la valeur true indique que la totalité de l’enregistrement logique gagnant remplace l’enregistrement logique perdant.true specifies that the entire winning logical record overwrites the losing logical record.

false spécifie que les lignes gagnantes ne sont pas restreintes à l’enregistrement logique.false specifies that winning rows are not constrained to the logical record. Si logical_record_level_conflict_detection a la valeur true, logical_record_level_conflict_resolution doit également avoir la valeur true.If logical_record_level_conflict_detection is true, then logical_record_level_conflict_resolution must also be set to true. Pour plus d’informations, consultez Regrouper les modifications apportées à des lignes connexes à l’aide d’enregistrements logiques.For more information, see Group Changes to Related Rows with Logical Records.

Notes

Étant donné que les enregistrements logiques SQL Server CompactSQL Server Compact ne sont pas pris en charge par les abonnés, vous devez spécifier la valeur false pour que logical_record_level_conflict_resolution prenne en charge ces abonnés.Because logical records are not supported by SQL Server CompactSQL Server Compact Subscribers, you must specify a value of false for logical_record_level_conflict_resolution to support these Subscribers.

[ @partition_options = ] partition_optionsDéfinit la façon dont les données de l’article sont partitionnées, ce qui permet d’optimiser les performances lorsque toutes les lignes appartiennent à une seule partition ou à un seul abonnement.[ @partition_options = ] partition_options Defines the way in which data in the article is partitioned, which enables performance optimizations when all rows belong in only one partition or in only one subscription. partition_options est de type tinyintet peut prendre l’une des valeurs suivantes.partition_options is tinyint, and can be one of the following values.

ValueValue DescriptionDescription
0 (valeur par défaut)0 (default) Le filtrage de l’article est statique ou ne génère pas un sous-ensemble unique de données pour chaque partition, c’est-à-dire une partition «qui se chevauche».The filtering for the article either is static or does not yield a unique subset of data for each partition, that is, an "overlapping" partition.
11 Les partitions se chevauchent, et les mises à jour DML (langage de manipulation des données) effectuées sur l'abonné ne peuvent pas modifier la partition à laquelle une ligne appartient.The partitions are overlapping, and data manipulation language (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.

Notes

Si la table source d’un article est déjà publiée dans une autre publication, la valeur de partition_options doit être la même pour les deux articles.If the source table for an article is already published in another publication, then the value of partition_options must be the same for both articles.

[ @processing_order = ] processing_orderIndique l’ordre de traitement des articles dans une publication de fusion.[ @processing_order = ] processing_order Indicates the processing order of articles in a merge publication. processing_order est de type int, avec 0 comme valeur par défaut.processing_order is int, with a default of 0. 0 indique que l’article n’est pas ordonné, et toute autre valeur représente la valeur ordinale de l’ordre de traitement pour cet article.0 specifies that the article is unordered, and any other value represents the ordinal value of the processing order for this article. Les articles sont traités à partir de la valeur la plus faible vers la valeur la plus élevée.Articles are processed in order from lowest to highest value. Si deux articles ont la même valeur, l’ordre de traitement est déterminé par l’ordre du surnom de l’article dans la table système sysmergearticles .If two articles have the same value, processing order is determined by the order of the article nickname in the sysmergearticles system table. Pour plus d’informations, consultez Spécifier les propriétés de la réplication de fusion.For more information, see Specify Merge Replication properties.

[ @subscriber_upload_options = ] subscriber_upload_optionsDéfinit des restrictions sur les mises à jour effectuées sur un abonné avec un abonnement client.[ @subscriber_upload_options = ] subscriber_upload_options Defines restrictions on updates made at a Subscriber with a client subscription. Pour plus d’informations, consultez Optimiser les performances de la réplication de fusion avec les articles en téléchargement seul.For more information, see Optimize Merge Replication Performance with Download-Only Articles. subscriber_upload_options est de type tinyintet peut prendre l’une des valeurs suivantes.subscriber_upload_options is tinyint, and can be one of the following values.

ValueValue DescriptionDescription
0 (valeur par défaut)0 (default) Aucune restriction.No restrictions. Les modifications sur l'abonné sont téléchargées par le serveur de publication.Changes made at the Subscriber are uploaded to the Publisher.
11 Les modifications sont autorisées sur l'abonné, mais elles ne sont pas téléchargées sur le serveur de publication.Changes are allowed at the Subscriber, but they are not uploaded to the Publisher.
22 Les modifications ne sont pas autorisées sur l'abonné.Changes are not allowed at the Subscriber.

La modification de subscriber_upload_options nécessite la réinitialisation de l’abonnement en appelant SP_REINITMERGEPULLSUBSCRIPTION (Transact)-SQL.Changing subscriber_upload_options requires the subscription to be reinitialized by calling sp_reinitmergepullsubscription (Transact-SQL).

Notes

Si la table source d’un article est déjà publiée dans une autre publication, la valeur de subscriber_upload_options doit être la même pour les deux articles.If the source table for an article is already published in another publication, the value of subscriber_upload_options must be the same for both articles.

[ @identityrangemanagementoption = ] identityrangemanagementoptionSpécifie comment la gestion des plages d’identité est gérée pour l’article.[ @identityrangemanagementoption = ] identityrangemanagementoption Specifies how identity range management is handled for the article. identityrangemanagementoption est de type nvarchar (10) et peut prendre l’une des valeurs suivantes.identityrangemanagementoption is nvarchar(10), and can be one of the following values.

ValueValue DescriptionDescription
Nonenone Désactive la gestion des plages d’identité.Disables identity range management.
manualmanual Marque la colonne d'identité en utilisant NOT FOR REPLICATION pour activer la gestion manuelle des plages d'identité.Marks the identity column using NOT FOR REPLICATION to enable manual identity range handling.
autoauto Spécifie la gestion automatique des plages d'identité.Specifies automatic management of identity ranges.
NULL (valeur par défaut)NULL(default) La valeur par défaut est Nonelorsque la valeur de auto_identity_range n’est pas true.Defaults to nonewhen the value of auto_identity_range is not true.

Pour la compatibilité descendante, lorsque la valeur de identityrangemanagementoption est null, la valeur de auto_identity_range est vérifiée.For backward compatibility, when the value of identityrangemanagementoption is NULL, the value of auto_identity_range is checked. Toutefois, lorsque la valeur de identityrangemanagementoption n’est pas null, la valeur de auto_identity_range est ignorée.However, when the value of identityrangemanagementoption is not NULL, then the value of auto_identity_range is ignored. Pour plus d’informations, consultez Répliquer des colonnes d’identité.For more information, see Replicate Identity Columns.

[ @delete_tracking = ] 'delete_tracking'Indique si les suppressions sont répliquées.[ @delete_tracking = ] 'delete_tracking' Indicates whether deletes are replicated. delete_tracking est de type nvarchar (5) , avec true comme valeur par défaut.delete_tracking is nvarchar(5), with a default of TRUE. false indique que les suppressions ne sont pas répliquées et true indique que les suppressions sont répliquées, ce qui correspond au comportement habituel pour la réplication de fusion.false indicates that deletes are not replicated, and true indicates that deletes are replicated, which is the usual behavior for merge replication. Lorsque delete_tracking est défini sur false, les lignes supprimées sur l’abonné doivent être supprimées manuellement sur le serveur de publication, et les lignes supprimées sur le serveur de publication doivent être supprimées manuellement sur l’abonné.When delete_tracking is set to false, rows deleted at the Subscriber must be manually removed at the Publisher, and rows deleted at the Publisher must be manually removed at the Subscriber.

Important

La définition de delete_tracking sur false entraîne une non-convergence.Setting delete_tracking to false results in non-convergence. Si la table source d’un article est déjà publiée dans une autre publication, la valeur de delete_tracking doit être la même pour les deux articles.If the source table for an article is already published in another publication, then the value of delete_tracking must be the same for both articles.

Notes

les options delete_tracking ne peuvent pas être définies à l’aide de l' Assistant Nouvelle publication ou de la boîte de dialogue Propriétés de la publication .delete_tracking options cannot be set using the New Publication Wizard or the Publication Properties dialog box.

[ @compensate_for_errors = ] 'compensate_for_errors'Indique si des actions de compensation sont effectuées lorsque des erreurs sont rencontrées pendant la synchronisation.[ @compensate_for_errors = ] 'compensate_for_errors' Indicates if compensating actions are taken when errors are encountered during synchronization. compensate_for_errors is nvarchar (5) , avec false comme valeur par défaut.compensate_for_errors is nvarchar(5), with a default of FALSE. Quand la valeur est true, les modifications qui ne peuvent pas être appliquées sur un abonné ou un serveur de publication pendant la synchronisation entraînent toujours des actions de compensation pour annuler la modification. Toutefois, un abonné configuré de façon incorrecte qui génère une erreur peut entraîner l’annulation des modifications apportées aux autres abonnés et aux serveurs de publication.When set to true, changes that cannot be applied at a Subscriber or Publisher during synchronization always lead to compensating actions to undo the change; however, one incorrectly configured Subscriber that generates an error can cause changes at other Subscribers and Publishers to be undone. la valeur false désactive ces actions de compensation. Toutefois, les erreurs sont toujours enregistrées comme avec la compensation, et les fusions suivantes continuent à tenter d’appliquer les modifications jusqu’à la réussite.false disables these compensating actions, however, the errors are still logged as with compensation and subsequent merges continues to attempt to apply the changes until successful.

Important

Bien que les données des lignes affectées puissent sembler être hors de convergence, dès que vous résolvez une erreur, des modifications peuvent être appliquées et les données convergent.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 d’un article est déjà publiée dans une autre publication, la valeur de compensate_for_errors doit être la même 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.

[ @stream_blob_columns = ] 'stream_blob_columns'Spécifie qu’une optimisation de flux de données doit être utilisée lors de la réplication de colonnes d’objets binaires volumineux.[ @stream_blob_columns = ] 'stream_blob_columns' Specifies that a data stream optimization be used when replicating binary large object columns. stream_blob_columns est de type nvarchar (5) , avec false comme valeur par défaut.stream_blob_columns is nvarchar(5), with a default of FALSE. true signifie que l’optimisation sera tentée.true means that the optimization will be attempted. 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 le streaming d’objets BLOB, utilisez sp_changemergearticle pour affecter à stream_blob_columns la valeur false.To force FILESTREAM table articles to not use blob streaming, use sp_changemergearticle to set stream_blob_columns to false.

Important

L'activation de cette optimisation de mémoire peut réduire les performances de l'Agent de fusion pendant la synchronisation.Enabling this memory optimization may reduce 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.

Notes

Certaines fonctionnalités de réplication de fusion, telles que les enregistrements logiques, peuvent toujours empêcher l’utilisation de l’optimisation de flux lors de la réplication d’objets binaires volumineux, même si stream_blob_columns est défini sur true.Certain merge replication functionalities, such as logical records, can still prevent the stream optimization from being used when replicating binary large objects even with stream_blob_columns set to true.

Valeurs des codes de retourReturn Code Values

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

NotesRemarks

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

Lorsque vous publiez des objets, leurs définitions sont copiées sur les abonnés.When you publish objects, their definitions are copied to Subscribers. Si vous publiez un objet de base de données qui dépend d'un ou de plusieurs autres objets, vous devez publier tous les objets référencés.If you are publishing a database object that depends on one or more other objects, you must publish all referenced objects. Par exemple, si vous publiez une vue qui dépend d'une table, vous devez publier la table également.For example, if you publish a view that depends on a table, you must publish the table also.

Si vous spécifiez la valeur 3 pour partition_options, il ne peut y avoir qu’un seul abonnement pour chaque partition de données de cet article.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.

Lorsque vous spécifiez la valeur 3 pour partition_options, les métadonnées sont nettoyées chaque fois que le 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 Snapshots for Merge Publications with Parameterized Filters.For more information, see Snapshots for Merge Publications with Parameterized Filters.

L’ajout d’un article avec un filtre horizontal statique, à l’aide de subset_filterclause, à une publication existante avec des Articles avec des filtres paramétrés, nécessite la réinitialisation des abonnements.Adding an article with a static horizontal filter, using subset_filterclause, to an existing publication with articles that have parameterized filters requires the subscriptions be reinitialized.

Lorsque vous spécifiez processing_order, nous vous recommandons de laisser des écarts entre les valeurs d’ordre des articles, ce qui facilite la définition de nouvelles valeurs à l’avenir.When specifying processing_order, we recommend leaving gaps between the article order values, which makes it easier to set new values in the future. Par exemple, si vous avez trois articles article1, article2 et article3, définissez processing_order sur 10, 20 et 30, plutôt que 1, 2 et 3.For example, if you have three articles Article1, Article2, and Article3, set processing_order to 10, 20, and 30, rather than 1, 2, and 3. Pour plus d’informations, consultez Spécifier les propriétés de la réplication de fusion.For more information, see Specify Merge Replication properties.

Tableau des options de schéma par défautDefault Schema Option Table

Ce tableau décrit la valeur par défaut définie par la procédure stockée si une valeur NULL est spécifiée pour schema_option, qui dépend du type de l’article.This table describes the default value that is set by the stored procedure if a NULL value is specified for schema_option, which depends on article type.

Type de l'articleArticle type Valeur de l'option de schémaSchema option value
schéma Func uniquementfunc schema only 0x010x01
schéma de vue indexée uniquementindexed view schema only 0x010x01
schéma de procédure uniquementproc schema only 0x010x01
tabletable - publications compatibles 0x0C034FD1SQL Server 2005 (9.x)SQL Server 2005 (9.x) et versions ultérieures avec un instantané en mode natif.0x0C034FD1 - SQL Server 2005 (9.x)SQL Server 2005 (9.x) and later compatible publications with a native mode snapshot.

- publications compatibles 0x08034FF1SQL Server 2005 (9.x)SQL Server 2005 (9.x) et versions ultérieures avec un instantané en mode caractère.0x08034FF1 - SQL Server 2005 (9.x)SQL Server 2005 (9.x) and later compatible publications with a character mode snapshot.
afficher le schéma uniquementview schema only 0x010x01

Notes

Si la publication prend en charge des SQL ServerSQL Serverversions antérieures de, l’option de schéma par défaut pour la table est 0x30034FF1.If the publication supports earlier versions of SQL ServerSQL Server, the default schema option for table is 0x30034FF1.

Tableau des options de schéma validesValid Schema Option Table

Le tableau suivant décrit les valeurs autorisées de schema_option en fonction du type de l’article.The following table describes the allowed values schema_option depending on article type.

Type de l'articleArticle type Valeurs de l'option de schémaSchema option values
schéma Func uniquementfunc schema only 0x01 et 0x20000x01 and 0x2000
schéma de vue indexée uniquementindexed view schema only 0x01, 0x040, 0x0100, 0x2000, 0x40000, 0x1000000et 0x2000000x01, 0x040, 0x0100, 0x2000, 0x40000, 0x1000000, and 0x200000
schéma de procédure uniquementproc schema only 0x01 et 0x20000x01 and 0x2000
tabletable Toutes les options.All options.
afficher le schéma uniquementview schema only 0x01, 0x040, 0x0100, 0x2000, 0x40000, 0x1000000et 0x2000000x01, 0x040, 0x0100, 0x2000, 0x40000, 0x1000000, and 0x200000

ExempleExample

DECLARE @publication AS sysname;
DECLARE @table1 AS sysname;
DECLARE @table2 AS sysname;
DECLARE @table3 AS sysname;
DECLARE @salesschema AS sysname;
DECLARE @hrschema AS sysname;
DECLARE @filterclause AS nvarchar(1000);
SET @publication = N'AdvWorksSalesOrdersMerge'; 
SET @table1 = N'Employee'; 
SET @table2 = N'SalesOrderHeader'; 
SET @table3 = N'SalesOrderDetail'; 
SET @salesschema = N'Sales';
SET @hrschema = N'HumanResources';
SET @filterclause = N'Employee.LoginID = HOST_NAME()';

-- Add a filtered article for the Employee table.
EXEC sp_addmergearticle 
  @publication = @publication, 
  @article = @table1, 
  @source_object = @table1, 
  @type = N'table', 
  @source_owner = @hrschema,
  @schema_option = 0x0004CF1,
  @description = N'article for the Employee table',
  @subset_filterclause = @filterclause;

-- Add an article for the SalesOrderHeader table that is filtered
-- based on Employee and horizontally filtered.
EXEC sp_addmergearticle 
  @publication = @publication, 
  @article = @table2, 
  @source_object = @table2, 
  @type = N'table', 
  @source_owner = @salesschema, 
  @vertical_partition = N'true',
  @schema_option = 0x0034EF1,
  @description = N'article for the SalesOrderDetail table';

-- Add an article for the SalesOrderDetail table that is filtered
-- based on SaledOrderHeader.
EXEC sp_addmergearticle 
  @publication = @publication, 
  @article = @table3, 
  @source_object = @table3, 
  @source_owner = @salesschema,
  @description = 'article for the SalesOrderHeader table', 
  @identityrangemanagementoption = N'auto', 
  @pub_identity_range = 100000, 
  @identity_range = 100, 
  @threshold = 80,
  @schema_option = 0x0004EF1;

-- Add all columns to the SalesOrderHeader article.
EXEC sp_mergearticlecolumn 
  @publication = @publication, 
  @article = @table2, 
  @force_invalidate_snapshot = 1, 
  @force_reinit_subscription = 1;

-- Remove the credit card Approval Code column.
EXEC sp_mergearticlecolumn 
  @publication = @publication, 
  @article = @table2, 
  @column = N'CreditCardApprovalCode', 
  @operation = N'drop', 
  @force_invalidate_snapshot = 1, 
  @force_reinit_subscription = 1;

-- Add a merge join filter between Employee and SalesOrderHeader.
EXEC sp_addmergefilter 
  @publication = @publication, 
  @article = @table2, 
  @filtername = N'SalesOrderHeader_Employee', 
  @join_articlename = @table1, 
  @join_filterclause = N'Employee.BusinessEntityID = SalesOrderHeader.SalesPersonID', 
  @join_unique_key = 1, 
  @filter_type = 1, 
  @force_invalidate_snapshot = 1, 
  @force_reinit_subscription = 1;

-- Add a merge join filter between SalesOrderHeader and SalesOrderDetail.
EXEC sp_addmergefilter 
  @publication = @publication, 
  @article = @table3, 
  @filtername = N'SalesOrderDetail_SalesOrderHeader', 
  @join_articlename = @table2, 
  @join_filterclause = N'SalesOrderHeader.SalesOrderID = SalesOrderDetail.SalesOrderID', 
  @join_unique_key = 1, 
  @filter_type = 1, 
  @force_invalidate_snapshot = 1, 
  @force_reinit_subscription = 1;
GO

AutorisationsPermissions

Nécessite l’appartenance au rôle de serveur fixe sysadmin ou au rôle de base de données fixe db_owner .Requires membership in the sysadmin fixed server role or the db_owner fixed database role.

Voir aussiSee Also

Define an Article Define an Article
Publier des données et des objets de base de données Publish Data and Database Objects
Répliquer les colonnes d’identité Replicate Identity Columns
sp_changemergearticle (Transact-SQL) sp_changemergearticle (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)