sp_addarticle (Transact-SQL)sp_addarticle (Transact-SQL)

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

Crée un article et l'ajoute à une publication.Creates an article and adds it to a 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_addarticle [ @publication = ] 'publication'   
        , [ @article = ] 'article'   
    [ , [ @source_table = ] 'source_table' ]  
    [ , [ @destination_table = ] 'destination_table' ]   
    [ , [ @vertical_partition = ] 'vertical_partition' ]   
    [ , [ @type = ] 'type' ]   
    [ , [ @filter = ] 'filter' ]   
    [ , [ @sync_object= ] 'sync_object' ]   
        [ , [ @ins_cmd = ] 'ins_cmd' ]   
    [ , [ @del_cmd = ] 'del_cmd' ]   
        [ , [ @upd_cmd = ] 'upd_cmd' ]   
    [ , [ @creation_script = ] 'creation_script' ]   
    [ , [ @description = ] 'description' ]   
    [ , [ @pre_creation_cmd = ] 'pre_creation_cmd' ]   
    [ , [ @filter_clause = ] 'filter_clause' ]   
    [ , [ @schema_option = ] schema_option ]   
    [ , [ @destination_owner = ] 'destination_owner' ]   
    [ , [ @status = ] status ]   
    [ , [ @source_owner = ] 'source_owner' ]   
    [ , [ @sync_object_owner = ] 'sync_object_owner' ]   
    [ , [ @filter_owner = ] 'filter_owner' ]   
    [ , [ @source_object = ] 'source_object' ]   
    [ , [ @artid = ] article_ID  OUTPUT ]   
    [ , [ @auto_identity_range = ] 'auto_identity_range' ]   
    [ , [ @pub_identity_range = ] pub_identity_range ]   
    [ , [ @identity_range = ] identity_range ]   
    [ , [ @threshold = ] threshold ]   
    [ , [ @force_invalidate_snapshot = ] force_invalidate_snapshot ]  
    [ , [ @use_default_datatypes = ] use_default_datatypes  
    [ , [ @identityrangemanagementoption = ] identityrangemanagementoption ]  
    [ , [ @publisher = ] 'publisher' ]  
    [ , [ @fire_triggers_on_snapshot = ] 'fire_triggers_on_snapshot' ]   

ArgumentsArguments

[ @publication = ] 'publication'Nom de la publication qui contient l’article.[ @publication = ] 'publication' Is the name of the publication that contains the article. Le nom doit être unique dans la base de données.The name must be unique in the database. 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.

[ @source_table = ] 'source_table'Ce paramètre est déconseillé; Utilisez à la place source_object .[ @source_table = ] 'source_table' This parameter has been deprecated; use source_object instead.

Ce paramètre n’est pas pris en charge pour les serveurs de publication Oracle.This parameter is not supported for Oracle Publishers.

[ @destination_table = ] 'destination_table'Nom de la table de destination (abonnement), s’il est différent de table_sourceou de la procédure stockée.[ @destination_table = ] 'destination_table' Is the name of the destination (subscription) table, if different from source_tableor the stored procedure. destination_table est de type sysname, avec NULL comme valeur par défaut, ce qui signifie que table_source est égal à *destination_table * .destination_table is sysname, with a default of NULL, which means that source_table equals destination_table**.

[ @vertical_partition = ] 'vertical_partition'Active et désactive le filtrage de colonne sur un article de table.[ @vertical_partition = ] 'vertical_partition' Enables and disables column filtering on a table article. vertical_partition est de valeur nchar (5) , avec false comme valeur par défaut.vertical_partition is nchar(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 de la clé primaire déclarée, des colonnes Nullable sans valeur par défaut et des colonnes clés uniques.true clears all columns except the declared primary key, nullable columns with no default, and unique key columns. Les colonnes sont ajoutées à l’aide de sp_articlecolumn.Columns are added using sp_articlecolumn.

[ @type = ] 'type'Est le type d’article.[ @type = ] 'type' Is the type of article. type est de type sysnameet peut prendre l’une des valeurs suivantes.type is sysname, and can be one of the following values.

ValueValue DescriptionDescription
schéma d’agrégation uniquementaggregate schema only Fonction d'agrégation avec schéma uniquementAggregate function with schema only.
schéma Func uniquementfunc schema only Fonction avec schéma uniquement.Function with schema only.
vue indexée logbasedindexed view logbased Article de vue indexée reposant sur un journal.Log-based indexed view article. Non pris en charge pour les serveurs de publication Oracle.Not supported for Oracle Publishers. Pour ce type d'article, il n'est pas nécessaire de publier la table de base séparément.For this type of article, the base table does not need to be published separately.
vue indexée logbased manualbothindexed view logbased manualboth Article de vue indexée reposant sur un journal avec filtre manuel et vue manuelle.Log-based indexed view article with manual filter and manual view. Cette option requiert que vous spécifiiez à la fois les paramètres sync_object et Filter .This option requires that you specify both sync_object and filter parameters. Pour ce type d'article, il n'est pas nécessaire de publier la table de base séparément.For this type of article, the base table does not need to be published separately. Non pris en charge pour les serveurs de publication Oracle.Not supported for Oracle Publishers.
vue indexée logbased manualfilterindexed view logbased manualfilter Article de vue indexée reposant sur un journal avec filtre manuel.Log-based indexed view article with manual filter. Cette option requiert que vous spécifiiez à la fois les paramètres sync_object et Filter .This option requires that you specify both sync_object and filter parameters. Pour ce type d'article, il n'est pas nécessaire de publier la table de base séparément.For this type of article, the base table does not need to be published separately. Non pris en charge pour les serveurs de publication Oracle.Not supported for Oracle Publishers.
vue indexée logbased manualviewindexed view logbased manualview Article de vue indexée reposant sur un journal avec vue manuelle.Log-based indexed view article with manual view. Cette option requiert que vous spécifiiez le paramètre sync_object .This option requires that you specify the sync_object parameter. Pour ce type d'article, il n'est pas nécessaire de publier la table de base séparément.For this type of article, the base table does not need to be published separately. Non pris en charge pour les serveurs de publication Oracle.Not supported for Oracle Publishers.
schéma de vue indexée uniquementindexed view schema only Vue indexée avec schéma uniquement.Indexed view with schema only. Pour ce type d'article, la table de base doit également être publiée.For this type of article, the base table must also be published.
logbased valeurslogbased (default) Article basé sur le journal.Log-based article.
logbased manualbothlogbased manualboth Article reposant sur un journal, avec filtre manuel et vue manuelle.Log-based article with manual filter and manual view. Cette option requiert que vous spécifiiez à la fois les paramètres sync_object et Filter .This option requires that you specify both sync_object and filter parameters. Non pris en charge pour les serveurs de publication Oracle.Not supported for Oracle Publishers.
logbased manualfilterlogbased manualfilter Article reposant sur un journal, avec filtre manuel.Log-based article with manual filter. Cette option requiert que vous spécifiiez à la fois les paramètres sync_object et Filter .This option requires that you specify both sync_object and filter parameters. Non pris en charge pour les serveurs de publication Oracle.Not supported for Oracle Publishers.
logbased manualviewlogbased manualview Article reposant sur un journal, avec vue manuelle.Log-based article with manual view. Cette option requiert que vous spécifiiez le paramètre sync_object .This option requires that you specify the sync_object parameter. Non pris en charge pour les serveurs de publication Oracle.Not supported for Oracle Publishers.
proc execproc exec Réplique l'exécution de la procédure stockée pour tous les abonnés de l'article.Replicates the execution of the stored procedure to all Subscribers of the article. Non pris en charge pour les serveurs de publication Oracle.Not supported for Oracle Publishers. Nous vous recommandons d’utiliser l’option ProCable proc exec au lieu de proc exec.We recommend that you use the option serializable proc exec instead of proc exec. Pour plus d’informations, consultez la section «types d’articles d’exécution de procédure stockée» dans publication de l’exécution des procédures stockées dans la réplication transactionnelle.For more information, see the section "Types of Stored Procedure Execution Articles" in Publishing Stored Procedure Execution in Transactional Replication. Non disponible lorsque la capture de données modifiées est activée.Not available when change data capture is enabled.
schéma de procédure uniquementproc schema only Procédure avec schéma uniquement.Procedure with schema only. Non pris en charge pour les serveurs de publication Oracle.Not supported for Oracle Publishers.
ProCable proc execserializable proc exec Réplique l'exécution de la procédure stockée uniquement si l'exécution se fait dans le contexte d'une transaction compatible avec la mise en série.Replicates the execution of the stored procedure only if it is executed within the context of a serializable transaction. Non pris en charge pour les serveurs de publication Oracle.Not supported for Oracle Publishers.

La procédure doit également être exécutée dans une transaction explicite pour que l’exécution de la procédure soit répliquée.The procedure also must be executed inside an explicit transaction for the procedure execution to be replicated.
afficher le schéma uniquementview schema only Vue avec schéma uniquement.View with schema only. Non pris en charge pour les serveurs de publication Oracle.Not supported for Oracle Publishers. Lorsque vous utilisez cette option, vous devez aussi publier la table de base.When using this option, you must also publish the base table.

[ @filter = ] 'filter'Procédure stockée (créée avec FOR Replication) utilisée pour filtrer la table horizontalement.[ @filter = ] 'filter' Is the stored procedure (created with FOR REPLICATION) used to filter the table horizontally. Filter est de type nvarchar (386) , avec NULL comme valeur par défaut.filter is nvarchar(386), with a default of NULL. sp_articleview et sp_articlefilter doivent être exécutés manuellement pour créer la vue et la procédure stockée de filtre.sp_articleview and sp_articlefilter must be executed manually to create the view and filter stored procedure. Si la valeur par défaut n'est pas NULL, la procédure de filtre n'est pas créée (cela suppose que la procédure stockée est créée manuellement).If not NULL, the filter procedure is not created (assumes the stored procedure is created manually).

[ @sync_object = ] 'sync_object'Nom de la table ou de la vue utilisée pour produire le fichier de données utilisé pour représenter l’instantané de cet article.[ @sync_object = ] 'sync_object' Is the name of the table or view used for producing the data file used to represent the snapshot for this article. sync_object est de type nvarchar (386) , avec NULL comme valeur par défaut.sync_object is nvarchar(386), with a default of NULL. Si la valeur est NULL, sp_articleview est appelé pour créer automatiquement la vue utilisée pour générer le fichier de sortie.If NULL, sp_articleview is called to automatically create the view used to generate the output file. Cela se produit après l’ajout de toute colonne avec sp_articlecolumn.This occurs after adding any columns with sp_articlecolumn. Si la valeur par défaut n'est pas NULL, aucune vue n'est créée (cela suppose que la vue est créée manuellement).If not NULL, a view is not created (assumes the view is manually created).

[ @ins_cmd = ] 'ins_cmd'Type de commande de réplication utilisé lors de la réplication d’insertions pour cet article.[ @ins_cmd = ] 'ins_cmd' Is the replication command type used when replicating inserts for this article. ins_cmd est de type nvarchar (255) et peut prendre l’une des valeurs suivantes.ins_cmd is nvarchar(255), and can be one of the following values.

ValueValue DescriptionDescription
NONENONE Aucune action n'est effectuée.No action is taken.
APPELER sp_MSins_CALL sp_MSins_
table (default)table (default)

ou-or-

APPELER custom_stored_procedure_nameCALL custom_stored_procedure_name
Appelle l'exécution d'une procédure stockée sur l'Abonné.Calls a stored procedure to be executed at the Subscriber. Pour utiliser cette méthode de réplication, utilisez schema_option pour spécifier la création automatique de la procédure stockée, ou créez la procédure stockée spécifiée dans la base de données de destination de chaque abonné de l’article.To use this method of replication, use schema_option to specify automatic creation of the stored procedure, or create the specified stored procedure in the destination database of each Subscriber of the article. custom_stored_procedure est le nom d’une procédure stockée créée par l’utilisateur.custom_stored_procedure is the name of a user-created stored procedure. latable sp_Msins_ contient le nom de la table de destination à la place de la partie _table du paramètre.sp_MSins_table contains the name of the destination table in place of the _table part of the parameter. Quand destination_owner est spécifié, il est ajouté au nom de la table de destination.When destination_owner is specified, it is prepended to the destination table name. Par exemple, pour la table ProductCategory appartenant au schéma de production sur l’abonné, le CALL sp_MSins_ProductionProductCategoryparamètre serait.For example, for the ProductCategory table owned by the Production schema at the Subscriber, the parameter would be CALL sp_MSins_ProductionProductCategory. Pour un article d’une topologie de réplication d’égal à égal, _table est ajouté avec une valeur Guid.For an article in a peer-to-peer replication topology, _table is appended with a GUID value. La spécification de custom_stored_procedure n’est pas prise en charge pour la mise à jour des abonnés.Specifying custom_stored_procedure is not supported for updating subscribers.
SQL ou nullSQL or NULL Réplique une instruction INSERT.Replicates an INSERT statement. Des valeurs sont fournies pour l'instruction INSERT pour l'ensemble des colonnes publiées dans l'article.The INSERT statement is provided values for all columns published in the article. La commande suivante est répliquée lors des insertions :This command is replicated on inserts:

INSERT INTO <table name> VALUES (c1value, c2value, c3value, ..., cnvalue)

Pour plus d’informations, consultez Spécifier le mode de propagation des modifications des articles transactionnels.For more information, see Specify How Changes Are Propagated for Transactional Articles.

[ @del_cmd = ] 'del_cmd'Type de commande de réplication utilisé lors de la réplication des suppressions pour cet article.[ @del_cmd = ] 'del_cmd' Is the replication command type used when replicating deletes for this article. del_cmd est de type nvarchar (255) et peut prendre l’une des valeurs suivantes.del_cmd is nvarchar(255), and can be one of the following values.

ValueValue DescriptionDescription
NONENONE Aucune action n'est effectuée.No action is taken.
CALLsp_MSdel_CALLsp_MSdel_
table (default)table (default)

ou-or-

APPELER custom_stored_procedure_nameCALL custom_stored_procedure_name
Appelle l'exécution d'une procédure stockée sur l'Abonné.Calls a stored procedure to be executed at the Subscriber. Pour utiliser cette méthode de réplication, utilisez schema_option pour spécifier la création automatique de la procédure stockée, ou créez la procédure stockée spécifiée dans la base de données de destination de chaque abonné de l’article.To use this method of replication, use schema_option to specify automatic creation of the stored procedure, or create the specified stored procedure in the destination database of each Subscriber of the article. custom_stored_procedure est le nom d’une procédure stockée créée par l’utilisateur.custom_stored_procedure is the name of a user-created stored procedure. latable sp_Msdel_ contient le nom de la table de destination à la place de la partie _table du paramètre.sp_MSdel_table contains the name of the destination table in place of the _table part of the parameter. Quand destination_owner est spécifié, il est ajouté au nom de la table de destination.When destination_owner is specified, it is prepended to the destination table name. Par exemple, pour la table ProductCategory appartenant au schéma de production sur l’abonné, le CALL sp_MSdel_ProductionProductCategoryparamètre serait.For example, for the ProductCategory table owned by the Production schema at the Subscriber, the parameter would be CALL sp_MSdel_ProductionProductCategory. Pour un article d’une topologie de réplication d’égal à égal, _table est ajouté avec une valeur Guid.For an article in a peer-to-peer replication topology, _table is appended with a GUID value. La spécification de custom_stored_procedure n’est pas prise en charge pour la mise à jour des abonnés.Specifying custom_stored_procedure is not supported for updating subscribers.
XCALL sp_MSdel_XCALL sp_MSdel_
tabletable

ou-or-

XCALL custom_stored_procedure_nameXCALL custom_stored_procedure_name
Appelle une procédure stockée utilisant des paramètres de type XCALL.Calls a stored procedure taking XCALL style parameters. Pour utiliser cette méthode de réplication, utilisez schema_option pour spécifier la création automatique de la procédure stockée, ou créez la procédure stockée spécifiée dans la base de données de destination de chaque abonné de l’article.To use this method of replication, use schema_option to specify automatic creation of the stored procedure, or create the specified stored procedure in the destination database of each Subscriber of the article. La spécification d'une procédure stockée créée par l'utilisateur n'est pas autorisée pour mettre à jour les Abonnés.Specifying a user-created stored procedure is not allowed for updating subscribers.
SQL ou nullSQL or NULL Réplique une instruction DELETE.Replicates a DELETE statement. Toutes les valeurs de colonnes clés primaire sont fournies pour l'instruction DELETE.The DELETE statement is provided all primary key column values. La commande suivante est répliquée lors des suppressions :This command is replicated on deletes:

DELETE FROM <table name> WHERE pkc1 = pkc1value AND pkc2 = pkc2value AND pkcn = pkcnvalue

Pour plus d’informations, consultez Spécifier le mode de propagation des modifications des articles transactionnels.For more information, see Specify How Changes Are Propagated for Transactional Articles.

[ @upd_cmd = ] 'upd_cmd'Type de commande de réplication utilisé lors de la réplication des mises à jour pour cet article.[ @upd_cmd = ] 'upd_cmd' Is the replication command type used when replicating updates for this article. upd_cmd est de type nvarchar (255) et peut prendre l’une des valeurs suivantes.upd_cmd is nvarchar(255), and can be one of the following values.

ValueValue DescriptionDescription
NONENONE Aucune action n'est effectuée.No action is taken.
APPELER sp_MSupd_CALL sp_MSupd_
tabletable

ou-or-

APPELER custom_stored_procedure_nameCALL custom_stored_procedure_name
Appelle l'exécution d'une procédure stockée sur l'Abonné.Calls a stored procedure to be executed at the Subscriber. Pour utiliser cette méthode de réplication, utilisez schema_option pour spécifier la création automatique de la procédure stockée, ou créez la procédure stockée spécifiée dans la base de données de destination de chaque abonné de l’article.To use this method of replication, use schema_option to specify automatic creation of the stored procedure, or create the specified stored procedure in the destination database of each Subscriber of the article.
MCALL sp_MSupd_MCALL sp_MSupd_
tabletable

ou-or-

MCALL custom_stored_procedure_nameMCALL custom_stored_procedure_name
Appelle une procédure stockée utilisant des paramètres de type MCALL.Calls a stored procedure taking MCALL style parameters. Pour utiliser cette méthode de réplication, utilisez schema_option pour spécifier la création automatique de la procédure stockée, ou créez la procédure stockée spécifiée dans la base de données de destination de chaque abonné de l’article.To use this method of replication, use schema_option to specify automatic creation of the stored procedure, or create the specified stored procedure in the destination database of each Subscriber of the article. custom_stored_procedure est le nom d’une procédure stockée créée par l’utilisateur.custom_stored_procedure is the name of a user-created stored procedure. latable sp_Msupd_ contient le nom de la table de destination à la place de la partie _table du paramètre.sp_MSupd_table contains the name of the destination table in place of the _table part of the parameter. Quand destination_owner est spécifié, il est ajouté au nom de la table de destination.When destination_owner is specified, it is prepended to the destination table name. Par exemple, pour la table ProductCategory appartenant au schéma de production sur l’abonné, le MCALL sp_MSupd_ProductionProductCategoryparamètre serait.For example, for the ProductCategory table owned by the Production schema at the Subscriber, the parameter would be MCALL sp_MSupd_ProductionProductCategory. Pour un article d’une topologie de réplication d’égal à égal, _table est ajouté avec une valeur Guid.For an article in a peer-to-peer replication topology, _table is appended with a GUID value. La spécification d'une procédure stockée créée par l'utilisateur n'est pas autorisée pour mettre à jour les Abonnés.Specifying a user-created stored procedure is not allowed for updating subscribers.
SCALabilité sp_MSupd_SCALL sp_MSupd_
table (default)table (default)

ou-or-

SCALabilité custom_stored_procedure_nameSCALL custom_stored_procedure_name
Appelle une procédure stockée utilisant des paramètres de type SCALL.Calls a stored procedure taking SCALL style parameters. Pour utiliser cette méthode de réplication, utilisez schema_option pour spécifier la création automatique de la procédure stockée, ou créez la procédure stockée spécifiée dans la base de données de destination de chaque abonné de l’article.To use this method of replication, use schema_option to specify automatic creation of the stored procedure, or create the specified stored procedure in the destination database of each Subscriber of the article. custom_stored_procedure est le nom d’une procédure stockée créée par l’utilisateur.custom_stored_procedure is the name of a user-created stored procedure. latable sp_Msupd_ contient le nom de la table de destination à la place de la partie _table du paramètre.sp_MSupd_table contains the name of the destination table in place of the _table part of the parameter. Quand destination_owner est spécifié, il est ajouté au nom de la table de destination.When destination_owner is specified, it is prepended to the destination table name. Par exemple, pour la table ProductCategory appartenant au schéma de production sur l’abonné, le SCALL sp_MSupd_ProductionProductCategoryparamètre serait.For example, for the ProductCategory table owned by the Production schema at the Subscriber, the parameter would be SCALL sp_MSupd_ProductionProductCategory. Pour un article d’une topologie de réplication d’égal à égal, _table est ajouté avec une valeur Guid.For an article in a peer-to-peer replication topology, _table is appended with a GUID value. La spécification d'une procédure stockée créée par l'utilisateur n'est pas autorisée pour mettre à jour les Abonnés.Specifying a user-created stored procedure is not allowed for updating subscribers.
XCALL sp_MSupd_XCALL sp_MSupd_
tabletable

ou-or-

XCALL custom_stored_procedure_nameXCALL custom_stored_procedure_name
Appelle une procédure stockée utilisant des paramètres de type XCALL.Calls a stored procedure taking XCALL style parameters. Pour utiliser cette méthode de réplication, utilisez schema_option pour spécifier la création automatique de la procédure stockée, ou créez la procédure stockée spécifiée dans la base de données de destination de chaque abonné de l’article.To use this method of replication, use schema_option to specify automatic creation of the stored procedure, or create the specified stored procedure in the destination database of each Subscriber of the article. La spécification d'une procédure stockée créée par l'utilisateur n'est pas autorisée pour mettre à jour les Abonnés.Specifying a user-created stored procedure is not allowed for updating subscribers.
SQL ou nullSQL or NULL Réplique une instruction UPDATE.Replicates an UPDATE statement. L'instruction UPDATE est fournie pour toutes les valeurs des colonnes et toutes les valeurs de colonne clé primaire.The UPDATE statement is provided on all column values and the primary key column values. La commande ci-dessous est répliquée lors des mises à jour :This command is replicated on updates:

UPDATE <table name> SET c1 = c1value, SET c2 = c2value, SET cn = cnvalue WHERE pkc1 = pkc1value AND pkc2 = pkc2value AND pkcn = pkcnvalue

Notes

Les syntaxes CALL, MCALL, SCALL et XCALL déterminent la quantité de données diffusée à l'abonné.The CALL, MCALL, SCALL, and XCALL syntax vary the amount of data propagated to the subscriber. La syntaxe CALL transmet toutes les valeurs de toutes les colonnes insérées et supprimées.The CALL syntax passes all values for all inserted and deleted columns. La syntaxe SCALL transmet uniquement les valeurs des colonnes affectées.The SCALL syntax passes values only for affected columns. La syntaxe XCALL transmet les valeurs de toutes les colonnes, modifiées ou non, y compris leurs valeurs précédentes.The XCALL syntax passes values for all columns, whether changed or not, including the previous value of the column. Pour plus d’informations, consultez Spécifier le mode de propagation des modifications des articles transactionnels.For more information, see Specify How Changes Are Propagated for Transactional Articles.

[ @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.

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

[ @pre_creation_cmd = ] 'pre_creation_cmd'Spécifie ce que le système doit faire s’il détecte un objet existant portant le même nom sur l’abonné lors de l’application de l’instantané pour cet article.[ @pre_creation_cmd = ] 'pre_creation_cmd' Specifies what the system should do if it detects an existing object of the same name at the subscriber when applying the snapshot for this article. 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 N'utilise pas de commande.Does not use a command.
deletedelete Supprime les données de la table de destination avant d'appliquer l'instantané.Deletes data from the destination table before applying the snapshot. Lorsque l'article est filtré horizontalement, seules les données qui se trouvent dans les colonnes spécifiées par la clause filter sont supprimées.When the article is horizontally filtered, only data in columns specified by the filter clause is deleted. Non pris en charge pour les serveurs de publication Oracle lorsqu'un filtre horizontal est défini.Not supported for Oracle Publishers when a horizontal filter is defined.
supprimer valeursdrop (default) Supprime la table de destination.Drops the destination table.
truncatetruncate Tronque la table de destination.Truncates the destination table. N'est pas valide pour les abonnés ODBC ou OLE DB.Is not valid for ODBC or OLE DB Subscribers.

[ @filter_clause = ] 'filter_clause'Clause de restriction (WHERE) qui définit un filtre horizontal.[ @filter_clause = ] 'filter_clause' Is a restriction (WHERE) clause that defines a horizontal filter. Quand vous entrez la clause de restriction, omettez le mot clé WHERE.When entering the restriction clause, omit the keyword WHERE. filter_clause est de type ntext, avec NULL comme valeur par défaut.filter_clause is ntext, with a default of NULL. Pour plus d’informations, consultez Filtrer des données publiées.For more information, see Filter Published Data.

[ @schema_option = ] schema_optionMasque de masque de l’option de génération de schéma pour l’article donné.[ @schema_option = ] schema_option Is a bitmask 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 des valeurs suivantes:schema_option is binary(8), and can be the | (Bitwise OR) product of one or more of these values:

Notes

Si la valeur est NULL, le système génère automatiquement une option de schéma valide pour l'article en fonction des autres propriétés de l'article.If this value is NULL, the system auto-generates a valid schema option for the article depending on other article properties. Le tableau des options de schéma par défaut indiqué dans les notes affiche la valeur qui sera choisie en fonction de la combinaison du type d’article et du type de réplication.The Default Schema Options table given in the Remarks shows the value that will be chosen based upon the combination of the article type and the replication type.

ValueValue DescriptionDescription
0x000x00 Désactive les scripts par le Agent d’instantané et utilise creation_script.Disables scripting by the Snapshot Agent and uses creation_script.
0x010x01 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). Il s’agit de la valeur par défaut pour les Articles de procédure stockée.This value is the default for stored procedure articles.
0x020x02 Génère les procédures stockées qui propagent les modifications pour l'article, si elles sont définies.Generates the stored procedures that propagate changes for the article, if defined.
0x040x04 Les colonnes d'identité font l'objet d'un script utilisant la propriété IDENTITY.Identity columns are scripted using the IDENTITY property.
0x080x08 Réplique les colonnes timestamp .Replicate timestamp columns. Si la valeur n’est pas définie, les colonnes timestamp sont répliquées au format binaire.If not set, timestamp columns are replicated as binary.
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 uniques 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. Non pris en charge pour les serveurs de publication Oracle.Not supported for Oracle Publishers.
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 uniques 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 de clé primaire.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. Non pris en charge pour les serveurs de publication Oracle.Not supported for Oracle Publishers.
0x2000x200 Réplique les contraintes de clés étrangères.Replicates foreign key constraints. Si la table référencée ne fait pas partie d'une publication, aucune contrainte de clé étrangère 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. Non pris en charge pour les serveurs de publication Oracle.Not supported for Oracle Publishers.
0x4000x400 Réplique les contraintes de vérification.Replicates check constraints. Non pris en charge pour les serveurs de publication Oracle.Not supported for Oracle Publishers.
0x8000x800 Réplique les valeurs par défaut.Replicates defaults. Non pris en charge pour les serveurs de publication Oracle.Not supported for Oracle Publishers.
0x10000x1000 Réplique le classement au niveau des colonnes.Replicates column-level collation.

Remarque : Cette option doit être définie pour les serveurs de publication Oracle afin d’activer les comparaisons sensibles à la casse.Note: This option should be set for Oracle Publishers to enable case-sensitive comparisons.
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. Non pris en charge pour les serveurs de publication Oracle.Not supported for Oracle Publishers.
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 SQL Server 2005 (9.x)SQL Server 2005 (9.x).This option is not valid for SQL Server 2005 (9.x)SQL Server 2005 (9.x) Publishers.
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 Liaisons par défautDefault Bindings
0x8000000x800000 Liaisons de règleRule Bindings
0x10000000x1000000 Index de recherche en texte intégralFull-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 tout schéma non encore présent chez l'abonné.Create 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 les autorisations.Replicate permissions.
to0x80000000 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.
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) supérieurs à 8000 octets en varbinary (max) afin que les colonnes de type UDT puissent être répliquées sur les abonnés SQL Server 2005 (9.x)SQL Server 2005 (9.x)qui exécutent.Converts common language runtime (CLR) user-defined types (UDTs) that are larger than 8000 bytes 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.
0x200000000000x20000000000 Réplique l'attribut SPARSE pour les colonnes.Replicates the SPARSE attribute for columns. Pour plus d’informations sur cet attribut, consultez utiliser des colonnes éparses.For more information about this attribute, see Use Sparse Columns.
0x400000000000x40000000000 Activez l’écriture de scripts par l’agent d’instantané pour créer une table optimisée en mémoire sur l’abonné.Enable scripting by the snapshot agent to create memory-optimized table on the subscriber.
0x800000000000x80000000000 Convertit l’index cluster en index non-cluster pour les articles à mémoire optimisée.Converts clustered index to nonclustered index for memory-optimized articles.
0x4000000000000x400000000000 Réplique tous les index ColumnStore non cluster sur la ou les tablesReplicates any nonclustered columnstore indexes on the table(s)
0x8000000000000x800000000000 Réplique tous les index ColumnStore non cluster flitered sur la ou les tables.Replicates any flitered nonclustered columnstore indexes on the table(s).
NULLNULL La réplication affecte automatiquement à schema_option la valeur par défaut, dont la valeur dépend d’autres propriétés de l’article.Replication automatically sets schema_option to a default value, the value of which depends on other article properties. Le tableau « Options de schéma par défaut » de la section Notes montre les options de schéma par défaut en fonction du type d'article et du type de réplication.The "Default Schema Options" table in the Remarks section shows the default schema options based on article type and replication type.

La valeur par défaut pourSQL ServerSQL Server les publications non-est 0x050D3.The default for non-SQL ServerSQL Server publications is 0x050D3.

Toutes les valeurs schema_option ne sont pas valides pour chaque type de réplication et de type d’article.Not all schema_option values are valid for every type of replication and article type. Le tableau des options de schéma valides de la section Notes montre les options de schéma valides qui peuvent être choisies en fonction de la combinaison du type d’article et du type de réplication.The Valid Schema Options table in the Remarks section shows the valid schema options that can be chosen based upon the combination of the article type and the replication type.

[ @destination_owner = ] 'destination_owner'Nom du propriétaire de l’objet de destination.[ @destination_owner = ] 'destination_owner' Is the name of the owner of the destination object. destination_owner est de type sysname, avec NULL comme valeur par défaut.destination_owner is sysname, with a default of NULL. Quand destination_owner n’est pas spécifié, le propriétaire est spécifié automatiquement en fonction des règles suivantes:When destination_owner is not specified, the owner is specified automatically based on the following rules:

ConditionCondition Propriétaire de l'objet de destinationDestination object owner
La publication utilise la copie en bloc en mode natif pour générer l'instantané initial, qui prend uniquement en charge des Abonnés SQL ServerSQL Server.Publication uses native-mode bulk copy to generate the initial snapshot, which only supports SQL ServerSQL Server Subscribers. La valeur par défaut est source_owner.Defaults to the value of source_owner.
Publié à partir d'un serveur de publication non SQL ServerSQL Server.Published from a non-SQL ServerSQL Server Publisher. Devient par défaut propriétaire de la base de données de destination.Defaults to the owner of the destination database.
La publication utilise la copie en bloc en mode caractère pour générer l'instantané initial, qui prend en charge des Abonnés non SQL ServerSQL Server.Publication uses character-mode bulk copy to generate the initial snapshot, which supports non-SQL ServerSQL Server Subscribers. Non assigné.Not assigned.

Pour prendre en charge SQL ServerSQL Server les abonnés non-, destination_owner doit avoir la valeur null.To support non- SQL ServerSQL Server Subscribers, destination_owner must be NULL.

[ @status = ] statusSpécifie si l’article est actif et des options supplémentaires pour la façon dont les modifications sont propagées.[ @status = ] status Specifies if the article is active and additional options for how changes are propagated. l' État est tinyintet peut être | (Opérateur or au niveau du bit) produit d’une ou plusieurs de ces valeurs.status is tinyint, and can be the | (Bitwise OR) product of one or more of these values.

ValueValue DescriptionDescription
11 Article actifArticle is active.
88 Inclut le nom de colonne dans les instructions INSERT.Includes the column name in INSERT statements.
16 (par défaut)16 (default) Utilise des instructions paramétrables.Uses parameterized statements.
2424 Inclut le nom de colonne dans les instructions INSERT et utilise des instructions paramétrables.Includes the column name in INSERT statements and uses parameterized statements.
6464 Identifié à titre d'information uniquement.Identified for informational purposes only. Non pris en charge.Not supported. La compatibilité future n'est pas garantie.Future compatibility is not guaranteed.

Par exemple, un article actif utilisant des instructions paramétrables posséderait la valeur 17 dans cette colonne.For example, an active article using parameterized statements would have a value of 17 in this column. La valeur 0 signifie que l’article est inactif et qu’aucune propriété supplémentaire n’est définie.A value of 0 means that the article is inactive and no additional properties are defined.

[ @source_owner = ] 'source_owner'Propriétaire de l’objet source.[ @source_owner = ] 'source_owner' Is 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. source_owner doit être spécifié pour les serveurs de publication Oracle.source_owner must be specified for Oracle Publishers.

[ @sync_object_owner = ] 'sync_object_owner'Propriétaire de la vue qui définit l’article publié.[ @sync_object_owner = ] 'sync_object_owner' Is the owner of the view that defines the published article. sync_object_owner est de type sysname, avec NULL comme valeur par défaut.sync_object_owner is sysname, with a default of NULL.

[ @filter_owner = ] 'filter_owner'Propriétaire du filtre.[ @filter_owner = ] 'filter_owner' Is the owner of the filter. filter_owner est de type sysname, avec NULL comme valeur par défaut.filter_owner is sysname, with a default of NULL.

[ @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, avec NULL comme valeur par défaut.source_object is sysname, with a default of NULL. Si table_source a la valeur null, source_object ne peut pas avoir la valeur null. source_object doit être utilisé à la place de table_source.If source_table is NULL, source_object cannot be NULL.source_object should be used instead of source_table. Pour plus d’informations sur les types d’objets qui peuvent être publiés à l’aide de la réplication transactionnelle ou d’instantané, 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 snapshot or transactional replication, see Publish Data and Database Objects.

[ @artid = ] _article_ID_ OUTPUTID d’article du nouvel article.[ @artid = ] _article_ID_ OUTPUT Is the article ID of the new article. article_id est de type int avec NULL comme valeur par défaut et il s’agit d’un paramètre OUTPUT.article_ID is int with a default of NULL, and it is an OUTPUT parameter.

[ @auto_identity_range = ] 'auto_identity_range'Active et désactive la gestion automatique des plages d’identité sur une publication au moment de sa création.[ @auto_identity_range = ] 'auto_identity_range' Enables and disables automatic identity range handling on a publication at the time it is created. auto_identity_range est de type nvarchar (5) et peut prendre l’une des valeurs suivantes:auto_identity_range is nvarchar(5), and can be one of the following values:

ValueValue DescriptionDescription
truetrue Active la gestion automatique des plages d'identitéEnables automatic identity range handling
falsefalse Désactive la gestion automatique des plages d'identitéDisables automatic identity range handling
NULL (valeur par défaut)NULL(default) La gestion des plages d’identité est définie par identityrangemanagementoption.Identity range handling is set by identityrangemanagementoption.

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 sur le serveur de publication si l’article a identityrangemanagementoption défini sur auto ou si auto_identity_range a la valeur true.[ @pub_identity_range = ] pub_identity_range Controls the range size at the Publisher if the article has identityrangemanagementoption set to auto or auto_identity_range set to true. pub_identity_range est de type bigint, avec NULL comme valeur par défaut.pub_identity_range is bigint, with a default of NULL. Non pris en charge pour les serveurs de publication Oracle.Not supported for Oracle Publishers.

[ @identity_range = ] identity_rangeContrôle la taille de la plage sur l’abonné si l’article a identityrangemanagementoption défini sur auto ou si auto_identity_range a la valeur true.[ @identity_range = ] identity_range Controls the range size at the Subscriber if the article has identityrangemanagementoption set to auto or auto_identity_range set to true. identity_range est de type bigint, avec NULL comme valeur par défaut.identity_range is bigint, with a default of NULL. Utilisé lorsque auto_identity_range a la valeur true.Used when auto_identity_range is set to true. Non pris en charge pour les serveurs de publication Oracle.Not supported for Oracle Publishers.

[ @threshold = ] thresholdValeur de pourcentage qui contrôle le moment où l’Agent de distribution affecte une nouvelle plage d’identité.[ @threshold = ] threshold Is the percentage value that controls when the Distribution Agent assigns a new identity range. Lorsque le pourcentage de valeurs spécifié dans seuil est utilisé, la agent de distribution crée une nouvelle plage d’identité.When the percentage of values specified in threshold is used, the Distribution Agent creates a new identity range. Threshold est de type bigint, avec NULL comme valeur par défaut.threshold is bigint, with a default of NULL. Utilisé lorsque identityrangemanagementoption a la valeur auto ou que auto_identity_range a la valeur true.Used when identityrangemanagementoption is set to auto or auto_identity_range is set to true. Non pris en charge pour les serveurs de publication Oracle.Not supported for Oracle Publishers.

[ @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é, un message d'erreur est généré et aucune modification n'est effectuée.If the stored procedure detects that the change requires 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é. si des abonnements nécessitant un nouvel instantané sont nécessaires, 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 subscriptions exist that would require a new snapshot, gives permission for the existing snapshot to be marked as obsolete and a new snapshot to be generated.

[ @use_default_datatypes = ] use_default_datatypesIndique si les mappages de type de données de colonne par défaut sont utilisés lors de la publication d’un article à partir d’un serveur de publication Oracle.[ @use_default_datatypes = ] use_default_datatypes Is whether the default column data type mappings are used when publishing an article from an Oracle Publisher. use_default_datatypes est de bits, avec 1 comme valeur par défaut.use_default_datatypes is bit, with a default of 1.

1 = les mappages de colonne d’article par défaut sont utilisés.1 = the default article column mappings are used. Les mappages de type de données par défaut peuvent être affichés en exécutant sp_getdefaultdatatypemapping.The default data type mappings can be displayed by executing sp_getdefaultdatatypemapping.

0 = les mappages de colonne d’article personnalisés sont définis, et par conséquent, sp_articleview n’est pas appelé par sp_addarticle.0 = custom article column mappings are defined, and therefore sp_articleview is not called by sp_addarticle.

Lorsque use_default_datatypes a la valeur 0, vous devez exécuter sp_changearticlecolumndatatype une fois pour chaque mappage de colonne modifié par rapport à la valeur par défaut.When use_default_datatypes is set to 0, you must execute sp_changearticlecolumndatatype once for each column mapping being changed from the default. Une fois que tous les mappages de colonnes personnalisées ont été définis, vous devez exécuter sp_articleview.After all custom column mappings have been defined, you must execute sp_articleview.

Notes

Ce paramètre ne doit être utilisé que pour les serveurs de publication Oracle.This parameter should only be used for Oracle Publishers. La définition de use_default_datatypes sur 0 pour un SQL ServerSQL Server serveur de publication génère une erreur.Setting use_default_datatypes to 0 for a SQL ServerSQL Server Publisher generates an error.

[ @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 La réplication n'explicite pas la gestion des plages d'identité.Replication does no explicit identity range management. Cette option est recommandée uniquement pour la compatibilité ascendante avec des versions antérieures de SQL Server.This option is recommended only for backwards compatibility with earlier versions of SQL Server. Non autorisé pour la réplication d'homologue.Not allowed for peer replication.
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 None lorsque la valeur de auto_identity_range n’est pas true.Defaults to none when the value of auto_identity_range is not true. La valeur par défaut est Manual dans une topologie d’égal à égal par défaut (auto_identity_range est ignoré).Defaults to manual in a peer-to-peer topology default (auto_identity_range is ignored).

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.

[ @publisher = ] 'publisher'Spécifie un serveur SQL ServerSQL Server de publication non-.[ @publisher = ] 'publisher' Specifies a non- SQL ServerSQL Server Publisher. Publisher est de type sysname, avec NULL comme valeur par défaut.publisher is sysname, with a default of NULL.

Notes

l' éditeur ne doit pas être utilisé lors de l’ajout SQL ServerSQL Server d’un article à un serveur de publication.publisher should not be used when adding an article to a SQL ServerSQL Server Publisher.

[ @fire_triggers_on_snapshot = ] 'fire_triggers_on_snapshot'Indique si les déclencheurs utilisateur répliqués sont exécutés lorsque l’instantané initial est appliqué.[ @fire_triggers_on_snapshot = ] 'fire_triggers_on_snapshot' Is if replicated user triggers are executed when the initial snapshot is applied. fire_triggers_on_snapshot est de type nvarchar (5) , avec false comme valeur par défaut.fire_triggers_on_snapshot is nvarchar(5), with a default of FALSE. true signifie que les déclencheurs utilisateur sur une table répliquée sont exécutés lorsque l’instantané est appliqué.true means that user triggers on a replicated table are executed when the snapshot is applied. Pour que les déclencheurs soient répliqués, la valeur de masque de masque de schema_option doit inclure la valeur 0x100.In order for triggers to be replicated, the bitmask value of schema_option must include the value 0x100.

Valeurs des codes de retourReturn Code Values

0 (succès) ou 1 (échec)0 (success) or 1 (failure)

NotesRemarks

la procédure sp_addarticle est utilisée dans la réplication d’instantané ou dans la réplication transactionnelle.sp_addarticle is used in snapshot replication or transactional replication.

Par défaut, la réplication ne publie aucune colonne dans la table source lorsque le type de données de colonne n'est pas pris en charge par la réplication.By default, replication does not publish any columns in the source table when the column data type is not supported by replication. Si vous devez publier une telle colonne, vous devez exécuter sp_articlecolumn pour ajouter la colonne.If you need to publish such a column, you must execute sp_articlecolumn to add the column.

Lors de l'ajout d'un article à une publication qui prend en charge la réplication transactionnelle d'homologue à homologue, les restrictions suivantes s'appliquent :When adding an article to a publication that supports peer-to-peer transactional replication, the following restrictions apply:

  • Les instructions paramétrables doivent être spécifiées pour tous les articles logbased.Parameterized statements must be specified for all logbased articles. Vous devez inclure 16 dans la valeur d' État .You must include 16 in the status value.

  • Le nom et le propriétaire de la table de destination doivent correspondre à la table source.Name and owner of the destination table must match the source table.

  • Il est impossible de filtrer l'article horizontalement ou verticalement.The article cannot be filtered horizontally or vertically.

  • La gestion automatique des plages d'identité n'est pas prise en charge.Automatic identity range management is not supported. Vous devez spécifier la valeur Manual pour identityrangemanagementoption.You must specify a value of manual for identityrangemanagementoption.

  • S’il existe une colonne timestamp dans la table, vous devez inclure 0x08 dans schema_option pour répliquer la colonne comme timestamp.If a timestamp column exists in the table, you must include 0x08 in schema_option to replicate the column as timestamp.

  • La valeur SQL ne peut pas être spécifiée pour ins_cmd, upd_cmdet del_cmd.A value of SQL cannot be specified for ins_cmd, upd_cmd, and del_cmd.

Pour plus d'informations, consultez Peer-to-Peer Transactional Replication.For more information, see Peer-to-Peer Transactional 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 vertical_partition a la valeur true, sp_addarticle diffère la création de la vue jusqu’à ce que la méthode sp_articleview soit appelée (après l’ajout de la dernière méthode sp_articlecolumn ).If vertical_partition is set to true, sp_addarticle defers the creation of the view until sp_articleview is called (after the last sp_articlecolumn is added).

Si la publication autorise la mise à jour des abonnements et que la table publiée n’a pas de colonne uniqueidentifier , sp_addarticle ajoute automatiquement une colonne uniqueidentifier à la table.If the publication allows updating subscriptions and the published table does not have a uniqueidentifier column, sp_addarticle adds a uniqueidentifier column to the table automatically.

Lors de la réplication vers un abonné qui n’est pas SQL ServerSQL Server une instance de (réplication Transact-SQLTransact-SQL hétérogène), seules les instructions sont prises en charge pour les commandes Insert, Updateet Delete .When replicating to a subscriber that is not an instance of SQL ServerSQL Server (heterogeneous replication), only Transact-SQLTransact-SQL statements are supported for INSERT, UPDATE, and DELETE commands.

Lorsque l'Agent de lecture du journal s'exécute, l'ajout d'un article à une publication d'égal à égal peut provoquer un interblocage entre l'Agent de lecture du journal et le processus qui ajoute l'article.When the log reader agent is running, adding an article to a peer-to-peer publication can cause a deadlock between the log reader agent and the process that adds the article. Pour éviter ce problème, avant d'ajouter un article à une publication d'égal à égal, utilisez le moniteur de réplication afin d'arrêter l'Agent de lecture du journal sur le nœud où vous ajoutez l'article.To avoid this issue, before adding an article to a peer-to-peer publication use the Replication Monitor to stop the log reader agent on the node where you are adding the article. Redémarrez l'Agent de lecture du journal après l'ajout de l'article.Restart the log reader agent after adding the article.

Lorsque vous @del_cmd = 'NONE' définissez @ins_cmd = 'NONE'ou, la propagation des commandes de mise à jour peut également être affectée en n’envoyant pas ces commandes lorsqu’une mise à jour limitée se produit.When setting @del_cmd = 'NONE' or @ins_cmd = 'NONE', the propagation of UPDATE commands might also be affected by not sending those commands when a bounded update occurs. (Une mise à jour associée est un type d'instruction UPDATE du serveur de publication qui réplique comme une paire de DELETE/INSERT sur l'abonné.)(A bounded update is type of UPDATE statement from the publisher that replicates as a DELETE/INSERT pair on the subscriber.)

Options de schéma par défautDefault Schema Options

Ce tableau décrit la valeur par défaut définie par la réplication si schema_options n’est pas spécifié par l’utilisateur, où cette valeur dépend du type de réplication (indiqué en haut) et du type d’article (dans la première colonne).This table describes the default value set by replication if schema_options is not specified by the user, where this value depends on the replication type (shown across the top) and the article type (shown down the first column).

Type de l'articleArticle type Type de réplicationReplication type
TransactionnelleTransactional InstantanéSnapshot
schéma d’agrégation uniquementaggregate schema only 0x010x01 0x010x01
schéma Func uniquementfunc schema only 0x010x01 0x010x01
schéma de vue indexée uniquementindexed view schema only 0x010x01 0x010x01
vue indexée logbasedindexed view logbased 0x30F30x30F3 0x30710x3071
indexed view zone manualbothindexed view logbase manualboth 0x30F30x30F3 0x30710x3071
vue indexée logbased manualfilterindexed view logbased manualfilter 0x30F30x30F3 0x30710x3071
vue indexée logbased manualviewindexed view logbased manualview 0x30F30x30F3 0x30710x3071
logbasedlogbased 0x30F30x30F3 0x30710x3071
logbased manualfilterlogbased manualfilter 0x30F30x30F3 0x30710x3071
logbased manualviewlogbased manualview 0x30F30x30F3 0x30710x3071
proc execproc exec 0x010x01 0x010x01
schéma de procédure uniquementproc schema only 0x010x01 0x010x01
ProCable proc execserializable proc exec 0x010x01 0x010x01
afficher le schéma uniquementview schema only 0x010x01 0x010x01

Notes

Si une publication est activée pour la mise à jour en file d’attente, une valeur schema_option de 0x80 est ajoutée à la valeur par défaut indiquée dans le tableau.If a publication is enabled for queued updating, a schema_option value of 0x80 is added to the default value shown in the table. Le schema_option par défaut pour un non SQL ServerSQL Server -publication est 0x050D3.The default schema_option for a non- SQL ServerSQL Server publication is 0x050D3.

Options de schéma validesValid Schema Options

Ce tableau décrit les valeurs autorisées de schema_option en fonction du type de réplication (affiché en haut) et du type d’article (dans la première colonne).This table describes the allowable values of schema_option based upon the replication type (shown across the top) and the article type (shown down the first column).

Type de l'articleArticle type Type de réplicationReplication type
TransactionnelleTransactional InstantanéSnapshot
logbasedlogbased Toutes les optionsAll options Toutes les options, sauf 0x02All options but 0x02
logbased manualfilterlogbased manualfilter Toutes les optionsAll options Toutes les options, sauf 0x02All options but 0x02
logbased manualviewlogbased manualview Toutes les optionsAll options Toutes les options, sauf 0x02All options but 0x02
vue indexée logbasedindexed view logbased Toutes les optionsAll options Toutes les options, sauf 0x02All options but 0x02
vue indexée logbased manualfilterindexed view logbased manualfilter Toutes les optionsAll options Toutes les options, sauf 0x02All options but 0x02
vue indexée logbased manualviewindexed view logbased manualview Toutes les optionsAll options Toutes les options, sauf 0x02All options but 0x02
indexed view zone manualbothindexed view logbase manualboth Toutes les optionsAll options Toutes les options, sauf 0x02All options but 0x02
proc execproc exec 0x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x40000000et 0x800000000x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x40000000, and 0x80000000 0x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x40000000et 0x800000000x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x40000000, and 0x80000000
ProCable proc execserializable proc exec 0x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x40000000et 0x800000000x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x40000000, and 0x80000000 0x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x40000000et 0x800000000x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x40000000, and 0x80000000
schéma de procédure uniquementproc schema only 0x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x40000000et 0x800000000x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x40000000, and 0x80000000 0x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x40000000et 0x800000000x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x40000000, and 0x80000000
afficher le schéma uniquementview schema only 0x01, 0x010, 0x020, 0x040, 0x0100, 0x2000, 0x40000,, 0x200000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x40000000et 0x800000000x01, 0x010, 0x020, 0x040, 0x0100, 0x2000, 0x40000, 0x100000, 0x200000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x40000000, and 0x80000000 0x01, 0x010, 0x020, 0x040, 0x0100, 0x2000, 0x40000,, 0x200000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x40000000et 0x800000000x01, 0x010, 0x020, 0x040, 0x0100, 0x2000, 0x40000, 0x100000, 0x200000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x40000000, and 0x80000000
schéma Func uniquementfunc schema only 0x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x40000000et 0x800000000x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x40000000, and 0x80000000 0x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x40000000et 0x800000000x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x40000000, and 0x80000000
schéma de vue indexée uniquementindexed view schema only 0x01, 0x010, 0x020, 0x040, 0x0100, 0x2000, 0x40000,, 0x200000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x40000000et 0x800000000x01, 0x010, 0x020, 0x040, 0x0100, 0x2000, 0x40000, 0x100000, 0x200000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x40000000, and 0x80000000 0x01, 0x010, 0x020, 0x040, 0x0100, 0x2000, 0x40000,, 0x200000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x40000000et 0x800000000x01, 0x010, 0x020, 0x040, 0x0100, 0x2000, 0x40000, 0x100000, 0x200000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x40000000, and 0x80000000

Notes

Pour les publications de mise à jour en attente, les valeurs schema_option de 0x8000 et 0x80 doivent être activées.For queued updating publications, the schema_option values of 0x8000 and 0x80 must be enabled. Les valeurs schema_option prises en charge pour SQL ServerSQL Server les publications non-sont les suivantes: 0x01, 0x02, 0x10, 0x40, 0x80, 0x1000, 0x4000 et 0x8000.The supported schema_option values for non- SQL ServerSQL Server publications are: 0x01, 0x02, 0x10, 0x40, 0x80, 0x1000, 0x4000 and 0X8000.

ExempleExample

DECLARE @publication    AS sysname;
DECLARE @table AS sysname;
DECLARE @filterclause AS nvarchar(500);
DECLARE @filtername AS nvarchar(386);
DECLARE @schemaowner AS sysname;
SET @publication = N'AdvWorksProductTran'; 
SET @table = N'Product';
SET @filterclause = N'[DiscontinuedDate] IS NULL'; 
SET @filtername = N'filter_out_discontinued';
SET @schemaowner = N'Production';

-- Add a horizontally and vertically filtered article for the Product table.
-- Manually set @schema_option to ensure that the Production schema 
-- is generated at the Subscriber (0x8000000).
EXEC sp_addarticle 
    @publication = @publication, 
    @article = @table, 
    @source_object = @table,
    @source_owner = @schemaowner, 
    @schema_option = 0x80030F3,
    @vertical_partition = N'true', 
    @type = N'logbased',
    @filter_clause = @filterclause;

-- (Optional) Manually call the stored procedure to create the 
-- horizontal filtering stored procedure. Since the type is 
-- 'logbased', this stored procedures is executed automatically.
EXEC sp_articlefilter 
    @publication = @publication, 
    @article = @table, 
    @filter_clause = @filterclause, 
    @filter_name = @filtername;

-- Add all columns to the article.
EXEC sp_articlecolumn 
    @publication = @publication, 
    @article = @table;

-- Remove the DaysToManufacture column from the article
EXEC sp_articlecolumn 
    @publication = @publication, 
    @article = @table, 
    @column = N'DaysToManufacture', 
    @operation = N'drop';

-- (Optional) Manually call the stored procedure to create the 
-- vertical filtering view. Since the type is 'logbased', 
-- this stored procedures is executed automatically.
EXEC sp_articleview 
    @publication = @publication, 
    @article = @table,
    @filter_clause = @filterclause;
GO

AutorisationsPermissions

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

Voir aussiSee Also

Define an Article Define an Article
sp_articlecolumn (Transact-SQL) sp_articlecolumn (Transact-SQL)
sp_articlefilter (Transact-SQL) sp_articlefilter (Transact-SQL)
sp_articleview (Transact-SQL) sp_articleview (Transact-SQL)
sp_changearticle (Transact-SQL) sp_changearticle (Transact-SQL)
sp_droparticle (Transact-SQL) sp_droparticle (Transact-SQL)
sp_helparticle (Transact-SQL) sp_helparticle (Transact-SQL)
sp_helparticlecolumns (Transact-SQL) sp_helparticlecolumns (Transact-SQL)
Procédures stockées de réplication (Transact-SQL) Replication Stored Procedures (Transact-SQL)
Publier des données et des objets de base de donnéesPublish Data and Database Objects