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

APLICA-SE A: simSQL Server simBanco de Dados SQL do Azure (somente a Instância Gerenciada) nãoAzure Synapse Analytics (SQL DW) nãoParallel Data Warehouse APPLIES TO: yesSQL Server yesAzure SQL Database (Managed Instance only) noAzure Synapse Analytics (SQL DW) noParallel Data Warehouse

Altera as propriedades de um artigo em uma publicação transacional ou de instantâneo.Changes the properties of an article in a transactional or snapshot publication. Esse procedimento armazenado é executado no Publicador, no banco de dados publicador.This stored procedure is executed at the Publisher on the publication database.

Ícone de link do tópico Convenções de sintaxe de Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SintaxeSyntax

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

ArgumentosArguments

[ @publication = ] 'publication'É o nome da publicação que contém o artigo.[ @publication = ] 'publication' Is the name of the publication that contains the article. a publicação é sysname, com um padrão de NULL.publication is sysname, with a default of NULL.

[ @article = ] 'article'É o nome do artigo cuja propriedade deve ser alterada.[ @article = ] 'article' Is the name of the article whose property is to be changed. o artigo é sysname, com um padrão de NULL.article is sysname, with a default of NULL.

[ @property = ] 'property'É uma propriedade de artigo a ser alterada.[ @property = ] 'property' Is an article property to change. a Propriedade é nvarchar (100) .property is nvarchar(100).

[ @value = ] 'value'É o novo valor da Propriedade do artigo.[ @value = ] 'value' Is the new value of the article property. o valor é nvarchar (255) .value is nvarchar(255).

Essa tabela descreve as propriedades de artigos e os valores dessas propriedades.This table describes the properties of articles and the values for those properties.

PropriedadeProperty ValoresValues DescriçãoDescription
creation_scriptcreation_script Caminho e nome de um script de esquema de artigo usados para criar tabelas de destino.Path and name of an article schema script used to create target tables. O padrão é NULO.The default is NULL.
del_cmddel_cmd Instrução DELETE a ser executada; caso contrário, será construída do log.DELETE statement to execute; otherwise, it is constructed from the log.
descriptiondescription Nova entrada descritiva para o artigo.New descriptive entry for the article.
dest_objectdest_object Fornecido para compatibilidade com versões anteriores.Provided for backward compatibility. Use dest_table.Use dest_table.
dest_tabledest_table Nova tabela de destino.New destination table.
destination_ownerdestination_owner Nome do proprietário do objeto de destino.Name of the owner of the destination object.
filterfilter Novo procedimento armazenado a ser usado para filtrar a tabela (filtragem horizontal).New stored procedure to be used to filter the table (horizontal filtering). O padrão é NULO.The default is NULL. Não pode ser alterado para publicações em replicação ponto a ponto.Cannot be changed for publications in peer-to-peer replication.
fire_triggers_on_snapshotfire_triggers_on_snapshot truetrue Gatilhos de usuário replicados são executados quando o instantâneo inicial é aplicado.Replicated user triggers are executed when the initial snapshot is applied.

