sp_changearticle (Transact-SQL)sp_changearticle (Transact-SQL)

QUESTO ARGOMENTO SI APPLICA A:sìSQL Server (a partire dalla versione 2008)noDatabase SQL di AzurenoAzure SQL Data Warehouse noParallel Data Warehouse THIS TOPIC APPLIES TO:yesSQL Server (starting with 2008)noAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse

Modifica le proprietà di un articolo in una pubblicazione transazionale o snapshot.Changes the properties of an article in a transactional or snapshot publication. Questa stored procedure viene eseguita nel database di pubblicazione del server di pubblicazione.This stored procedure is executed at the Publisher on the publication database.

Icona di collegamento a un argomentoConvenzioni della sintassi Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SintassiSyntax


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

ArgomentiArguments

[ @publication=] 'pubblicazione'[ @publication=] 'publication'
Nome della pubblicazione in cui è contenuto l'articolo.Is the name of the publication that contains the article. pubblicazione viene sysname, con un valore predefinito è NULL.publication is sysname, with a default of NULL.

[ @article=] 'articolo'[ @article=] 'article'
Nome dell'articolo di cui modificare la proprietà.Is the name of the article whose property is to be changed. articolo viene sysname, con un valore predefinito è NULL.article is sysname, with a default of NULL.

[ @property=] 'proprietà'[ @property=] 'property'
Proprietà dell'articolo da modificare.Is an article property to change. proprietà viene nvarchar(100).property is nvarchar(100).

[ @value=] 'valore'[ @value=] 'value'
Nuovo valore della proprietà dell'articolo.Is the new value of the article property. valore viene nvarchar(255.value is nvarchar(255).

Nella tabella seguente vengono descritte le proprietà degli articoli e i valori corrispondenti.This table describes the properties of articles and the values for those properties.

ProprietàProperty ValoriValues DescriptionDescription
creation_scriptcreation_script Percorso e nome di uno script di schema dell'articolo utilizzato per la creazione delle tabelle di destinazione.Path and name of an article schema script used to create target tables. Il valore predefinito è NULL.The default is NULL.
del_cmddel_cmd Istruzione DELETE da eseguire. In alternativa, viene creata dal log.DELETE statement to execute; otherwise, it is constructed from the log.
descriptiondescription Nuova voce descrittiva per l'articolo.New descriptive entry for the article.
dest_objectdest_object Disponibile per compatibilità con le versioni precedenti.Provided for backward compatibility. Utilizzare dest_table.Use dest_table.
dest_tabledest_table Nuova tabella di destinazione.New destination table.
destination_ownerdestination_owner Nome del proprietario dell'oggetto di destinazione.Name of the owner of the destination object.
filterfilter Nuova stored procedure da utilizzare per filtrare la tabella in modo orizzontale.New stored procedure to be used to filter the table (horizontal filtering). Il valore predefinito è NULL.The default is NULL. Non può essere modificato per le pubblicazioni nella replica peer-to-peer.Cannot be changed for publications in peer-to-peer replication.
fire_triggers_on_snapshotfire_triggers_on_snapshot truetrue I trigger utente replicati vengono eseguiti quando si applica lo snapshot iniziale.Replicated user triggers are executed when the initial snapshot is applied.

