sp_changearticle (Transact-SQL)sp_changearticle (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

Modifie les propriétés d'un article dans une publication transactionnelle ou d'instantané.Changes the properties of an article in a transactional or snapshot 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_changearticle [ [@publication= ] 'publication' ]  
    [ , [ @article= ] 'article' ]  
    [ , [ @property= ] 'property' ]  
    [ , [ @value= ] 'value' ]  
    [ , [ @force_invalidate_snapshot = ] force_invalidate_snapshot ]  
    [ , [ @force_reinit_subscription = ] force_reinit_subscription ]  
    [ , [ @publisher = ] 'publisher' ]  

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, avec NULL comme valeur par défaut.publication is sysname, with a default of NULL.

[ @article = ] 'article'Nom de l’article dont la propriété doit être modifiée.[ @article = ] 'article' Is the name of the article whose property is to be changed. article est de type sysname, avec NULL comme valeur par défaut.article is sysname, with a default of NULL.

[ @property = ] 'property'Est une propriété d’article à modifier.[ @property = ] 'property' Is an article property to change. la propriété est de type nvarchar (100) .property is nvarchar(100).

[ @value = ] 'value'Nouvelle valeur de la propriété de l’article.[ @value = ] 'value' Is the new value of the article property. la valeur est de type nvarchar (255) .value is nvarchar(255).

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

PropriétéProperty ValeursValues DescriptionDescription
creation_scriptcreation_script Chemin d'accès et nom d'un script de schéma d'article utilisé pour créer des tables cibles.Path and name of an article schema script used to create target tables. La valeur par défaut est NULL.The default is NULL.
del_cmddel_cmd Instruction DELETE à exécuter ; à défaut, elle sera élaborée à partir du journal.DELETE statement to execute; otherwise, it is constructed from the log.
descriptiondescription Nouvelle entrée descriptive de l'article.New descriptive entry for the article.
dest_objectdest_object Fourni pour la compatibilité ascendante.Provided for backward compatibility. Utilisez dest_table.Use dest_table.
dest_tabledest_table Nouvelle table de destination.New destination table.
destination_ownerdestination_owner Nom du propriétaire de l’objet de destination.Name of the owner of the destination object.
filterfilter Nouvelle procédure stockée à utiliser pour filtrer la table (filtrage horizontal).New stored procedure to be used to filter the table (horizontal filtering). La valeur par défaut est NULL.The default is NULL. Ne peut pas être modifié pour les publications dans la réplication d'égal à égal.Cannot be changed for publications in peer-to-peer replication.
fire_triggers_on_snapshotfire_triggers_on_snapshot truetrue Les déclencheurs de l'utilisateur répliqués sont exécutés lorsque l'instantané initial est appliqué.Replicated user triggers are executed when the initial snapshot is applied.

Remarque : Pour que les déclencheurs soient répliqués, la valeur de masque de masque de schema_option doit inclure la valeur 0x100.Note: For triggers to be replicated, the bitmask value of schema_option must include the value 0x100.
falsefalse Les déclencheurs de l'utilisateur répliqués ne sont pas exécutés lorsque l'instantané initial est appliqué.Replicated user triggers are not executed when the initial snapshot is applied.
identity_rangeidentity_range Contrôle la taille des plages d'identité affectées à l'abonné.Controls the size of assigned identity ranges assigned at the Subscriber. Non pris en charge pour la réplication d'égal à égal.Not supported for peer-to-peer replication.
ins_cmdins_cmd Instruction INSERT à exécuter ; à défaut, elle sera élaborée à partir du journal.INSERT statement to execute; otherwise, it is constructed from the log.
pre_creation_cmdpre_creation_cmd Définit une commande de précréation pouvant supprimer, effacer ou tronquer la table de destination avant l'application de la synchronisation.Pre-creation command that can drop, delete, or truncate the destination table before synchronization is applied.
Nonenone N'utilise pas de commande.Does not use a command.
dropdrop Supprime la table de destination.Drops the destination table.
deletedelete Détruit la table de destination.Deletes the destination table.
truncatetruncate Tronque la table de destination.Truncates the destination table.
pub_identity_rangepub_identity_range Contrôle la taille des plages d'identité affectées à l'abonné.Controls the size of assigned identity ranges assigned at the Subscriber. Non pris en charge pour la réplication d'égal à égal.Not supported for peer-to-peer replication.
schema_optionschema_option Spécifie le bitmap de l'option de génération de schéma pour l'article considéré.Specifies the bitmap of the schema generation option for the given article. schema_option est binaire (8) .schema_option is binary(8). Pour plus d’informations, consultez la section Notes, plus loin dans cette rubrique.For more information, see the Remarks section later in this topic.
0x000x00 Désactive les scripts de l'Agent d'instantané.Disables scripting by the Snapshot Agent.
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).
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.
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.
0x800x80 Inclut l'intégrité référentielle déclarée dans les clés primaires.Includes declared referential integrity on the primary keys.
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 clés uniques, si celles-ci sont définies, sur un article de table.Replicates unique keys if defined on a table article.
0x80000x8000 Réplique la clé primaire et les clés uniques sur un article de table sous forme de contraintes, à l'aide d'instructions ALTER TABLE.Replicates primary key and unique keys on a table article as constraints using ALTER TABLE statements.