Observação: Para que os gatilhos sejam replicados, o valor de bitmask de schema_option deve incluir o valor 0x100.Note: For triggers to be replicated, the bitmask value of schema_option must include the value 0x100.
falsefalse Gatilhos de usuário replicados não são executados quando o instantâneo inicial é aplicado.Replicated user triggers are not executed when the initial snapshot is applied.
identity_rangeidentity_range Controla o tamanho de intervalos de identidade atribuídos atribuído ao Assinante.Controls the size of assigned identity ranges assigned at the Subscriber. Sem suporte para replicação ponto a ponto.Not supported for peer-to-peer replication.
ins_cmdins_cmd Instrução INSERT a ser executada; caso contrário, será construída do log.INSERT statement to execute; otherwise, it is constructed from the log.
pre_creation_cmdpre_creation_cmd Comando de pré-criação que pode descartar, excluir ou truncar a tabela de destino antes que a sincronização seja aplicada.Pre-creation command that can drop, delete, or truncate the destination table before synchronization is applied.
Nonenone Não usa um comando.Does not use a command.
dropdrop Descarta a tabela de destino.Drops the destination table.
deletedelete Exclui a tabela de destino.Deletes the destination table.
truncatetruncate Trunca a tabela de destino.Truncates the destination table.
pub_identity_rangepub_identity_range Controla o tamanho de intervalos de identidade atribuídos atribuído ao Assinante.Controls the size of assigned identity ranges assigned at the Subscriber. Sem suporte para replicação ponto a ponto.Not supported for peer-to-peer replication.
schema_optionschema_option Especifica o bitmap da opção de geração de esquema para o artigo determinado.Specifies the bitmap of the schema generation option for the given article. schema_option é binário (8) .schema_option is binary(8). Para obter mais informações, consulte a seção Comentários, mais adiante neste tópico.For more information, see the Remarks section later in this topic.
0x000x00 Desabilita execução de script pelo Agente de Instantâneo.Disables scripting by the Snapshot Agent.
0x010x01 Gera a criação do objeto (CREATE TABLE, CREATE PROCEDURE, e assim por diante).Generates the object creation (CREATE TABLE, CREATE PROCEDURE, and so on).
0x020x02 Gera os procedimentos armazenados que propagam alterações para o artigo, se definido.Generates the stored procedures that propagate changes for the article, if defined.
0x040x04 Os scripts das colunas de identidade são executados com a propriedade IDENTITY.Identity columns are scripted using the IDENTITY property.
0x080x08 Replicar colunas timestamp .Replicate timestamp columns. Se não for definido, as colunas de carimbo de data/hora serão replicadas como binários.If not set, timestamp columns are replicated as binary.
0x100x10 Gera um índice clusterizado correspondente.Generates a corresponding clustered index.
0x200x20 Converte UDTs (tipos de dados definidos pelo usuário) em tipos de dados básicos no Assinante.Converts user-defined data types (UDT) to base data types at the Subscriber. Essa opção não poderá ser usada quando houver uma restrição CHECK ou DEFAULT em uma coluna UDT, se uma coluna UDT for parte da chave primária ou se uma coluna computada fizer referência a uma coluna 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. Sem suporte para Publicadores Oracle.Not supported for Oracle Publishers.
0x400x40 Gera índices não clusterizados correspondentes.Generates corresponding nonclustered indexes.
0x800x80 Inclui integridade referencial declarada nas chaves primárias.Includes declared referential integrity on the primary keys.
0x1000x100 Replica gatilhos de usuário em um artigo de tabela, se definido.Replicates user triggers on a table article, if defined.
0x2000x200 Replica restrições FOREIGN KEY.Replicates FOREIGN KEY constraints. Se a tabela referenciada não fizer parte de uma publicação, todas as restrições FOREIGN KEY em uma tabela publicada não serão replicadas.If the referenced table is not part of a publication, all FOREIGN KEY constraints on a published table are not replicated.
0x4000x400 Replica restrições CHECK.Replicates CHECK constraints.
0x8000x800 Replica padrões.Replicates defaults.
0x10000x1000 Replica ordenação em nível de coluna.Replicates column-level collation.
0x20000x2000 Replica propriedades estendidas associadas com o objeto de origem do artigo publicado.Replicates extended properties associated with the published article source object.
0x40000x4000 Replica chaves exclusivas definidas em um artigo de tabela.Replicates unique keys if defined on a table article.
0x80000x8000 Reproduz chave primária e chaves exclusivas em um artigo de tabela como restrições usando instruções ALTER TABLE.Replicates primary key and unique keys on a table article as constraints using ALTER TABLE statements.