Nota: per i trigger di replica, il valore di maschera di bit di schema_option deve includere il valore 0x100.Note: For triggers to be replicated, the bitmask value of schema_option must include the value 0x100.
falsefalse I trigger utente replicati non vengono eseguiti quando si applica lo snapshot iniziale.Replicated user triggers are not executed when the initial snapshot is applied.
identity_rangeidentity_range Controlla le dimensioni degli intervalli di valori Identity assegnati nel Sottoscrittore.Controls the size of assigned identity ranges assigned at the Subscriber. Non supportato per la replica peer-to-peer.Not supported for peer-to-peer replication.
ins_cmdins_cmd Istruzione INSERT da eseguire. In alternativa, viene creata dal log.INSERT statement to execute; otherwise, it is constructed from the log.
pre_creation_cmdpre_creation_cmd Comando preliminare per eliminare, rimuovere o troncare la tabella di destinazione prima della sincronizzazione.Pre-creation command that can drop, delete, or truncate the destination table before synchronization is applied.
Nessunonone Non utilizza alcun comando.Does not use a command.
dropdrop Rimuove la tabella di destinazione.Drops the destination table.
deletedelete Elimina la tabella di destinazione.Deletes the destination table.
truncatetruncate Tronca la tabella di destinazione.Truncates the destination table.
pub_identity_rangepub_identity_range Controlla le dimensioni degli intervalli di valori Identity assegnati nel Sottoscrittore.Controls the size of assigned identity ranges assigned at the Subscriber. Non supportato per la replica peer-to-peer.Not supported for peer-to-peer replication.
schema_optionschema_option Specifica la mappa di bit dell'opzione di generazione dello schema per l'articolo specificato.Specifies the bitmap of the schema generation option for the given article. schema_option viene binari (8).schema_option is binary(8). Per ulteriori informazioni, vedere la sezione Osservazioni di seguito in questo argomento.For more information, see the Remarks section later in this topic.
0x000x00 Disabilita la creazione di script eseguita dall'agente snapshot.Disables scripting by the Snapshot Agent.
0x010x01 Genera le istruzioni per la creazione di oggetti (CREATE TABLE, CREATE PROCEDURE e così via).Generates the object creation (CREATE TABLE, CREATE PROCEDURE, and so on).
0x020x02 Genera le stored procedure che propagano le eventuali modifiche per l'articolo.Generates the stored procedures that propagate changes for the article, if defined.
0x040x04 Gli script per le colonne Identity vengono creati tramite la proprietà IDENTITY.Identity columns are scripted using the IDENTITY property.
0x080x08 Replicare timestamp colonne.Replicate timestamp columns. Se non impostato, timestamp colonne vengono replicate come binario.If not set, timestamp columns are replicated as binary.
0x100x10 Genera un indice cluster corrispondente.Generates a corresponding clustered index.
0x200x20 Converte i tipi di dati definiti dall'utente (UDT) in tipi di dati di base nel Sottoscrittore.Converts user-defined data types (UDT) to base data types at the Subscriber. Questa opzione non può essere usata quando è presente un vincolo CHECK o DEFAULT su una colonna UDT, se una colonna UDT è inclusa nella chiave primaria o se una colonna calcolata fa riferimento a una colonna 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. Questa proprietà non è supportata per server di pubblicazione Oracle.Not supported for Oracle Publishers.
0x400x40 Genera indici non cluster corrispondenti.Generates corresponding nonclustered indexes.
0x800x80 include i vincoli di integrità referenziale dichiarati nelle chiavi primarie.Includes declared referential integrity on the primary keys.
0x1000x100 Replica gli eventuali trigger dell'utente di un articolo di tabella.Replicates user triggers on a table article, if defined.
0x2000x200 Replica i vincoli FOREIGN KEY.Replicates FOREIGN KEY constraints. Se la tabella con riferimenti non fa parte di una pubblicazione, tutti i vincoli FOREIGN KEY in una tabella pubblicata non vengono replicati.If the referenced table is not part of a publication, all FOREIGN KEY constraints on a published table are not replicated.
0x4000x400 Replica i vincoli CHECK.Replicates CHECK constraints.
0x8000x800 Replica i valori predefiniti.Replicates defaults.
0x10000x1000 Replica le regole di confronto a livello di colonna.Replicates column-level collation.
0x20000x2000 Replica le proprietà estese associate all'oggetto di origine dell'articolo pubblicato.Replicates extended properties associated with the published article source object.
0x40000x4000 Replica le eventuali chiavi univoche definite in un articolo di tabella.Replicates unique keys if defined on a table article.
0x80000x8000 Replica come vincoli la chiave primaria e le chiavi univoche di un articolo di tabella tramite istruzioni ALTER TABLE.Replicates primary key and unique keys on a table article as constraints using ALTER TABLE statements.