Remarque : Cette option est dépréciée.Note: This option has been deprecated. Utilisez à la place 0x80 et 0x4000 .Use 0x80 and 0x4000 instead.
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 données pris SQL Server 2000 (8.x)SQL Server 2000 (8.x)en charge sur.Converts large object data types (nvarchar(max), varchar(max), and varbinary(max)) that were 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 datetime2) SQL Server 2008SQL Server 2008 introduits dans en types de données pris en charge SQL ServerSQL Serverdans les versions antérieures de.Converts date and time data types (date, time, datetimeoffset, and datetime2) that were 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 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) 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.
statusstatus Spécifie le nouvel état de la propriété.Specifies the new status of the property.
partitions horizontales Dtsdts horizontal partitions 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.
inclure les noms de colonnesinclude column names Les noms de colonnes sont inclus dans l'instruction INSERT répliquée.Column names are included in the replicated INSERT statement.
aucun nom de colonneno column names Les noms de colonnes ne sont pas inclus dans l'instruction INSERT répliquée.Column names are not included in the replicated INSERT statement.
aucune partition horizontale Dtsno dts horizontal partitions La partition horizontale pour l'article n'est pas définie par un abonnement transformable.The horizontal partition for the article is not defined by a transformable subscription.
Nonenone Efface toutes les options d’état de la table sysarticles et marque l’article comme étant inactif.Clears all status options in the sysarticles table and marks the article as inactive.
parametersparameters Les modifications sont propagées vers l'abonné à l'aide de commandes paramétrables.Changes are propagated to the Subscriber using parameterized commands. Il s'agit du paramètre par défaut pour un nouvel article.This is the default setting for a new article.
littéraux de chaînestring literals Les modifications sont propagées vers l'abonné à l'aide de valeurs littérales de chaîne.Changes are propagated to the Subscriber using string literal values.
sync_objectsync_object Nom de la table ou de la vue utilisée pour produire un fichier de sortie de synchronisation.Name of the table or view used to produce a synchronization output file. La valeur par défaut est NULL.The default is NULL. Non pris en charge pour les serveurs de publication Oracle.Not supported for Oracle Publishers.
tablespacetablespace Identifie l'espace de table utilisé par la table de journalisation pour un article publié à partir d'une base de données Oracle.Identifies the tablespace used by the logging table for an article published from an Oracle database. Pour plus d’informations, consultez Gérer des espaces disque logiques Oracle.For more information, see Manage Oracle Tablespaces.
thresholdthreshold Valeur de pourcentage qui contrôle le moment où l'Agent de distribution affecte une nouvelle plage d'identité.The percentage value that controls when the Distribution Agent assigns a new identity range. Non pris en charge pour la réplication d'égal à égal.Not supported for peer-to-peer replication.
typetype Non pris en charge pour les serveurs de publication Oracle.Not supported for Oracle Publishers.
logbasedlogbased 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 nécessite que les propriétés sync_object et Filter soient également définies.This option requires that the sync_object and filter properties also be set. 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 nécessite que les propriétés sync_object et Filter soient également définies.This option requires that the sync_object and filter properties also be set. 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 la propriété sync_object soit également définie.This option requires that the sync_object property also be set. Non pris en charge pour les serveurs de publication Oracle.Not supported for Oracle Publishers.
viewlogbased indexésindexed viewlogbased 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.
index viewlogbased manualbothindexed viewlogbased 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 nécessite que les propriétés sync_object et Filter soient également définies.This option requires that the sync_object and filter properties also be set. 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.
index viewlogbased manualfilterindexed viewlogbased 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 les propriétés sync_object et Filter soient également définies.This option requires the sync_object and filter properties also be set. 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.
index viewlogbased manualviewindexed viewlogbased 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 la propriété sync_object soit également définie.This option requires that the sync_object property also be set. 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.
upd_cmdupd_cmd Instruction UPDATE à exécuter ; à défaut, elle sera élaborée à partir du journal.UPDATE statement to execute; otherwise, it is constructed from the log.
NULLNULL NULLNULL Renvoie une liste de propriétés d'articles modifiables.Returns a list of article properties that can be changed.