Observação: Esta opção foi preterida.Note: This option has been deprecated. Em vez disso, use 0x80 e 0x4000 .Use 0x80 and 0x4000 instead.
0x100000x10000 Replica instruções CHECK como NOT FOR REPLICATION para que as restrições não sejam forçadas durante a sincronização.Replicates CHECK constraints as NOT FOR REPLICATION so that the constraints are not enforced during synchronization.
0x200000x20000 Replica instruções FOREIGN KEY como NOT FOR REPLICATION para que as restrições não sejam forçadas durante a sincronização.Replicates FOREIGN KEY constraints as NOT FOR REPLICATION so that the constraints are not enforced during synchronization.
0x400000x40000 Replica grupos de arquivos associados a uma tabela ou índice particionado.Replicates filegroups associated with a partitioned table or index.
0x800000x80000 Replica o esquema de partição para uma tabela particionada.Replicates the partition scheme for a partitioned table.
0x1000000x100000 Replica o esquema de partição para um índice particionado.Replicates the partition scheme for a partitioned index.
0x2000000x200000 Replica estatísticas de tabela.Replicates table statistics.
0x4000000x400000 Associações padrãoDefault Bindings
0x8000000x800000 Associações de regraRule Bindings
0x10000000x1000000 Índice de texto completoFull-text index
0x20000000x2000000 As coleções de esquema XML vinculadas a colunas XML não são replicadas.XML schema collections bound to xml columns are not replicated.
0x40000000x4000000 Replica índices em colunas XML .Replicates indexes on xml columns.
0x80000000x8000000 Cria qualquer esquema ainda não presente no assinante.Create any schemas not already present on the subscriber.
0x100000000x10000000 Converte colunas XML em ntext no Assinante.Converts xml columns to ntext on the Subscriber.
0x200000000x20000000 Converte tipos de dados de objeto grande (nvarchar (max) , varchar (max) e varbinary (max) ) que foram introduzidos nos SQL Server 2005 (9.x)SQL Server 2005 (9.x) tipos de dados com suporte no. 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 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 Replicar permissões.Replicate permissions.
0x800000000x80000000 Tente descartar as dependências de todos os objetos que não fazem parte da publicação.Attempt to drop dependencies to any objects that are not part of the publication.
0x1000000000x100000000 Use esta opção para replicar o atributo FILESTREAM se ele for especificado em colunas varbinary (max) .Use this option to replicate the FILESTREAM attribute if it is specified on varbinary(max) columns. Não especifique essa opção se você estiver replicando tabelas para Assinantes 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. Não há suporte para a replicação de tabelas SQL Server 2000 (8.x)SQL Server 2000 (8.x) que têm colunas FILESTREAM para assinantes, independentemente de como essa opção de esquema está definida.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.

Consulte a opção relacionada 0x800000000.See related option 0x800000000.
0x2000000000x200000000 Converte os tipos de dados de data e hora (Date, time, DateTimeOffsete datetime2) que foram SQL Server 2008SQL Server 2008 introduzidos nos tipos de dados com suporte em versões SQL ServerSQL Serveranteriores do.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 a opção de compactação para dados e índices.Replicates the compression option for data and indexes. Para saber mais, veja Data Compression.For more information, see Data Compression.
0x8000000000x800000000 Defina essa opção para armazenar dados FILESTREAM em seu próprio grupo de arquivos no Assinante.Set this option to store FILESTREAM data on its own filegroup at the Subscriber. Se essa opção não for definida, os dados FILESTREAM serão armazenados no grupo de arquivos padrão.If this option is not set, FILESTREAM data is stored on the default filegroup. A replicação não cria grupos de arquivos; portanto, se você definir essa opção, deverá criar o grupo de arquivos antes de aplicar o instantâneo no Assinante.Replication does not create filegroups; therefore, if you set this option, you must create the filegroup before you apply the snapshot at the Subscriber. Para obter mais informações sobre como criar objetos antes de aplicar o instantâneo, consulte executar scripts antes e depois que o instantâneo for aplicado.For more information about how to create objects before you apply the snapshot, see Execute Scripts Before and After the Snapshot Is Applied.