Nota: Questa opzione è stata deprecata.Note: This option has been deprecated. Utilizzare 0x80 e 0x4000 invece.Use 0x80 and 0x4000 instead.
0x10000.0x10000 Replica i vincoli CHECK come NOT FOR REPLICATION in modo che i vincoli non vengono imposti durante la sincronizzazione.Replicates CHECK constraints as NOT FOR REPLICATION so that the constraints are not enforced during synchronization.
0x200000x20000 Replica i vincoli FOREIGN KEY come NOT FOR REPLICATION in modo che i vincoli non vengono imposti durante la sincronizzazione.Replicates FOREIGN KEY constraints as NOT FOR REPLICATION so that the constraints are not enforced during synchronization.
0x400000x40000 Replica i filegroup associati a una tabella o un indice partizionato.Replicates filegroups associated with a partitioned table or index.
0x800000x80000 Replica lo schema di partizione per una tabella partizionata.Replicates the partition scheme for a partitioned table.
0x1000000x100000 Replica lo schema di partizione per un indice partizionato.Replicates the partition scheme for a partitioned index.
0x2000000x200000 Replica le statistiche della tabella.Replicates table statistics.
0x4000000x400000 Associazioni predefiniteDefault Bindings
0x8000000x800000 Associazioni regolaRule Bindings
0x10000000x1000000 Indice full-textFull-text index
0x20000000x2000000 Raccolte di XML schema associata a xml colonne non vengono replicate.XML schema collections bound to xml columns are not replicated.
0x40000000x4000000 Replica gli indici su xml colonne.Replicates indexes on xml columns.
0x80000000x8000000 Crea gli schemi non ancora presenti nel Sottoscrittore.Create any schemas not already present on the subscriber.
0x100000000x10000000 Converte xml colonne ntext nel Sottoscrittore.Converts xml columns to ntext on the Subscriber.
0x200000000x20000000 Tipi di dati dell'oggetto converte di grandi dimensioni (nvarchar (max), varchar (max), e varbinary (max)) che sono stati introdotti in SQL Server 2005SQL Server 2005 ai tipi di dati supportati in SQL Server 2000 (8.x)SQL Server 2000 (8.x).Converts large object data types (nvarchar(max), varchar(max), and varbinary(max)) that were introduced in SQL Server 2005SQL Server 2005 to data types that are supported on SQL Server 2000 (8.x)SQL Server 2000 (8.x).
0x400000000x40000000 Replica le autorizzazioni.Replicate permissions.
0x800000000x80000000 Tenta di eliminare le dipendenze da tutti gli oggetti che non fanno parte della pubblicazione.Attempt to drop dependencies to any objects that are not part of the publication.
0x1000000000x100000000 Utilizzare questa opzione per replicare l'attributo FILESTREAM se viene specificato in varbinary (max) colonne.Use this option to replicate the FILESTREAM attribute if it is specified on varbinary(max) columns. Non specificare questa opzione se si stanno replicando tabelle nei Sottoscrittori SQL Server 2005SQL Server 2005.Do not specify this option if you are replicating tables to SQL Server 2005SQL Server 2005 Subscribers. La replica di tabelle con colonne FILESTREAM in SQL Server 2000 (8.x)SQL Server 2000 (8.x) sottoscrittori non è supportata, indipendentemente dall'impostazione di questa opzione dello schema.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.

Vedere l'opzione correlata 0x800000000.See related option 0x800000000.
0x2000000000x200000000 Converte i tipi di dati data e ora (data, ora, datetimeoffset, e datetime2) che sono stati introdotti in SQL Server 2008SQL Server 2008 per i tipi di dati supportati nelle versioni precedenti di SQL ServerSQL Server.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 Replica l'opzione di compressione per dati e indici.Replicates the compression option for data and indexes. Per altre informazioni, vedere Data Compression.For more information, see Data Compression.
0x8000000000x800000000 Impostare questa opzione per archiviare i dati FILESTREAM nel relativo filegroup nel Sottoscrittore.Set this option to store FILESTREAM data on its own filegroup at the Subscriber. Se questa opzione non è impostata, i dati FILESTREAM vengono archiviati nel filegroup predefinito.If this option is not set, FILESTREAM data is stored on the default filegroup. Tramite la replica non vengono creati filegroup, pertanto, se si imposta questa opzione, è necessario creare il filegroup prima di applicare lo snapshot nel Sottoscrittore.Replication does not create filegroups; therefore, if you set this option, you must create the filegroup before you apply the snapshot at the Subscriber. Per ulteriori informazioni su come creare gli oggetti prima di applicare lo snapshot, vedere eseguire script prima e dopo l'applicazione dello Snapshot.For more information about how to create objects before you apply the snapshot, see Execute Scripts Before and After the Snapshot Is Applied.