[ @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 0comme valeur par défaut.force_invalidate_snapshot is a bit, with a default of 0.

0 indique que les modifications apportées à l’article n’entraînent pas la non-validité de l’instantané.0 specifies that changes to the article do not cause the snapshot to be invalid. Si la procédure stockée détecte que la modification requiert un nouvel instantané, une erreur se produit et aucune modification n'est effectuée.If the stored procedure detects that the change does require a new snapshot, an error occurs and no changes are made.

1 indique que les modifications apportées à l’article peuvent entraîner la non-validité de l’instantané, et s’il existe des abonnements qui nécessitent un nouvel instantané, donne l’autorisation de marquer l’instantané existant comme obsolète et de générer un nouvel instantané.1 specifies that changes to the article may cause the snapshot to be invalid, and if there are existing subscriptions that would require a new snapshot, gives permission for the existing snapshot to be marked as obsolete and a new snapshot generated.

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

[ @force_reinit_subscription = ]force_reinit_subscription_Confirme 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 0comme valeur par défaut.force_reinit_subscription is a bit with a default of 0.

0 indique que les modifications apportées à l’article n’entraînent pas la réinitialisation de l’abonnement.0 specifies that changes to the article do not cause the subscription to be reinitialized. Si la procédure stockée détecte que la modification nécessite la réinitialisation des abonnements existants, une erreur se produit et aucune modification n'est effectuée.If the stored procedure detects that the change would require existing subscriptions to be reinitialized, an error occurs and no changes are made.

1 indique que les modifications apportées à l’article entraînent la réinitialisation des abonnements existants et autorise la réinitialisation de l’abonnement.1 specifies that changes to the article cause existing subscriptions to be reinitialized, and gives permission for the subscription reinitialization to occur.

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

[ @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 la modification SQL ServerSQL Server des propriétés d’un article sur un serveur de publication.publisher should not be used when changing article properties on a SQL ServerSQL Server Publisher.

Valeurs des codes de retourReturn Code Values

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

NotesRemarks

sp_changearticle est utilisé dans la réplication d’instantané et la réplication transactionnelle.sp_changearticle is used in snapshot replication and transactional replication.

Lorsqu’un article appartient à une publication qui prend en charge la réplication transactionnelle d’égal à égal, vous ne pouvez modifier que les propriétés Description, ins_cmd, upd_cmdet del_cmd .When an article belongs to a publication that supports peer-to-peer transactional replication, you can only change the description, ins_cmd, upd_cmd, and del_cmd properties.

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

  • del_cmddel_cmd

  • dest_tabledest_table

  • destination_ownerdestination_owner

  • ins_cmdins_cmd

  • pre_creation_cmdpre_creation_cmd

  • schema_optionsschema_options

  • upd_cmdupd_cmd

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

  • del_cmddel_cmd

  • dest_tabledest_table

  • destination_ownerdestination_owner

  • filterfilter

  • ins_cmdins_cmd

  • statusstatus

  • upd_cmdupd_cmd

Dans une publication existante, vous pouvez utiliser sp_changearticle pour modifier un article sans avoir à supprimer et recréer l’intégralité de la publication.Within an existing publication, you can use sp_changearticle to change an article without having to drop and re-create the entire publication.

Notes

Lors de la modification de la valeur de schema_option, le système n’effectue pas de mise à jour au niveau du bit.When changing the value of schema_option, the system does not perform a bitwise update. Cela signifie que lorsque vous définissez schema_option à l’aide de sp_changearticle, les paramètres de bit existants peuvent être désactivés.This means that when you set schema_option using sp_changearticle, existing bit settings may be turned off. Pour conserver les paramètres existants, vous devez effectuer | (Opérateur or au niveau du bit) entre la valeur que vous définissez et la valeur actuelle de schema_option, qui peut être déterminée en exécutant sp_helparticle.To retain the existing settings, you should perform | (Bitwise OR) between the value that you are setting and the current value of schema_option, which can be determined by executing sp_helparticle.

Options de schéma validesValid Schema Options

Le tableau suivant décrit les valeurs autorisées de schema_option en fonction du type de réplication (indiqué dans la partie supérieure) et du type d’article (affiché dans la première colonne).The following 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, la valeur schema_option de 0x80 doit être activée.For queued updating publications, the schema_option value of 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 et 0x4000.The supported schema_option values for non- SQL ServerSQL Server publications are: 0x01, 0x02, 0x10, 0x40, 0x80, 0x1000 and 0x4000.

ExempleExample

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

-- Change the schema options to replicate schema with XML.
USE [AdventureWorks2012]
EXEC sp_changearticle 
  @publication = @publication,
  @article = @article, 
  @property = N'schema_option', 
  @value = @option,
  @force_invalidate_snapshot = 1;
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_changearticle.Only members of the sysadmin fixed server role or db_owner fixed database role can execute sp_changearticle.

Voir aussiSee Also

Afficher et modifier les propriétés d’un article View and Modify Article Properties
Changer les propriétés des publications et des articles Change Publication and Article Properties
sp_addarticle (Transact-SQL) sp_addarticle (Transact-SQL)
sp_articlecolumn (Transact-SQL) sp_articlecolumn (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)