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

ESTE TÓPICO APLICA-SE A:simSQL Server (a partir de 2008)nãoBanco de Dados SQL do Microsoft AzurenãoAzure SQL Data Warehouse nãoParallel Data Warehouse THIS TOPIC APPLIES TO:yesSQL Server (starting with 2008)noAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse

Cria um artigo e adiciona-o a uma publicação.Creates an article and adds it to a 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_addarticle [ @publication = ] 'publication'   
        , [ @article = ] 'article'   
    [ , [ @source_table = ] 'source_table' ]  
    [ , [ @destination_table = ] 'destination_table' ]   
    [ , [ @vertical_partition = ] 'vertical_partition' ]   
    [ , [ @type = ] 'type' ]   
    [ , [ @filter = ] 'filter' ]   
    [ , [ @sync_object= ] 'sync_object' ]   
        [ , [ @ins_cmd = ] 'ins_cmd' ]   
    [ , [ @del_cmd = ] 'del_cmd' ]   
        [ , [ @upd_cmd = ] 'upd_cmd' ]   
    [ , [ @creation_script = ] 'creation_script' ]   
    [ , [ @description = ] 'description' ]   
    [ , [ @pre_creation_cmd = ] 'pre_creation_cmd' ]   
    [ , [ @filter_clause = ] 'filter_clause' ]   
    [ , [ @schema_option = ] schema_option ]   
    [ , [ @destination_owner = ] 'destination_owner' ]   
    [ , [ @status = ] status ]   
    [ , [ @source_owner = ] 'source_owner' ]   
    [ , [ @sync_object_owner = ] 'sync_object_owner' ]   
    [ , [ @filter_owner = ] 'filter_owner' ]   
    [ , [ @source_object = ] 'source_object' ]   
    [ , [ @artid = ] article_ID  OUTPUT ]   
    [ , [ @auto_identity_range = ] 'auto_identity_range' ]   
    [ , [ @pub_identity_range = ] pub_identity_range ]   
    [ , [ @identity_range = ] identity_range ]   
    [ , [ @threshold = ] threshold ]   
    [ , [ @force_invalidate_snapshot = ] force_invalidate_snapshot ]  
    [ , [ @use_default_datatypes = ] use_default_datatypes  
    [ , [ @identityrangemanagementoption = ] identityrangemanagementoption ]  
    [ , [ @publisher = ] 'publisher' ]  
    [ , [ @fire_triggers_on_snapshot = ] 'fire_triggers_on_snapshot' ]   

ArgumentosArguments

[ @publication = ] 'publicação'[ @publication = ] 'publication'
É o nome da publicação que contém o artigo.Is the name of the publication that contains the article. O nome deve ser exclusivo no banco de dados.The name must be unique in the database. publicação é sysname, sem padrão.publication is sysname, with no default.

[ @article = ] 'artigo'[ @article = ] 'article'
É o nome do artigo.Is the name of the article. O nome deve ser exclusivo na publicação.The name must be unique within the publication. artigo é sysname, sem padrão.article is sysname, with no default.

[ @source_table = ] 'source_table'[ @source_table = ] 'source_table'
Esse parâmetro foi preterido; Use source_object em vez disso.This parameter has been deprecated; use source_object instead.

Não há suporte para esse parâmetro para editores Oracle.This parameter is not supported for Oracle Publishers.

[ @destination_table = ] 'destination_table'[ @destination_table = ] 'destination_table'
É o nome da tabela de destino (assinatura), se for diferente do source_tableou o procedimento armazenado.Is the name of the destination (subscription) table, if different from source_tableor the stored procedure. destination_table é sysname, com um padrão NULL, o que significa que source_table é igual a destination_table * *.destination_table is sysname, with a default of NULL, which means that source_table equals destination_table.

[ @vertical_partition = ] 'vertical_partition'[ @vertical_partition = ] 'vertical_partition'
Habilita e desabilita a filtragem de coluna em um artigo de tabela.Enables and disables column filtering on a table article. vertical_partition é nchar(5), com um padrão de FALSE.vertical_partition is nchar(5), with a default of FALSE.

False indica que não há filtragem vertical e publica todas as colunas.false indicates there is no vertical filtering and publishes all columns.

True limpa todas as colunas, exceto a chave primária declarada, colunas anuláveis sem nenhum padrão e as colunas de chave exclusivas.true clears all columns except the declared primary key, nullable columns with no default, and unique key columns. Colunas são adicionadas usando sp_articlecolumn.Columns are added using sp_articlecolumn.

[ @type = ] 'tipo'[ @type = ] 'type'
É o tipo de artigo.Is the type of article. tipo é sysname, e pode ser um dos valores a seguir.type is sysname, and can be one of the following values.

ValueValue DescriptionDescription
somente esquema de agregaçãoaggregate schema only Função de agregação apenas com esquema.Aggregate function with schema only.
somente esquema de funçãofunc schema only Função somente com esquema.Function with schema only.
modo de exibição indexado logbasedindexed view logbased 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.
modo de exibição indexado logbased manualbothindexed view logbased 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 você especifique os sync_object e filtro parâmetros.This option requires that you specify both sync_object and filter parameters. 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.
modo de exibição indexado logbased manualfilterindexed view logbased manualfilter Artigo de exibição indexada com filtro manual.Log-based indexed view article with manual filter. Essa opção requer que você especifique os sync_object e filtro parâmetros.This option requires that you specify both sync_object and filter parameters. 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.
modo de exibição indexado logbased manualviewindexed view logbased 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 você especifique o sync_object parâmetro.This option requires that you specify the sync_object parameter. 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.
somente o esquema de exibição indexadaindexed view schema only Exibição indexada somente com esquemaIndexed view with schema only. Para esse tipo de artigo, a tabela base também deve ser publicada.For this type of article, the base table must also be published.
logbased (padrão)logbased (default) 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 você especifique os sync_object e filtro parâmetros.This option requires that you specify both sync_object and filter parameters. 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 você especifique os sync_object e filtro parâmetros.This option requires that you specify both sync_object and filter parameters. 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 você especifique o sync_object parâmetro.This option requires that you specify the sync_object parameter. Sem suporte para Publicadores Oracle.Not supported for Oracle Publishers.
proc execproc exec Replica a execução do procedimento armazenado para todos os assinantes do artigo.Replicates the execution of the stored procedure to all Subscribers of the article. Sem suporte para Publicadores Oracle.Not supported for Oracle Publishers. Recomendamos que você use a opção serializable proc exec em vez de proc exec.We recommend that you use the option serializable proc exec instead of proc exec. Para obter mais informações, consulte a seção "Tipos de artigos de armazenado do procedimento execução" em Publishing Stored Procedure Execution em replicação transacional.For more information, see the section "Types of Stored Procedure Execution Articles" in Publishing Stored Procedure Execution in Transactional Replication. Não disponível quando a opção alterar captura de dados está habilitada.Not available when change data capture is enabled.
somente esquema de PROCproc schema only Procedimento apenas com esquema.Procedure with schema only. Sem suporte para Publicadores Oracle.Not supported for Oracle Publishers.
Serializable proc execserializable proc exec Replica a execução do procedimento armazenado apenas se ele for executado no contexto de uma transação serializável.Replicates the execution of the stored procedure only if it is executed within the context of a serializable transaction. Sem suporte para Publicadores Oracle.Not supported for Oracle Publishers.

O procedimento também deve ser executado dentro de uma transação explícita para a execução do procedimento ser replicadas.The procedure also must be executed inside an explicit transaction for the procedure execution to be replicated.
somente o esquema de exibiçãoview schema only Exibição somente com esquemaView with schema only. Sem suporte para Publicadores Oracle.Not supported for Oracle Publishers. Ao usar essa opção, você também deve publicar a tabela base.When using this option, you must also publish the base table.

[ @filter = ] 'filtro'[ @filter = ] 'filter'
É o procedimento armazenado (criado com FOR REPLICATION) usado para filtrar a tabela horizontalmente.Is the stored procedure (created with FOR REPLICATION) used to filter the table horizontally. filtro é nvarchar (386), com um padrão NULL.filter is nvarchar(386), with a default of NULL. sp_articleview e sp_articlefilter devem ser executados manualmente para criar o modo de exibição e o procedimento armazenado de filtro.sp_articleview and sp_articlefilter must be executed manually to create the view and filter stored procedure. Se não for NULL, o procedimento de filtro não é criado (supõe que o procedimento armazenado é criado manualmente).If not NULL, the filter procedure is not created (assumes the stored procedure is created manually).

[ @sync_object = ] 'sync_object'[ @sync_object = ] 'sync_object'
É o nome da tabela ou exibição usada para criar o arquivo de dados usado para representar o instantâneo desse artigo.Is the name of the table or view used for producing the data file used to represent the snapshot for this article. sync_object é nvarchar (386), com um padrão NULL.sync_object is nvarchar(386), with a default of NULL. Se for NULL, sp_articleview é chamado para criar automaticamente a exibição usada para gerar o arquivo de saída.If NULL, sp_articleview is called to automatically create the view used to generate the output file. Isso ocorre após a adição de colunas com sp_articlecolumn.This occurs after adding any columns with sp_articlecolumn. Se não for NULL, uma exibição não será criada (supõe que a exibição é criada manualmente).If not NULL, a view is not created (assumes the view is manually created).

[ @ins_cmd = ] 'ins_cmd'[ @ins_cmd = ] 'ins_cmd'
É o tipo de comando de replicação usado ao replicar inserções para esse artigo.Is the replication command type used when replicating inserts for this article. ins_cmd é nvarchar (255), e pode ser um dos valores a seguir.ins_cmd is nvarchar(255), and can be one of the following values.

ValueValue DescriptionDescription
NONENONE Nenhuma ação é tomada.No action is taken.
CALL sp_msins _CALL sp_MSins_
tabela (padrão)table (default)

-ou--or-

CHAMAR custom_stored_procedure_nameCALL custom_stored_procedure_name
Chama um procedimento armazenado a ser executado no Assinante.Calls a stored procedure to be executed at the Subscriber. Para usar esse método de replicação, use schema_option para especificar a criação automática do procedimento armazenado, ou criar o procedimento armazenado especificado no banco de dados de destino de cada assinante do artigo.To use this method of replication, use schema_option to specify automatic creation of the stored procedure, or create the specified stored procedure in the destination database of each Subscriber of the article. custom_stored_procedure é o nome de um procedimento armazenado criado pelo usuário.custom_stored_procedure is the name of a user-created stored procedure. sp_msins _ * tabela* contém o nome da tabela de destino em vez do _table parte do parâmetro.sp_MSins_*table* contains the name of the destination table in place of the _table part of the parameter. Quando destination_owner for especificado, ele é anexado ao nome da tabela de destino.When destination_owner is specified, it is prepended to the destination table name. Por exemplo, para o ProductCategory tabela pertencentes a produção esquema no assinante, o parâmetro seria CALL sp_MSins_ProductionProductCategory.For example, for the ProductCategory table owned by the Production schema at the Subscriber, the parameter would be CALL sp_MSins_ProductionProductCategory. Para um artigo em uma topologia de replicação ponto a ponto, _table é acrescentado com um valor de GUID.For an article in a peer-to-peer replication topology, _table is appended with a GUID value. Especificando custom_stored_procedure não há suporte para assinantes de atualização.Specifying custom_stored_procedure is not supported for updating subscribers.
SQL ou nuloSQL or NULL Replica uma instrução INSERT.Replicates an INSERT statement. A instrução INSERT fornece valores para todas as colunas publicadas no artigo.The INSERT statement is provided values for all columns published in the article. Esse comando é replicado em inserções:This command is replicated on inserts:

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

Para obter mais informações, consulte Especificar como as alterações são propagadas para artigos transacionais.For more information, see Specify How Changes Are Propagated for Transactional Articles.

[ @del_cmd =] 'del_cmd'[ @del_cmd =] 'del_cmd'
É o tipo de comando de replicação usado ao replicar exclusões para esse artigo.Is the replication command type used when replicating deletes for this article. del_cmd é nvarchar (255), e pode ser um dos valores a seguir.del_cmd is nvarchar(255), and can be one of the following values.

ValueValue DescriptionDescription
NONENONE Nenhuma ação é tomada.No action is taken.
CALLsp_MSdel_CALLsp_MSdel_
tabela (padrão)table (default)

-ou--or-

CHAMAR custom_stored_procedure_nameCALL custom_stored_procedure_name
Chama um procedimento armazenado a ser executado no Assinante.Calls a stored procedure to be executed at the Subscriber. Para usar esse método de replicação, use schema_option para especificar a criação automática do procedimento armazenado, ou criar o procedimento armazenado especificado no banco de dados de destino de cada assinante do artigo.To use this method of replication, use schema_option to specify automatic creation of the stored procedure, or create the specified stored procedure in the destination database of each Subscriber of the article. custom_stored_procedure é o nome de um procedimento armazenado criado pelo usuário.custom_stored_procedure is the name of a user-created stored procedure. sp_msdel _ * tabela* contém o nome da tabela de destino em vez do _table parte do parâmetro.sp_MSdel_*table* contains the name of the destination table in place of the _table part of the parameter. Quando destination_owner for especificado, ele é anexado ao nome da tabela de destino.When destination_owner is specified, it is prepended to the destination table name. Por exemplo, para o ProductCategory tabela pertencentes a produção esquema no assinante, o parâmetro seria CALL sp_MSdel_ProductionProductCategory.For example, for the ProductCategory table owned by the Production schema at the Subscriber, the parameter would be CALL sp_MSdel_ProductionProductCategory. Para um artigo em uma topologia de replicação ponto a ponto, _table é acrescentado com um valor de GUID.For an article in a peer-to-peer replication topology, _table is appended with a GUID value. Especificando custom_stored_procedure não há suporte para assinantes de atualização.Specifying custom_stored_procedure is not supported for updating subscribers.
Sp_msdel _ XCALLXCALL sp_MSdel_
tabletable

-ou--or-

Custom_stored_procedure_name XCALLXCALL custom_stored_procedure_name
Chama um procedimento armazenado com o uso de parâmetros no estilo XCALL.Calls a stored procedure taking XCALL style parameters. Para usar esse método de replicação, use schema_option para especificar a criação automática do procedimento armazenado, ou criar o procedimento armazenado especificado no banco de dados de destino de cada assinante do artigo.To use this method of replication, use schema_option to specify automatic creation of the stored procedure, or create the specified stored procedure in the destination database of each Subscriber of the article. Não é permitido especificar um procedimento armazenado para atualizar assinantes.Specifying a user-created stored procedure is not allowed for updating subscribers.
SQL ou nuloSQL or NULL Replica uma instrução DELETE.Replicates a DELETE statement. A instrução DELETE é fornecida em todos os valores de coluna de chave primária.The DELETE statement is provided all primary key column values. Esse comando é replicado em exclusões:This command is replicated on deletes:

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

Para obter mais informações, consulte Especificar como as alterações são propagadas para artigos transacionais.For more information, see Specify How Changes Are Propagated for Transactional Articles.

[ @upd_cmd =] 'upd_cmd'[ @upd_cmd =] 'upd_cmd'
É o tipo de comando de replicação usado ao replicar atualizações para esse artigo.Is the replication command type used when replicating updates for this article. upd_cmd é nvarchar (255), e pode ser um dos valores a seguir.upd_cmd is nvarchar(255), and can be one of the following values.

ValueValue DescriptionDescription
NONENONE Nenhuma ação é tomada.No action is taken.
CHAMAR sp_msupd _CALL sp_MSupd_
tabletable

-ou--or-

CHAMAR custom_stored_procedure_nameCALL custom_stored_procedure_name
Chama um procedimento armazenado a ser executado no Assinante.Calls a stored procedure to be executed at the Subscriber. Para usar esse método de replicação, use schema_option para especificar a criação automática do procedimento armazenado, ou criar o procedimento armazenado especificado no banco de dados de destino de cada assinante do artigo.To use this method of replication, use schema_option to specify automatic creation of the stored procedure, or create the specified stored procedure in the destination database of each Subscriber of the article.
Sp_msupd _ MCALLMCALL sp_MSupd_
tabletable

-ou--or-

Custom_stored_procedure_name MCALLMCALL custom_stored_procedure_name
Chama um procedimento armazenado com o uso de parâmetros no estilo MCALL.Calls a stored procedure taking MCALL style parameters. Para usar esse método de replicação, use schema_option para especificar a criação automática do procedimento armazenado, ou criar o procedimento armazenado especificado no banco de dados de destino de cada assinante do artigo.To use this method of replication, use schema_option to specify automatic creation of the stored procedure, or create the specified stored procedure in the destination database of each Subscriber of the article. custom_stored_procedure é o nome de um procedimento armazenado criado pelo usuário.custom_stored_procedure is the name of a user-created stored procedure. sp_msupd _ * tabela* contém o nome da tabela de destino em vez do _table parte do parâmetro.sp_MSupd_*table* contains the name of the destination table in place of the _table part of the parameter. Quando destination_owner for especificado, ele é anexado ao nome da tabela de destino.When destination_owner is specified, it is prepended to the destination table name. Por exemplo, para o ProductCategory tabela pertencentes a produção esquema no assinante, o parâmetro seria MCALL sp_MSupd_ProductionProductCategory.For example, for the ProductCategory table owned by the Production schema at the Subscriber, the parameter would be MCALL sp_MSupd_ProductionProductCategory. Para um artigo em uma topologia de replicação ponto a ponto, _table é acrescentado com um valor de GUID.For an article in a peer-to-peer replication topology, _table is appended with a GUID value. Não é permitido especificar um procedimento armazenado para atualizar assinantes.Specifying a user-created stored procedure is not allowed for updating subscribers.
SCALL sp_msupd _SCALL sp_MSupd_
tabela (padrão)table (default)

-ou--or-

SCALL custom_stored_procedure_nameSCALL custom_stored_procedure_name
Chama um procedimento armazenado com o uso de parâmetros no estilo SCALL.Calls a stored procedure taking SCALL style parameters. Para usar esse método de replicação, use schema_option para especificar a criação automática do procedimento armazenado, ou criar o procedimento armazenado especificado no banco de dados de destino de cada assinante do artigo.To use this method of replication, use schema_option to specify automatic creation of the stored procedure, or create the specified stored procedure in the destination database of each Subscriber of the article. custom_stored_procedure é o nome de um procedimento armazenado criado pelo usuário.custom_stored_procedure is the name of a user-created stored procedure. sp_msupd _ * tabela* contém o nome da tabela de destino em vez do _table parte do parâmetro.sp_MSupd_*table* contains the name of the destination table in place of the _table part of the parameter. Quando destination_owner for especificado, ele é anexado ao nome da tabela de destino.When destination_owner is specified, it is prepended to the destination table name. Por exemplo, para o ProductCategory tabela pertencentes a produção esquema no assinante, o parâmetro seria SCALL sp_MSupd_ProductionProductCategory.For example, for the ProductCategory table owned by the Production schema at the Subscriber, the parameter would be SCALL sp_MSupd_ProductionProductCategory. Para um artigo em uma topologia de replicação ponto a ponto, _table é acrescentado com um valor de GUID.For an article in a peer-to-peer replication topology, _table is appended with a GUID value. Não é permitido especificar um procedimento armazenado para atualizar assinantes.Specifying a user-created stored procedure is not allowed for updating subscribers.
Sp_msupd _ XCALLXCALL sp_MSupd_
tabletable

-ou--or-

Custom_stored_procedure_name XCALLXCALL custom_stored_procedure_name
Chama um procedimento armazenado com o uso de parâmetros no estilo XCALL.Calls a stored procedure taking XCALL style parameters. Para usar esse método de replicação, use schema_option para especificar a criação automática do procedimento armazenado, ou criar o procedimento armazenado especificado no banco de dados de destino de cada assinante do artigo.To use this method of replication, use schema_option to specify automatic creation of the stored procedure, or create the specified stored procedure in the destination database of each Subscriber of the article. Não é permitido especificar um procedimento armazenado para atualizar assinantes.Specifying a user-created stored procedure is not allowed for updating subscribers.
SQL ou nuloSQL or NULL Replica uma instrução UPDATE.Replicates an UPDATE statement. A instrução UPDATE é fornecida em todos os valores de coluna e os valores de coluna de chave primária.The UPDATE statement is provided on all column values and the primary key column values. Esse comando é replicado em atualizações:This command is replicated on updates:

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

Observação

A sintaxe de CALL, MCALL, SCALL e XCALL varia a quantidade de dados propagada ao assinante.The CALL, MCALL, SCALL, and XCALL syntax vary the amount of data propagated to the subscriber. A sintaxe de CALL passa todos os valores para todas as colunas inseridas e excluídas.The CALL syntax passes all values for all inserted and deleted columns. A sintaxe de SCALL passa valores apenas para as colunas afetadas.The SCALL syntax passes values only for affected columns. A sintaxe de XCALL passa valores para todas as colunas, alteradas ou não, inclusive o valor anterior da coluna.The XCALL syntax passes values for all columns, whether changed or not, including the previous value of the column. Para obter mais informações, consulte Especificar como as alterações são propagadas para artigos transacionais.For more information, see Specify How Changes Are Propagated for Transactional Articles.

[ @creation_script =] 'creation_script'[ @creation_script =] 'creation_script'
Corresponde ao caminho e ao nome de um script de esquema de artigo opcional usados para criar o artigo no banco de dados de assinatura.Is the path and name of an optional article schema script used to create the article in the subscription database. creation_script é nvarchar (255), com um padrão NULL.creation_script is nvarchar(255), with a default of NULL.

[ @description =] 'descrição'[ @description =] 'description'
É uma entrada descritiva para o artigo.Is a descriptive entry for the article. Descrição é nvarchar (255), com um padrão NULL.description is nvarchar(255), with a default of NULL.

[ @pre_creation_cmd =] 'pre_creation_cmd'[ @pre_creation_cmd =] 'pre_creation_cmd'
Especifica o que o sistema deve fazer se detectar um objeto existente com o mesmo nome no assinante, ao aplicar o instantâneo para esse artigo:Specifies what the system should do if it detects an existing object of the same name at the subscriber when applying the snapshot for this article. pre_creation_cmd é nvarchar (10), e pode ser um dos valores a seguir.pre_creation_cmd is nvarchar(10), and can be one of the following values.

ValueValue DescriptionDescription
Nenhumnone Não usa um comando.Does not use a command.
deletedelete Exclui dados da tabela de destino antes de aplicar o instantâneo.Deletes data from the destination table before applying the snapshot. Quando o artigo é filtrado horizontalmente, apenas dados em colunas especificadas pela cláusula de filtro são excluídos.When the article is horizontally filtered, only data in columns specified by the filter clause is deleted. Não há suporte para Publicadores Oracle quando um filtro horizontal está definido.Not supported for Oracle Publishers when a horizontal filter is defined.
Descartar (padrão)drop (default) Descarta a tabela de destino.Drops the destination table.
Truncartruncate Trunca a tabela de destino.Truncates the destination table. Não é válido para assinantes ODBC ou OLE DB.Is not valid for ODBC or OLE DB Subscribers.

[ @filter_clause=] 'filter_clause'[ @filter_clause=] 'filter_clause'
É uma cláusula de restrição (WHERE) que define um filtro horizontal.Is a restriction (WHERE) clause that defines a horizontal filter. Ao inserir a cláusula de restrição, omita a palavra-chave onde.When entering the restriction clause, omit the keyword WHERE. filter_clause é ntext, com um padrão NULL.filter_clause is ntext, with a default of NULL. Para obter mais informações, consulte Filter Published Data (Filtrar dados publicados).For more information, see Filter Published Data.

[ @schema_option =] schema_option[ @schema_option =] schema_option
É um bitmask da opção de geração de esquema para o artigo determinado.Is a bitmask of the schema generation option for the given article. schema_option é binary (8) e pode ser o | (OR bit a bit) produto de um ou mais desses valores:schema_option is binary(8), and can be the | (Bitwise OR) product of one or more of these values:

Observação

Se esse valor for NULL, o sistema gerará automaticamente uma opção de esquema válida para o artigo dependendo de outras propriedades do artigo.If this value is NULL, the system auto-generates a valid schema option for the article depending on other article properties. O opções de esquema padrão tabela na seção comentários mostra o valor será escolhido com base na combinação de tipo de artigo e o tipo de replicação.The Default Schema Options table given in the Remarks shows the value that will be chosen based upon the combination of the article type and the replication type.

ValueValue DescriptionDescription
0x000x00 Desabilita a execução de script pelo Snapshot Agent e usa creation_script.Disables scripting by the Snapshot Agent and uses creation_script.
0x010x01 Gera o script de criação de objeto (CREATE TABLE, CREATE PROCEDURE e assim por diante).Generates the object creation script (CREATE TABLE, CREATE PROCEDURE, and so on). Esse valor é o padrão para artigos de procedimento armazenado.This value is the default for stored procedure articles.
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 timestamp colunas.Replicate timestamp columns. Se não for definido, timestamp colunas são replicadas como binário.If not set, timestamp columns are replicated as binary.
0x100x10 Gera um índice clusterizado correspondente.Generates a corresponding clustered index. Mesmo que essa opção não esteja definida, os índices relacionados às chaves primárias e às restrições exclusivas serão gerados caso já estejam definidos em uma tabela publicada.Even if this option is not set, indexes related to primary keys and unique constraints are generated if they are already defined on a published table.
0x200x20 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. Não há suportada para editores Oracle.Not supported for Oracle Publishers.
0x400x40 Gera índices não clusterizados correspondentes.Generates corresponding nonclustered indexes. Mesmo que essa opção não esteja definida, os índices relacionados às chaves primárias e às restrições exclusivas serão gerados caso já estejam definidos em uma tabela publicada.Even if this option is not set, indexes related to primary keys and unique constraints are generated if they are already defined on a published table.
0x800x80 Replica restrições de chave primária.Replicates primary key constraints. Quaisquer índices relacionadas à restrição também são replicados, mesmo se opções 0x10 e 0x40 não estão habilitados.Any indexes related to the constraint are also replicated, even if options 0x10 and 0x40 are not enabled.
0x1000x100 Replica gatilhos de usuário em um artigo de tabela, se definido.Replicates user triggers on a table article, if defined. Não há suportada para editores Oracle.Not supported for Oracle Publishers.
0x2000x200 Replica restrições de chave estrangeira.Replicates foreign key constraints. Se a tabela referenciada não for parte de uma publicação, todas as restrições de chave estrangeira 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. Não há suportada para editores Oracle.Not supported for Oracle Publishers.
0x4000x400 Replica restrições de verificação.Replicates check constraints. Não há suportada para editores Oracle.Not supported for Oracle Publishers.
0x8000x800 Replica padrões.Replicates defaults. Não há suportada para editores Oracle.Not supported for Oracle Publishers.
0x10000x1000 Replica agrupamento em nível de coluna.Replicates column-level collation.

Observação: essa opção deve ser definida para Publicadores Oracle para habilitar comparações diferencia maiusculas de minúsculas.Note: This option should be set for Oracle Publishers to enable case-sensitive comparisons.
0x20000x2000 Replica propriedades estendidas associadas com o objeto de origem do artigo publicado.Replicates extended properties associated with the published article source object. Não há suportada para editores Oracle.Not supported for Oracle Publishers.
0x40000x4000 Replica restrições UNIQUE.Replicates UNIQUE constraints. Quaisquer índices relacionadas à restrição também são replicados, mesmo se opções 0x10 e 0x40 não estão habilitados.Any indexes related to the constraint are also replicated, even if options 0x10 and 0x40 are not enabled.
0x80000x8000 Esta opção não é válida para Publicadores SQL Server 2005SQL Server 2005.This option is not valid for SQL Server 2005SQL Server 2005 Publishers.
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 Coleções de esquemas XML associada a xml colunas não são replicadas.XML schema collections bound to xml columns are not replicated.
0x40000000x4000000 Replica índices em xml colunas.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 xml colunas ntext no assinante.Converts xml columns to ntext on the Subscriber.
0x200000000x20000000 Converte tipos de dados objeto grande (nvarchar (max), varchar (max), e varbinary (max)) introduzido no SQL Server 2005SQL Server 2005 para tipos de dados que têm suporte em SQL Server 2000 (8.x)SQL Server 2000 (8.x).Converts large object data types (nvarchar(max), varchar(max), and varbinary(max)) 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 permissões.Replicate permissions.
0x800000000x80000000 Tentativa de remover 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 for especificado em varbinary (max) colunas.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 2005SQL Server 2005.Do not specify this option if you are replicating tables to SQL Server 2005SQL Server 2005 Subscribers. Replicação de tabelas com colunas FILESTREAM para SQL Server 2000 (8.x)SQL Server 2000 (8.x) assinantes não tem suporte, independentemente de como essa opção de esquema é 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 tipos de dados de data e hora (data, tempo, datetimeoffset, e datetime2) introduzido no SQL Server 2008SQL Server 2008 aos dados tipos com suporte em versões anteriores do SQL ServerSQL Server.Converts date and time data types (date, time, datetimeoffset, and datetime2) introduced in SQL Server 2008SQL Server 2008 to data types that are supported on earlier versions of SQL ServerSQL Server.
0x4000000000x400000000 Replica a opção de compactação para dados e índices.Replicates the compression option for data and indexes. Para obter mais informações, consulte 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 após a aplicação do instantâneo.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 tipos common language runtime (CLR) definidos pelo usuário (UDTs) maiores que 8000 bytes em varbinary (max) para que as colunas do tipo UDT possam ser replicadas para os assinantes que executam o SQL Server 2005SQL Server 2005.Converts common language runtime (CLR) user-defined types (UDTs) that are larger than 8000 bytes to varbinary(max) so that columns of type UDT can be replicated to Subscribers that are running SQL Server 2005SQL Server 2005.
0x20000000000x2000000000 Converte o hierarchyid tipo de dados varbinary (max) para que colunas do tipo hierarchyid podem ser replicadas para assinantes que executam o 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. Para obter mais informações sobre como usar hierarchyid colunas 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 o geografia e geometria para tipos de dados varbinary (max) para que colunas desses tipos podem ser replicadas para assinantes que executam o 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 índices em colunas do tipo geografia e geometria.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 snapshot agent 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 um í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.
0x4000000000000x400000000000 Replica qualquer índice não clusterizado columnstore em tabelas deReplicates any non-clustered columnstore indexes on the table(s)
0x8000000000000x800000000000 Replica qualquer índice de columnstore não clusterizado flitered sobre as tabelas.Replicates any flitered non-clustered columnstore indexes on the table(s).
NULLNULL A replicação define automaticamente schema_option para um valor padrão, o valor do qual depende de outras propriedades do artigo.Replication automatically sets schema_option to a default value, the value of which depends on other article properties. A tabela "Opções de Esquema Padrão" na seção Observações mostra as opções de esquema padrão com base no tipo de artigo e tipo de replicação.The "Default Schema Options" table in the Remarks section shows the default schema options based on article type and replication type.

O padrão de não - SQL ServerSQL Server publicações é 0x050D3.The default for non- SQL ServerSQL Server publications is 0x050D3.

Nem todos os schema_option valores são válidos para cada tipo de replicação e tipo de artigo.Not all schema_option values are valid for every type of replication and article type. O opções de esquema válido tabela na seção comentários mostra as opções de esquema válido que podem ser escolhidas com base na combinação de tipo de artigo e o tipo de replicação.The Valid Schema Options table in the Remarks section shows the valid schema options that can be chosen based upon the combination of the article type and the replication type.

[ @destination_owner =] 'destination_owner'[ @destination_owner =] 'destination_owner'
É o nome do proprietário do objeto de destino.Is the name of the owner of the destination object. destination_owner é sysname, com um padrão NULL.destination_owner is sysname, with a default of NULL. Quando destination_owner não for especificado, o proprietário é especificado automaticamente com base nas seguintes regras:When destination_owner is not specified, the owner is specified automatically based on the following rules:

CondiçãoCondition Proprietário do objeto de destinoDestination object owner
Publicação usa a cópia em massa do modo nativo para gerar o instantâneo inicial que só aceita assinantes SQL ServerSQL Server.Publication uses native-mode bulk copy to generate the initial snapshot, which only supports SQL ServerSQL Server Subscribers. O valor padrão é source_owner.Defaults to the value of source_owner.
Publicado a partir de um não publicador SQL ServerSQL Server.Published from a non- SQL ServerSQL Server Publisher. Assume o proprietário do banco de dados de destino como padrão.Defaults to the owner of the destination database.
A publicação usa a cópia em massa do modo de caractere para gerar o instantâneo inicial que só aceita assinantes SQL ServerSQL Server.Publication uses character-mode bulk copy to generate the initial snapshot, which supports non- SQL ServerSQL Server Subscribers. Não atribuído.Not assigned.

Para dar suporte a não - SQL ServerSQL Server assinantes, destination_owner deve ser NULL.To support non- SQL ServerSQL Server Subscribers, destination_owner must be NULL.

[ @status=] status[ @status=] status
Especifica se o artigo está ativo e opções adicionais sobre como as alterações são propagadas.Specifies if the article is active and additional options for how changes are propagated. status é tinyinte pode ser o | (OR bit a bit) produto de um ou mais desses valores.status is tinyint, and can be the | (Bitwise OR) product of one or more of these values.

ValueValue DescriçãoDescription
11 O artigo está ativo.Article is active.
88 Inclui o nome da coluna nas instruções INSERT.Includes the column name in INSERT statements.
16 (padrão)16 (default) Usa instruções parametrizadas.Uses parameterized statements.
2424 Inclui o nome da coluna nas instruções INSERT e usa instruções parametrizadas.Includes the column name in INSERT statements and uses parameterized statements.
6464 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.

Por exemplo, um artigo ativo que usa instruções com parâmetros teria um valor 17 nessa coluna.For example, an active article using parameterized statements would have a value of 17 in this column. Um valor de 0 significa que o artigo está inativo e nenhuma propriedade adicional está definida.A value of 0 means that the article is inactive and no additional properties are defined.

[ @source_owner =] 'source_owner'[ @source_owner =] 'source_owner'
É o proprietário do objeto de origem.Is the owner of the source object. source_owner é sysname, com um padrão NULL.source_owner is sysname, with a default of NULL. source_owner deve ser especificado para editores Oracle.source_owner must be specified for Oracle Publishers.

[ @sync_object_owner =] 'sync_object_owner'[ @sync_object_owner =] 'sync_object_owner'
É o proprietário da exibição que define o artigo publicado.Is the owner of the view that defines the published article. sync_object_owner é sysname, com um padrão NULL.sync_object_owner is sysname, with a default of NULL.

[ @filter_owner =] 'filter_owner'[ @filter_owner =] 'filter_owner'
É o proprietário do filtro.Is the owner of the filter. filter_owner é sysname, com um padrão NULL.filter_owner is sysname, with a default of NULL.

[ @source_object =] 'source_object'[ @source_object =] 'source_object'
É o objeto de banco de dados a ser publicado.Is the database object to be published. source_object é sysname, com um padrão NULL.source_object is sysname, with a default of NULL. Se source_table for NULL, source_object não pode ser NULL. source_object deve ser usado em vez de source_table.If source_table is NULL, source_object cannot be NULL.source_object should be used instead of source_table. Para obter mais informações sobre os tipos de objetos que podem ser publicados usando replicação de instantâneo ou transacional, consulte publicar dados e objetos de banco de dados.For more information about the types of objects that can be published using snapshot or transactional replication, see Publish Data and Database Objects.

[ @artid = ] article_ID saída[ @artid = ] article_ID OUTPUT
É a ID do artigo do novo artigo.Is the article ID of the new article. article_ID é int com um padrão de NULL e é um parâmetro de saída.article_ID is int with a default of NULL, and it is an OUTPUT parameter.

[ @auto_identity_range = ] 'auto_identity_range'[ @auto_identity_range = ] 'auto_identity_range'
Habilita e desabilita o intervalo de identidade automática em uma publicação no momento em que ela é criada.Enables and disables automatic identity range handling on a publication at the time it is created. auto_identity_range é nvarchar (5), e pode ser um dos seguintes valores:auto_identity_range is nvarchar(5), and can be one of the following values:

ValueValue DescriptionDescription
truetrue Ativa a manipulação de intervalo de identidade automática.Enables automatic identity range handling
falsefalse Desabilita a manipulação de intervalo de identidade automática.Disables automatic identity range handling
NULL(default)NULL(default) Tratamento de intervalo de identidade é definido por identityrangemanagementoption.Identity range handling is set by identityrangemanagementoption.

Observação

auto_identity_range foi preterido e é fornecida para compatibilidade com versões anteriores apenas.auto_identity_range has been deprecated and is provided for backward compatibility only. Você deve usar identityrangemanagementoption para especificar opções de gerenciamento de intervalo de identidade.You should use identityrangemanagementoption for specifying identity range management options. Para obter mais informações, consulte Replicar colunas de identidade.For more information, see Replicate Identity Columns.

[ @pub_identity_range = ] pub_identity_range[ @pub_identity_range = ] pub_identity_range
Controla o tamanho do intervalo no publicador se o artigo tiver identityrangemanagementoption definida como automática ou auto_identity_range definida como true .Controls the range size at the Publisher if the article has identityrangemanagementoption set to auto or auto_identity_range set to true. pub_identity_range é bigint, com um padrão NULL.pub_identity_range is bigint, with a default of NULL. Não há suportada para editores Oracle.Not supported for Oracle Publishers.

[ @identity_range = ] identity_range[ @identity_range = ] identity_range
Controla o tamanho do intervalo no assinante se o artigo tiver identityrangemanagementoption definida como automática ou auto_identity_range definida como true .Controls the range size at the Subscriber if the article has identityrangemanagementoption set to auto or auto_identity_range set to true. identity_range é bigint, com um padrão NULL.identity_range is bigint, with a default of NULL. Usado quando auto_identity_range é definido como true.Used when auto_identity_range is set to true. Não há suportada para editores Oracle.Not supported for Oracle Publishers.

[ @threshold = ] limite[ @threshold = ] threshold
É o valor percentual que controla quando o Distribution Agent atribui um novo intervalo de identidade.Is the percentage value that controls when the Distribution Agent assigns a new identity range. Quando a porcentagem de valores especificada em limite é usado, o agente de distribuição cria um novo intervalo de identidade.When the percentage of values specified in threshold is used, the Distribution Agent creates a new identity range. limite de é bigint, com um padrão NULL.threshold is bigint, with a default of NULL. Usado quando identityrangemanagementoption é definido como automática ou auto_identity_range é definido como true.Used when identityrangemanagementoption is set to auto or auto_identity_range is set to true. Não há suportada para editores Oracle.Not supported for Oracle Publishers.

[ @force_invalidate_snapshot = ] force_invalidate_snapshot[ @force_invalidate_snapshot = ] force_invalidate_snapshot
Confirma que a ação tomada por esse procedimento armazenado pode invalidar um instantâneo existente.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 a adição de um artigo não faz com que o instantâneo seja inválido.0 specifies that adding an article does not cause the snapshot to be invalid. Se o procedimento armazenado detectar que a alteração exige um novo instantâneo, ocorrerá um erro e nenhuma alteração será feita.If the stored procedure detects that the change requires a new snapshot, an error occurs and no changes are made.

1 Especifica que a adição de um artigo pode invalidar o instantâneo e, se houver assinaturas que exigem um novo instantâneo, dará permissão para que o instantâneo existente seja marcado como obsoleto e um novo instantâneo seja gerado.1 specifies that adding an article may cause the snapshot to be invalid, and if subscriptions exist that would require a new snapshot, gives permission for the existing snapshot to be marked as obsolete and a new snapshot to be generated.

[ @use_default_datatypes = ] use_default_datatypes[ @use_default_datatypes = ] use_default_datatypes
É se os mapeamentos de tipo de dados de coluna padrão são usados ao publicar um artigo de um Publicador Oracle.Is whether the default column data type mappings are used when publishing an article from an Oracle Publisher. use_default_datatypes é bit, com um padrão de 1.use_default_datatypes is bit, with a default of 1.

1 = a coluna de artigo padrão são usados mapeamentos.1 = the default article column mappings are used. Os mapeamentos de tipo de dados padrão podem ser exibidos executando sp_getdefaultdatatypemapping.The default data type mappings can be displayed by executing sp_getdefaultdatatypemapping.

0 = coluna de artigo personalizados mapeamentos são definidos, e, portanto, sp_articleview não é chamado por sp_addarticle.0 = custom article column mappings are defined, and therefore sp_articleview is not called by sp_addarticle.

Quando use_default_datatypes é definido como 0, você deve executar sp_changearticlecolumndatatype uma vez para cada mapeamento de coluna que está sendo alterado do padrão.When use_default_datatypes is set to 0, you must execute sp_changearticlecolumndatatype once for each column mapping being changed from the default. Depois que todos os mapeamentos de coluna personalizados tiverem sido definidos, você deve executar sp_articleview.After all custom column mappings have been defined, you must execute sp_articleview.

Observação

Esse parâmetro só deve ser usado para Publicadores Oracle.This parameter should only be used for Oracle Publishers. Configuração use_default_datatypes para 0 para um SQL ServerSQL Server publicador gera um erro.Setting use_default_datatypes to 0 for a SQL ServerSQL Server Publisher generates an error.

[ @identityrangemanagementoption = ] identityrangemanagementoption[ @identityrangemanagementoption = ] identityrangemanagementoption
Especifica como o gerenciamento de intervalo de identidade é tratado para o artigo.Specifies how identity range management is handled for the article. identityrangemanagementoption é nvarchar (10), e pode ser um dos valores a seguir.identityrangemanagementoption is nvarchar(10), and can be one of the following values.

ValueValue DescriptionDescription
Nenhumnone A replicação não faz nenhum gerenciamento de intervalo de identidade explícito.Replication does no explicit identity range management. Essa opção só é recomendada para compatibilidade com versões anteriores do SQL Server.This option is recommended only for backwards compatibility with earlier versions of SQL Server. Não permitido para replicação hierárquica.Not allowed for peer replication.
Manualmanual Marca a coluna de identidade usando NOT FOR REPLICATION para ativar tratamento de intervalo de identidade manual.Marks the identity column using NOT FOR REPLICATION to enable manual identity range handling.
Automáticoauto Especifica o gerenciamento automático de intervalos de identidade.Specifies automatic management of identity ranges.
NULL(default)NULL(default) O padrão será a nenhum quando o valor de auto_identity_range não é true.Defaults to none when the value of auto_identity_range is not true. O padrão será a manual em um padrão de topologia ponto a ponto (auto_identity_range é ignorado).Defaults to manual in a peer-to-peer topology default (auto_identity_range is ignored).

Para compatibilidade com versões anteriores, quando o valor de identityrangemanagementoption for NULL, o valor de auto_identity_range é verificada.For backward compatibility, when the value of identityrangemanagementoption is NULL, the value of auto_identity_range is checked. No entanto, quando o valor de identityrangemanagementoption não é nulo, então o valor de auto_identity_range será ignorado.However, when the value of identityrangemanagementoption is not NULL, then the value of auto_identity_range is ignored.

Para obter mais informações, consulte Replicar colunas de identidade.For more information, see Replicate Identity Columns.

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

Observação

publicador não deve ser usado ao adicionar um artigo para um SQL ServerSQL Server publicador.publisher should not be used when adding an article to a SQL ServerSQL Server Publisher.

[ @fire_triggers_on_snapshot = ] 'fire_triggers_on_snapshot'[ @fire_triggers_on_snapshot = ] 'fire_triggers_on_snapshot'
Se os gatilhos de usuário replicados forem executados quando o instantâneo inicial for aplicado.Is if replicated user triggers are executed when the initial snapshot is applied. fire_triggers_on_snapshot é nvarchar (5), com um padrão de FALSE.fire_triggers_on_snapshot is nvarchar(5), with a default of FALSE. True significa que os gatilhos de usuário em uma tabela replicada são executados quando o instantâneo é aplicado.true means that user triggers on a replicated table are executed when the snapshot is applied. Para gatilhos a serem replicados, o valor de máscara de bits de schema_option deve incluir o valor 0x100.In order for triggers to be replicated, the bitmask value of schema_option must include the value 0x100.

Valores do código de retornoReturn Code Values

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

RemarksRemarks

sp_addarticle é usado em replicação de instantâneo ou replicação transacional.sp_addarticle is used in snapshot replication or transactional replication.

Por padrão, a replicação não publica quaisquer colunas na tabela de origem quando o tipo de dados de coluna não tiver suporte pela replicação.By default, replication does not publish any columns in the source table when the column data type is not supported by replication. Se você precisar publicar essa coluna, você deve executar sp_articlecolumn para adicionar a coluna.If you need to publish such a column, you must execute sp_articlecolumn to add the column.

Ao adicionar um artigo a uma publicação que oferece suporte à replicação transacional não hierárquica, as seguintes restrições se aplicam:When adding an article to a publication that supports peer-to-peer transactional replication, the following restrictions apply:

  • Devem ser especificadas instruções parametrizadas para todos os artigos com base em log.Parameterized statements must be specified for all logbased articles. Você deve incluir 16 no status valor.You must include 16 in the status value.

  • O nome e proprietário da tabela de destino devem corresponder à tabela de origem.Name and owner of the destination table must match the source table.

  • O artigo não pode ser filtrado horizontal ou verticalmente.The article cannot be filtered horizontally or vertically.

  • Não há suporte para o gerenciamento de intervalo de identidade automática.Automatic identity range management is not supported. Você deve especificar um valor de manual para identityrangemanagementoption.You must specify a value of manual for identityrangemanagementoption.

  • Se um timestamp coluna existe na tabela, você deve incluir 0x08 na schema_option para replicar a coluna como timestamp.If a timestamp column exists in the table, you must include 0x08 in schema_option to replicate the column as timestamp.

  • Um valor de SQL não pode ser especificado para ins_cmd, upd_cmd, e del_cmd.A value of SQL cannot be specified for ins_cmd, upd_cmd, and del_cmd.

    Para obter mais informações, consulte Peer-to-Peer Transactional Replication.For more information, see Peer-to-Peer Transactional Replication.

    Quando você publicar objetos, suas definições são copiadas aos Assinantes.When you publish objects, their definitions are copied to Subscribers. Se você estiver publicando um objeto de banco de dados que depende de outros objetos, precisará publicar todos os objetos referenciados.If you are publishing a database object that depends on one or more other objects, you must publish all referenced objects. Por exemplo, se você publicar uma exibição que depende de uma tabela, terá de publicar a tabela também.For example, if you publish a view that depends on a table, you must publish the table also.

    Se vertical_partition é definido como true, sp_addarticle adia a criação da exibição até sp_articleview é chamado (após a última sp_articlecolumn é adicionado).If vertical_partition is set to true, sp_addarticle defers the creation of the view until sp_articleview is called (after the last sp_articlecolumn is added).

    Se a publicação permite atualização de assinaturas e a tabela publicada não tiver um uniqueidentifier coluna, sp_addarticle adiciona um uniqueidentifier coluna para a tabela automaticamente.If the publication allows updating subscriptions and the published table does not have a uniqueidentifier column, sp_addarticle adds a uniqueidentifier column to the table automatically.

    Ao replicar para um assinante que não é uma instância de SQL ServerSQL Server (replicação heterogênea), somente Transact-SQLTransact-SQL instruções têm suporte para inserir, atualizaçãoe Excluir comandos.When replicating to a subscriber that is not an instance of SQL ServerSQL Server (heterogeneous replication), only Transact-SQLTransact-SQL statements are supported for INSERT, UPDATE, and DELETE commands.

    Quando o Agente de Leitor de Log estiver em execução, adicionar um artigo a uma publicação ponto a ponto poderá causar um deadlock entre o Agente de Leitor de Log e o processo que adiciona o artigo.When the log reader agent is running, adding an article to a peer-to-peer publication can cause a deadlock between the log reader agent and the process that adds the article. Para evitar esse problema, antes de adicionar um artigo a uma publicação ponto a ponto, use o Monitor de Replicação para interromper o Agente de Leitor de Log no nó onde você está adicionando o artigo.To avoid this issue, before adding an article to a peer-to-peer publication use the Replication Monitor to stop the log reader agent on the node where you are adding the article. Reinicie o Agente de Leitor de Log depois de adicionar o artigo.Restart the log reader agent after adding the article.

    Ao definir @del_cmd = 'NONE' ou @ins_cmd = 'NONE', a propagação de atualizar comandos também podem ser afetados por não enviar esses comandos quando ocorrer uma atualização limitada.When setting @del_cmd = 'NONE' or @ins_cmd = 'NONE', the propagation of UPDATE commands might also be affected by not sending those commands when a bounded update occurs. (A atualização limitada é o tipo de instrução UPDATE do publicador que se replica como um par DELETE/INSERT no assinante).(A bounded update is type of UPDATE statement from the publisher that replicates as a DELETE/INSERT pair on the subscriber.)

Opções de esquema padrãoDefault Schema Options

Esta tabela descreve o valor padrão definido pela replicação se schema_options não é especificado pelo usuário, em que esse valor depende do tipo de replicação (mostrados na parte superior) e o tipo de artigo (mostrado abaixo da primeira coluna).This table describes the default value set by replication if schema_options is not specified by the user, where this value depends on the replication type (shown across the top) and the article type (shown down the first column).

Tipo de artigoArticle type Tipo de replicaçãoReplication type
Transacional.Transactional InstantâneoSnapshot
somente esquema de agregaçãoaggregate schema only 0x010x01 0x010x01
somente esquema de funçãofunc schema only 0x010x01 0x010x01
somente o esquema de exibição indexadaindexed view schema only 0x010x01 0x010x01
modo de exibição indexado logbasedindexed view logbased 0x30F30x30F3 0x30710x3071
modo de exibição indexado logbase manualbothindexed view logbase manualboth 0x30F30x30F3 0x30710x3071
modo de exibição indexado logbased manualfilterindexed view logbased manualfilter 0x30F30x30F3 0x30710x3071
modo de exibição indexado logbased manualviewindexed view logbased manualview 0x30F30x30F3 0x30710x3071
logbasedlogbased 0x30F30x30F3 0x30710x3071
logbased manualfilterlogbased manualfilter 0x30F30x30F3 0x30710x3071
logbased manualviewlogbased manualview 0x30F30x30F3 0x30710x3071
proc execproc exec 0x010x01 0x010x01
somente esquema de PROCproc schema only 0x010x01 0x010x01
Serializable proc execserializable proc exec 0x010x01 0x010x01
somente o esquema de exibiçãoview schema only 0x010x01 0x010x01

Observação

Se uma publicação for habilitada para atualização em fila, um schema_option valor 0x80 é adicionado ao valor padrão mostrado na tabela.If a publication is enabled for queued updating, a schema_option value of 0x80 is added to the default value shown in the table. O padrão schema_option para um não SQL ServerSQL Server publicação é 0x050D3.The default schema_option for a non- SQL ServerSQL Server publication is 0x050D3.

Opções de esquema válidasValid Schema Options

Esta tabela descreve os valores permitidos de schema_option com base no tipo de replicação (mostrados na parte superior) e o tipo de artigo (mostrado abaixo da primeira coluna).This table describes the allowable values of schema_option based upon the replication type (shown across the top) and the article type (shown down the first column).

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
modo de exibição indexado logbasedindexed view logbased Todas as opçõesAll options Todas as opções, mas 0x02All options but 0x02
modo de exibição indexado logbased manualfilterindexed view logbased manualfilter Todas as opçõesAll options Todas as opções, mas 0x02All options but 0x02
modo de exibição indexado logbased manualviewindexed view logbased manualview Todas as opçõesAll options Todas as opções, mas 0x02All options but 0x02
modo de exibição indexado logbase 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, 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
somente esquema de PROCproc 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
somente o esquema de exibiçãoview 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
somente esquema de funçãofunc 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
somente o esquema de exibição indexadaindexed 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

Observação

Para publicações de atualização enfileiradas, o schema_option valores de 0x8000 e 0x80 deve ser habilitado.For queued updating publications, the schema_option values of 0x8000 and 0x80 must be enabled. Com o suporte schema_option valores não - SQL ServerSQL Server publicações são: 0x01, 0x02, 0x10, 0x40, 0x80, 0x1000, 0x4000 e 0X8000.The supported schema_option values for non- SQL ServerSQL Server publications are: 0x01, 0x02, 0x10, 0x40, 0x80, 0x1000, 0x4000 and 0X8000.

ExemploExample

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

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

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

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

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

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

PermissõesPermissions

Somente membros do sysadmin função de servidor fixa ou db_owner pode executar a função de banco de dados fixa sp_addarticle.Only members of the sysadmin fixed server role or db_owner fixed database role can execute sp_addarticle.

Consulte tambémSee Also

Define an Article Define an Article
sp_articlecolumn (Transact-SQL) sp_articlecolumn (Transact-SQL)
sp_articlefilter (Transact-SQL) sp_articlefilter (Transact-SQL)
sp_articleview (Transact-SQL) sp_articleview (Transact-SQL)
sp_changearticle (Transact-SQL) sp_changearticle (Transact-SQL)
sp_droparticle (Transact-SQL) sp_droparticle (Transact-SQL)
sp_helparticle (Transact-SQL) sp_helparticle (Transact-SQL)
sp_helparticlecolumns (Transact-SQL) sp_helparticlecolumns (Transact-SQL)
Procedimentos armazenados de replicação (Transact-SQL) Replication Stored Procedures (Transact-SQL)
Publicar dados e objetos de banco de dadosPublish Data and Database Objects