Vedere l'opzione correlata 0x100000000.See related option 0x100000000.
0x10000000000x1000000000 Converte i tipi common language runtime (CLR) definito dall'utente (UDT) maggiori di 8000 byte in varbinary (max) in modo che le colonne di tipo definito dall'utente possono essere replicate nei Sottoscrittori che eseguono SQL Server 2005SQL Server 2005.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 2005SQL Server 2005.
0x20000000000x2000000000 Converte il hierarchyid tipo di dati varbinary (max) in modo che le colonne di tipo hierarchyid possano essere replicate nei Sottoscrittori che eseguono SQL Server 2005SQL Server 2005.Converts the hierarchyid data type to varbinary(max) so that columns of type hierarchyid can be replicated to Subscribers that are running SQL Server 2005SQL Server 2005. Per ulteriori informazioni su come usare hierarchyid le colonne nelle tabelle replicate, vedere hierarchyid (Transact-SQL).For more information about how to use hierarchyid columns in replicated tables, see hierarchyid (Transact-SQL).
0x40000000000x4000000000 Replica gli eventuali indici filtrati sulla tabella.Replicates any filtered indexes on the table. Per ulteriori informazioni sugli indici filtrati, vedere Create Filtered Indexes.For more information about filtered indexes, see Create Filtered Indexes.
0x80000000000x8000000000 Converte il geography e geometry tipi di dati di varbinary (max) in modo che le colonne di questi tipi possono essere replicate nei Sottoscrittori che eseguono SQL Server 2005SQL Server 2005.Converts the geography and geometry data types to varbinary(max) so that columns of these types can be replicated to Subscribers that are running SQL Server 2005SQL Server 2005.
0x100000000000x10000000000 Replica gli indici su colonne di tipo geography e geometry.Replicates indexes on columns of type geography and geometry.
0x200000000000x20000000000 Replica l'attributo SPARSE per le colonne.Replicates the SPARSE attribute for columns. Per ulteriori informazioni su questo attributo, vedere utilizzare le colonne di tipo Sparse.For more information about this attribute, see Use Sparse Columns.
0x400000000000x40000000000 Attivazione di scripting per l'agente snapshot per creare una tabella con ottimizzazione per la memoria nel server di sottoscrizione.Enable scripting by the snapshot agent to create memory optimized table on the subscriber.
0x800000000000x80000000000 Converte un indice cluster in indice non cluster per gli articoli con ottimizzazione per la memoria.Converts clustered index to nonclustered index for memory-optimized articles.
statusstatus Nuovo stato della proprietà.Specifies the new status of the property.
partizioni orizzontali DTSdts horizontal partitions Identificato solo a scopo informativo.Identified for informational purposes only. Non supportato.Not supported. Non è garantita la compatibilità con le versioni future.Future compatibility is not guaranteed.
Includi nomi di colonnainclude column names I nomi delle colonne sono inclusi nell'istruzione INSERT replicata.Column names are included in the replicated INSERT statement.
Nessun nome di colonnano column names I nomi delle colonne non sono inclusi nell'istruzione INSERT replicata.Column names are not included in the replicated INSERT statement.
no dts horizontal partitions 'no dts horizontal partitions La partizione orizzontale per l'articolo non è definita da una sottoscrizione trasformabile.The horizontal partition for the article is not defined by a transformable subscription.
Nessunonone Cancella tutte le opzioni di stato di sysarticles tabella e contrassegna l'articolo come inattivo.Clears all status options in the sysarticles table and marks the article as inactive.
parametersparameters Le modifiche vengono propagate al Sottoscrittore tramite i comandi con parametri.Changes are propagated to the Subscriber using parameterized commands. Questa è l'impostazione predefinita per un nuovo articolo.This is the default setting for a new article.
Valori letterali stringastring literals Le modifiche vengono propagate al Sottoscrittore tramite i valori letterali stringa.Changes are propagated to the Subscriber using string literal values.
sync_objectsync_object Nome della tabella o vista utilizzata per generare un file di output di sincronizzazione.Name of the table or view used to produce a synchronization output file. Il valore predefinito è NULL.The default is NULL. Questa proprietà non è supportata per server di pubblicazione Oracle.Not supported for Oracle Publishers.
Spazio di tabellatablespace Identifica lo spazio tabella utilizzato dalla tabella di registrazione per un articolo pubblicato da un database Oracle.Identifies the tablespace used by the logging table for an article published from an Oracle database. Per altre informazioni, vedere Gestire spazi di tabella Oracle.For more information, see Manage Oracle Tablespaces.
Sogliathreshold Valore percentuale che controlla quando l'agente di distribuzione assegna un nuovo intervallo di valori Identity.The percentage value that controls when the Distribution Agent assigns a new identity range. Non supportato per la replica peer-to-peer.Not supported for peer-to-peer replication.
typetype Questa proprietà non è supportata per server di pubblicazione Oracle.Not supported for Oracle Publishers.
logbasedlogbased Articolo basato su un log.Log-based article.
logbased manualbothlogbased manualboth Articolo basato su log con filtro manuale e vista manuale.Log-based article with manual filter and manual view. Questa opzione richiede che il sync_object e filtro anche essere impostate.This option requires that the sync_object and filter properties also be set. Questa proprietà non è supportata per server di pubblicazione Oracle.Not supported for Oracle Publishers.
logbased manualfilterlogbased manualfilter Articolo basato su log con filtro manuale.Log-based article with manual filter. Questa opzione richiede che il sync_object e filtro anche essere impostate.This option requires that the sync_object and filter properties also be set. Questa proprietà non è supportata per server di pubblicazione Oracle.Not supported for Oracle Publishers.
logbased manualviewlogbased manualview Articolo basato su log con vista manuale.Log-based article with manual view. Questa opzione richiede che il sync_object anche essere impostata.This option requires that the sync_object property also be set. Questa proprietà non è supportata per server di pubblicazione Oracle.Not supported for Oracle Publishers.
viewlogbased indicizzataindexed viewlogbased Articolo di vista indicizzata basato su log.Log-based indexed view article. Questa proprietà non è supportata per server di pubblicazione Oracle.Not supported for Oracle Publishers. Per questo tipo di articolo non è necessario pubblicare separatamente la tabella di base.For this type of article, the base table does not need to be published separately.
manualboth viewlogbased indicizzataindexed viewlogbased manualboth Articolo di vista indicizzata basato su log con filtro manuale e vista manuale.Log-based indexed view article with manual filter and manual view. Questa opzione richiede che il sync_object e filtro anche essere impostate.This option requires that the sync_object and filter properties also be set. Per questo tipo di articolo non è necessario pubblicare separatamente la tabella di base.For this type of article, the base table does not need to be published separately. Questa proprietà non è supportata per server di pubblicazione Oracle.Not supported for Oracle Publishers.
manualfilter viewlogbased indicizzataindexed viewlogbased manualfilter Articolo di vista indicizzata basato su log con filtro manuale.Log-based indexed view article with manual filter. Questa opzione richiede il sync_object e filtro anche essere impostate.This option requires the sync_object and filter properties also be set. Per questo tipo di articolo non è necessario pubblicare separatamente la tabella di base.For this type of article, the base table does not need to be published separately. Questa proprietà non è supportata per server di pubblicazione Oracle.Not supported for Oracle Publishers.
manualview viewlogbased indicizzataindexed viewlogbased manualview Articolo di vista indicizzata basato su log con vista manuale.Log-based indexed view article with manual view. Questa opzione richiede che il sync_object anche essere impostata.This option requires that the sync_object property also be set. Per questo tipo di articolo non è necessario pubblicare separatamente la tabella di base.For this type of article, the base table does not need to be published separately. Questa proprietà non è supportata per server di pubblicazione Oracle.Not supported for Oracle Publishers.
upd_cmdupd_cmd Istruzione UPDATE da eseguire. In alternativa, viene creata dal log.UPDATE statement to execute; otherwise, it is constructed from the log.
NULLNULL NULLNULL Restituisce un elenco di proprietà dell'articolo che è possibile modificare.Returns a list of article properties that can be changed.