Consulte a opção relacionada 0x100000000.See related option 0x100000000.
0x10000000000x1000000000 Converte os UDTs (tipos definidos pelo usuário) Common Language Runtime (CLR) com mais de 8000 bytes em varbinary (max) para que as colunas do tipo UDT possam ser replicadas para os SQL Server 2005 (9.x)SQL Server 2005 (9.x)assinantes que estão em execução.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 Converte o tipo de dados hierarchyid em varbinary (max) para que as colunas do tipo hierarchyid possam ser replicadas para os assinantes que estão em execução SQL Server 2005 (9.x)SQL Server 2005 (9.x).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). Para obter mais informações sobre como usar colunas hierarchyid em tabelas replicadas, consulte hierarchyid (Transact-SQL).For more information about how to use hierarchyid columns in replicated tables, see hierarchyid (Transact-SQL).
0x40000000000x4000000000 Replica qualquer índice filtrado na tabela.Replicates any filtered indexes on the table. Para obter mais informações sobre índices filtrados, consulte criar índices filtrados.For more information about filtered indexes, see Create Filtered Indexes.
0x80000000000x8000000000 Converte os tipos de dados geography e Geometry em varbinary (max) para que as colunas desses tipos possam ser replicadas para os SQL Server 2005 (9.x)SQL Server 2005 (9.x)assinantes que estão em execução.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 Replica índices em colunas do tipo geography e Geometry.Replicates indexes on columns of type geography and geometry.
0x200000000000x20000000000 Replica o atributo SPARSE para colunas.Replicates the SPARSE attribute for columns. Para obter mais informações sobre esse atributo, consulte usar colunas esparsas.For more information about this attribute, see Use Sparse Columns.
0x400000000000x40000000000 Habilite o script pelo agente de instantâneo para criar a tabela com otimização de memória no Assinante.Enable scripting by the snapshot agent to create memory optimized table on the subscriber.
0x800000000000x80000000000 Converte o índice clusterizado em índice não clusterizado para artigos com otimização de memória.Converts clustered index to nonclustered index for memory-optimized articles.
statusstatus Especifica o novo status da propriedade.Specifies the new status of the property.
partições horizontais DTSdts horizontal partitions Identificado apenas para fins informativos.Identified for informational purposes only. Sem suporte.Not supported. A compatibilidade futura não está garantida.Future compatibility is not guaranteed.
incluir nomes de colunainclude column names Nomes de coluna são incluídos na instrução INSERT replicada.Column names are included in the replicated INSERT statement.
nenhum nome de colunano column names Nomes de coluna não são incluídos na instrução INSERT replicada.Column names are not included in the replicated INSERT statement.
nenhuma partição horizontal Dtsno dts horizontal partitions A partição horizontal para o artigo não é definida por uma assinatura transformável.The horizontal partition for the article is not defined by a transformable subscription.
Nonenone Limpa todas as opções de status na tabela sysarticles e marca o artigo como inativo.Clears all status options in the sysarticles table and marks the article as inactive.
parametersparameters As alterações são propagadas ao Assinante usando comandos com parâmetros.Changes are propagated to the Subscriber using parameterized commands. Essa é a configuração padrão para um novo artigo.This is the default setting for a new article.
literais de cadeia de caracteresstring literals As alterações são propagadas ao Assinante usando valores de literal de cadeia de caracteres.Changes are propagated to the Subscriber using string literal values.
sync_objectsync_object Nome da tabela ou exibição usado para produzir um arquivo de saída de sincronização.Name of the table or view used to produce a synchronization output file. O padrão é NULO.The default is NULL. Sem suporte para Publicadores Oracle.Not supported for Oracle Publishers.
espaçostablespace Identifica o espaço de tabela usado pela tabela de log para um artigo publicado de um banco de dados de Oracle.Identifies the tablespace used by the logging table for an article published from an Oracle database. Para obter mais informações, consulte Gerenciar espaços de tabela Oracle.For more information, see Manage Oracle Tablespaces.
thresholdthreshold Valor percentual para controle quando o Distribution Agent atribuir um novo intervalo de identidade.The percentage value that controls when the Distribution Agent assigns a new identity range. Sem suporte para replicação ponto a ponto.Not supported for peer-to-peer replication.
typetype Sem suporte para Publicadores Oracle.Not supported for Oracle Publishers.
logbasedlogbased Artigo com base em log.Log-based article.
logbased manualbothlogbased manualboth Artigo com base em log com filtro manual e exibição manual.Log-based article with manual filter and manual view. Essa opção requer que as propriedades sync_object e Filter também sejam definidas.This option requires that the sync_object and filter properties also be set. Sem suporte para Publicadores Oracle.Not supported for Oracle Publishers.
logbased manualfilterlogbased manualfilter Artigo com base em log com filtro manual.Log-based article with manual filter. Essa opção requer que as propriedades sync_object e Filter também sejam definidas.This option requires that the sync_object and filter properties also be set. Sem suporte para Publicadores Oracle.Not supported for Oracle Publishers.
logbased manualviewlogbased manualview Artigo com base em log com exibição manual.Log-based article with manual view. Essa opção requer que a propriedade sync_object também seja definida.This option requires that the sync_object property also be set. Sem suporte para Publicadores Oracle.Not supported for Oracle Publishers.
viewlogbased indexadosindexed viewlogbased Artigo de exibição indexada com base em log.Log-based indexed view article. Sem suporte para Publicadores Oracle.Not supported for Oracle Publishers. Para este tipo de artigo, a tabela base não precisa ser publicada separadamente.For this type of article, the base table does not need to be published separately.
viewlogbased indexado manualbothindexed viewlogbased manualboth Artigo de exibição indexada com filtro manual e exibição manual.Log-based indexed view article with manual filter and manual view. Essa opção requer que as propriedades sync_object e Filter também sejam definidas.This option requires that the sync_object and filter properties also be set. Para este tipo de artigo, a tabela base não precisa ser publicada separadamente.For this type of article, the base table does not need to be published separately. Sem suporte para Publicadores Oracle.Not supported for Oracle Publishers.
viewlogbased indexado manualfilterindexed viewlogbased manualfilter Artigo de exibição indexada com filtro manual.Log-based indexed view article with manual filter. Essa opção requer que as propriedades sync_object e Filter também sejam definidas.This option requires the sync_object and filter properties also be set. Para este tipo de artigo, a tabela base não precisa ser publicada separadamente.For this type of article, the base table does not need to be published separately. Sem suporte para Publicadores Oracle.Not supported for Oracle Publishers.
viewlogbased indexado manualviewindexed viewlogbased manualview Artigo de exibição indexada com base em log com exibição manual.Log-based indexed view article with manual view. Essa opção requer que a propriedade sync_object também seja definida.This option requires that the sync_object property also be set. Para este tipo de artigo, a tabela base não precisa ser publicada separadamente.For this type of article, the base table does not need to be published separately. Sem suporte para Publicadores Oracle.Not supported for Oracle Publishers.
upd_cmdupd_cmd Instrução UPADTE a ser executada; caso contrário, será construída do log.UPDATE statement to execute; otherwise, it is constructed from the log.
NULLNULL NULLNULL Retorna uma lista de propriedades de artigo que podem ser alteradas.Returns a list of article properties that can be changed.