[ @force_invalidate_snapshot = ] force_invalidate_snapshot[ @force_invalidate_snapshot = ] force_invalidate_snapshot
Segnala che l'azione eseguita da questa stored procedure potrebbe invalidare uno snapshot esistente.Acknowledges that the action taken by this stored procedure may invalidate an existing snapshot. force_invalidate_snapshot è un bit, il valore predefinito è 0.force_invalidate_snapshot is a bit, with a default of 0.

0 specifica che le modifiche apportate all'articolo non invalidano lo snapshot non è valido.0 specifies that changes to the article do not cause the snapshot to be invalid. Se la stored procedure rileva che la modifica richiede un nuovo snapshot, viene generato un errore e non viene apportata alcuna modifica.If the stored procedure detects that the change does require a new snapshot, an error occurs and no changes are made.

1 specifica che le modifiche apportate all'articolo possono invalidare lo snapshot non è valido e se sono disponibili sottoscrizioni che richiedono un nuovo snapshot, consente l'autorizzazione per lo snapshot esistente deve essere contrassegnato come obsoleto e di generarne uno nuovo.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.

Per informazioni sulle proprietà che richiedono la generazione di un nuovo snapshot quando vengono modificate, vedere la sezione Osservazioni.See the Remarks section for the properties that, when changed, require the generation of a new snapshot.

[@force_reinit_subscription=] * * * force_reinit_subscription*[ **@force_reinit_subscription=]force_reinit_subscription
Segnala che l'azione eseguita dalla stored procedure potrebbe richiedere la reinizializzazione delle sottoscrizioni esistenti.Acknowledges that the action taken by this stored procedure may require existing subscriptions to be reinitialized. force_reinit_subscription è un bit con valore predefinito è 0.force_reinit_subscription is a bit with a default of 0.

0 specifica che le modifiche apportate all'articolo non causano la reinizializzazione della sottoscrizione.0 specifies that changes to the article do not cause the subscription to be reinitialized. Se la stored procedure rileva che la modifica richiede la reinizializzazione delle sottoscrizioni esistenti, viene generato un errore e non viene apportata alcuna modifica.If the stored procedure detects that the change would require existing subscriptions to be reinitialized, an error occurs and no changes are made.

1 specifica che le modifiche apportate all'articolo causano reinizializzazione delle sottoscrizioni esistenti e concede l'autorizzazione per la reinizializzazione.1 specifies that changes to the article cause existing subscriptions to be reinitialized, and gives permission for the subscription reinitialization to occur.

Per ulteriori informazioni sulle proprietà che richiedono la reinizializzazione di tutte le sottoscrizioni esistenti in caso di modifica, vedere la sezione Osservazioni.See the Remarks section for the properties that, when changed, require that all existing subscriptions be reinitialized.

[ @publisher=] 'publisher'[ @publisher= ] 'publisher'
Specifica un server di pubblicazione non SQL ServerSQL Server.Specifies a non- SQL ServerSQL Server Publisher. server di pubblicazione viene sysname, con un valore predefinito è NULL.publisher is sysname, with a default of NULL.

Nota

server di pubblicazione non deve essere utilizzato quando si modificano le proprietà degli articoli in una SQL ServerSQL Server server di pubblicazione.publisher should not be used when changing article properties on a SQL ServerSQL Server Publisher.

Valori restituitiReturn Code Values

0 (esito positivo) o 1 (esito negativo)0 (success) or 1 (failure)

OsservazioniRemarks

sp_changearticle viene utilizzata nella replica snapshot e transazionale.sp_changearticle is used in snapshot replication and transactional replication.

Quando un articolo appartiene a una pubblicazione che supporta la replica transazionale peer-to-peer, è possibile modificare solo il descrizione, ins_cmd, upd_cmde del_cmd proprietà.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.

Se si modificano le proprietà seguenti richiede la generazione di un nuovo snapshot, ed è necessario specificare un valore di 1 per il force_invalidate_snapshot parametro: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

    Se si modificano le proprietà seguenti richiede esistenti reinizializzazione delle sottoscrizioni ed è necessario specificare un valore di 1 per il force_reinit_subscription parametro.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

    All'interno di una pubblicazione esistente, è possibile utilizzare sp_changearticle per modificare un articolo senza dover eliminare e ricreare l'intera pubblicazione.Within an existing publication, you can use sp_changearticle to change an article without having to drop and re-create the entire publication.

Nota

Quando si modifica il valore di schema_option, il sistema non esegue un aggiornamento bit per bit.When changing the value of schema_option, the system does not perform a bitwise update. Ciò significa che quando si imposta schema_option utilizzando sp_changearticleesistente, le impostazioni di bit possono essere disattivate.This means that when you set schema_option using sp_changearticle, existing bit settings may be turned off. Per mantenere le impostazioni esistenti, è necessario eseguire | (OR bit per bit) tra il valore da impostare e il valore corrente di schema_option, che è possibile determinare eseguendo 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.