[ @force_invalidate_snapshot = ] force_invalidate_snapshotO reconhece que a ação executada por esse procedimento armazenado pode invalidar um instantâneo existente.[ @force_invalidate_snapshot = ] force_invalidate_snapshot Acknowledges that the action taken by this stored procedure may invalidate an existing snapshot. force_invalidate_snapshot é um bit, com um padrão de 0.force_invalidate_snapshot is a bit, with a default of 0.

0 especifica que as alterações no artigo não fazem com que o instantâneo seja inválido.0 specifies that changes to the article do not cause the snapshot to be invalid. Se o procedimento armazenado detectar que a alteração requer um novo instantâneo, ocorrerá um erro e nenhuma alteração será feita.If the stored procedure detects that the change does require a new snapshot, an error occurs and no changes are made.

1 especifica que as alterações no artigo podem fazer com que o instantâneo seja inválido e, se houver assinaturas existentes que exijam um novo instantâneo, concederá permissão para o instantâneo existente ser marcado como obsoleto e um novo instantâneo gerado.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.

Consulte a seção Comentários das propriedades que, quando alteradas, requerem a geração de um novo instantâneo.See the Remarks section for the properties that, when changed, require the generation of a new snapshot.

[ @force_reinit_subscription = ]force_reinit_subscription_Reconhece que a ação executada por este procedimento armazenado pode exigir que as assinaturas existentes sejam reinicializadas.[ @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 é um bit com um padrão de 0.force_reinit_subscription is a bit with a default of 0.

0 especifica que as alterações no artigo não fazem com que a assinatura seja reinicializada.0 specifies that changes to the article do not cause the subscription to be reinitialized. Se o procedimento armazenado detectar que a alteração irá requerer assinaturas existentes para ser reiniciada, ocorrerá um erro e nenhuma alteração será feita.If the stored procedure detects that the change would require existing subscriptions to be reinitialized, an error occurs and no changes are made.

1 especifica que as alterações no artigo fazem com que as assinaturas existentes sejam reinicializadas e concede a permissão para que a reinicialização da assinatura ocorra.1 specifies that changes to the article cause existing subscriptions to be reinitialized, and gives permission for the subscription reinitialization to occur.

Consulte a seção Comentários para as propriedades que, quando alteradas, requerem que todas as assinaturas existentes sejam reiniciadas.See the Remarks section for the properties that, when changed, require that all existing subscriptions be reinitialized.

[ @publisher = ] 'publisher'Especifica um não SQL ServerSQL Server Publicador.[ @publisher = ] 'publisher' Specifies a non- SQL ServerSQL Server Publisher. o Publicador é sysname, com um padrão de NULL.publisher is sysname, with a default of NULL.

Observação

o Publicador não deve ser usado ao alterar as propriedades SQL ServerSQL Server do artigo em um Publicador.publisher should not be used when changing article properties on a SQL ServerSQL Server Publisher.

Valores do código de retornoReturn Code Values

0 (êxito) ou 1 (falha)0 (success) or 1 (failure)

ComentáriosRemarks

sp_changearticle é usado na replicação de instantâneo e na replicação transacional.sp_changearticle is used in snapshot replication and transactional replication.

Quando um artigo pertence a uma publicação que dá suporte à replicação transacional ponto a ponto, você só pode alterar as propriedades Description, ins_cmd, upd_cmde 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.

A alteração de qualquer uma das propriedades a seguir requer que um novo instantâneo seja gerado, e você deve especificar um valor de 1 para o parâmetro 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

A alteração de qualquer uma das propriedades a seguir exige que as assinaturas existentes sejam reinicializadas e você deve especificar um valor de 1 para o parâmetro 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

Em uma publicação existente, você pode usar o sp_changearticle para alterar um artigo sem precisar descartar e recriar a publicação inteira.Within an existing publication, you can use sp_changearticle to change an article without having to drop and re-create the entire publication.

Observação

Ao alterar o valor de schema_option, o sistema não executa uma atualização de bits.When changing the value of schema_option, the system does not perform a bitwise update. Isso significa que, quando você define schema_option usando sp_changearticle, as configurações de bit existentes podem ser desativadas.This means that when you set schema_option using sp_changearticle, existing bit settings may be turned off. Para manter as configurações existentes, você deve executar | (OR-bit) entre o valor que você está definindo e o valor atual de schema_option, que pode ser determinado pela execução de 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.

Opções de esquema válidasValid Schema Options

A tabela a seguir descreve os valores permitidos de schema_option com base no tipo de replicação (mostrado na parte superior) e no tipo de artigo (mostrado na primeira coluna).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 de artigoArticle type Tipo de replicaçãoReplication type
Transacional.Transactional InstantâneoSnapshot
logbasedlogbased Todas as opçõesAll options Todas as opções, mas 0x02All options but 0x02
logbased manualfilterlogbased manualfilter Todas as opçõesAll options Todas as opções, mas 0x02All options but 0x02
logbased manualviewlogbased manualview Todas as opçõesAll options Todas as opções, mas 0x02All options but 0x02
exibição indexada logbasedindexed view logbased Todas as opçõesAll options Todas as opções, mas 0x02All options but 0x02
indexed view logbased manualfilterindexed view logbased manualfilter Todas as opçõesAll options Todas as opções, mas 0x02All options but 0x02
indexed view logbased manualviewindexed view logbased manualview Todas as opçõesAll options Todas as opções, mas 0x02All options but 0x02
exibição indexada base manualbothindexed view logbase manualboth Todas as opçõesAll options Todas as opções, mas 0x02All options but 0x02
proc execproc exec 0x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x40000000e 0x800000000x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x40000000, and 0x80000000 0x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x40000000e 0x800000000x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x40000000, and 0x80000000
proc. Serializable serializávelserializable proc exec 0x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x40000000e 0x800000000x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x40000000, and 0x80000000 0x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x40000000e 0x800000000x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x40000000, and 0x80000000
somente esquema procproc schema only 0x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x40000000e 0x800000000x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x40000000, and 0x80000000 0x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x40000000e 0x800000000x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x40000000, and 0x80000000
exibir somente esquemaview schema only 0x01, 0x010, 0x020, 0x040, 0x0100, 0x2000, 0x40000, 0x100000, 0x200000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x40000000e 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, 0x40000000e 0x800000000x01, 0x010, 0x020, 0x040, 0x0100, 0x2000, 0x40000, 0x100000, 0x200000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x40000000, and 0x80000000
somente esquema Funcfunc schema only 0x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x40000000e 0x800000000x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x40000000, and 0x80000000 0x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x40000000e 0x800000000x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x40000000, and 0x80000000
somente esquema de exibição indexadaindexed view schema only 0x01, 0x010, 0x020, 0x040, 0x0100, 0x2000, 0x40000, 0x100000, 0x200000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x40000000e 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, 0x40000000e 0x800000000x01, 0x010, 0x020, 0x040, 0x0100, 0x2000, 0x40000, 0x100000, 0x200000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x40000000, and 0x80000000

Observação

Para publicações de atualização em fila, o valor de schema_option de 0x80 deve ser habilitado.For queued updating publications, the schema_option value of 0x80 must be enabled. Os valores de schema_option com suporte para SQL ServerSQL Server publicações não são: 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.

ExemploExample

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

PermissõesPermissions

Somente os membros da função de servidor fixa sysadmin ou da função de banco de dados fixa db_owner podem executar sp_changearticle.Only members of the sysadmin fixed server role or db_owner fixed database role can execute sp_changearticle.

Consulte tambémSee Also

Exibir e modificar propriedades do artigo View and Modify Article Properties
Alterar propriedades da publicação e do artigo 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)