Opzioni di schema valideValid Schema Options

Nella tabella seguente vengono descritti i valori consentiti di schema_option in base al tipo di replica (indicato nella parte superiore) e il tipo di articolo (indicato nella prima colonna).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).

Tipo di articoloArticle type Tipo di replicaReplication type
TransazionaleTransactional SnapshotSnapshot
logbasedlogbased Tutte le opzioniAll options Tutte le opzioni ma 0x02All options but 0x02
logbased manualfilterlogbased manualfilter Tutte le opzioniAll options Tutte le opzioni ma 0x02All options but 0x02
logbased manualviewlogbased manualview Tutte le opzioniAll options Tutte le opzioni ma 0x02All options but 0x02
logbased vista indicizzataindexed view logbased Tutte le opzioniAll options Tutte le opzioni ma 0x02All options but 0x02
vista indicizzata logbased manualfilterindexed view logbased manualfilter Tutte le opzioniAll options Tutte le opzioni ma 0x02All options but 0x02
vista indicizzata logbased manualviewindexed view logbased manualview Tutte le opzioniAll options Tutte le opzioni ma 0x02All options but 0x02
vista indicizzata logbase manualbothindexed view logbase manualboth Tutte le opzioniAll options Tutte le opzioni ma 0x02All options but 0x02
proc execproc exec 0x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x40000000, e 0x800000000x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x40000000, and 0x80000000 0x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x40000000, e 0x800000000x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x40000000, and 0x80000000
serializable proc execserializable proc exec 0x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x40000000, e 0x800000000x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x40000000, and 0x80000000 0x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x40000000, e 0x800000000x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x40000000, and 0x80000000
proc schema soloproc schema only 0x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x40000000, e 0x800000000x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x40000000, and 0x80000000 0x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x40000000, e 0x800000000x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x40000000, and 0x80000000
solo schema della vistaview schema only 0x01, 0x010, 0x020, 0x040, 0x0100, 0x2000, 0x40000, 0x100000, 0x200000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x40000000, e 0x800000000x01, 0x010, 0x020, 0x040, 0x0100, 0x2000, 0x40000, 0x100000, 0x200000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x40000000, and 0x80000000 0x01, 0x010, 0x020, 0x040, 0x0100, 0x2000, 0x40000, 0x100000, 0x200000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x40000000, e 0x800000000x01, 0x010, 0x020, 0x040, 0x0100, 0x2000, 0x40000, 0x100000, 0x200000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x40000000, and 0x80000000
Func schema solofunc schema only 0x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x40000000, e 0x800000000x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x40000000, and 0x80000000 0x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x40000000, e 0x800000000x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x40000000, and 0x80000000
solo schema della vista indicizzataindexed view schema only 0x01, 0x010, 0x020, 0x040, 0x0100, 0x2000, 0x40000, 0x100000, 0x200000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x40000000, e 0x800000000x01, 0x010, 0x020, 0x040, 0x0100, 0x2000, 0x40000, 0x100000, 0x200000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x40000000, and 0x80000000 0x01, 0x010, 0x020, 0x040, 0x0100, 0x2000, 0x40000, 0x100000, 0x200000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x40000000, e 0x800000000x01, 0x010, 0x020, 0x040, 0x0100, 0x2000, 0x40000, 0x100000, 0x200000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x40000000, and 0x80000000

Nota

Per le pubblicazioni ad aggiornamento in coda, il schema_option valore 0x80 deve essere abilitato.For queued updating publications, the schema_option value of 0x80 must be enabled. Supportato schema_option i valori del parametro non SQL ServerSQL Server pubblicazioni sono: 0x01, 0x02, 0x10, 0x40, 0x80, 0x1000 e 0x4000.The supported schema_option values for non- SQL ServerSQL Server publications are: 0x01, 0x02, 0x10, 0x40, 0x80, 0x1000 and 0x4000.

EsempioExample

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

AutorizzazioniPermissions

Solo i membri del sysadmin ruolo predefinito del server o db_owner ruolo predefinito del database possono eseguire sp_changearticle.Only members of the sysadmin fixed server role or db_owner fixed database role can execute sp_changearticle.

Vedere ancheSee Also

Visualizzare e modificare le proprietà di articolo View and Modify Article Properties
Modifica delle proprietà di pubblicazioni e articoli 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)