sp_addmergearticle (Transact-SQL)

Aplica-se a: SQL Server Instância Gerenciada de SQL do Azure

Adiciona um artigo a uma publicação existente Esse procedimento armazenado é executado no Publicador, no banco de dados publicador.

Convenções de sintaxe de Transact-SQL

Sintaxe

sp_addmergearticle
    [ @publication = ] N'publication'
    , [ @article = ] N'article'
    , [ @source_object = ] N'source_object'
    [ , [ @type = ] N'type' ]
    [ , [ @description = ] N'description' ]
    [ , [ @column_tracking = ] N'column_tracking' ]
    [ , [ @status = ] N'status' ]
    [ , [ @pre_creation_cmd = ] N'pre_creation_cmd' ]
    [ , [ @creation_script = ] N'creation_script' ]
    [ , [ @schema_option = ] schema_option ]
    [ , [ @subset_filterclause = ] N'subset_filterclause' ]
    [ , [ @article_resolver = ] N'article_resolver' ]
    [ , [ @resolver_info = ] N'resolver_info' ]
    [ , [ @source_owner = ] N'source_owner' ]
    [ , [ @destination_owner = ] N'destination_owner' ]
    [ , [ @vertical_partition = ] N'vertical_partition' ]
    [ , [ @auto_identity_range = ] N'auto_identity_range' ]
    [ , [ @pub_identity_range = ] pub_identity_range ]
    [ , [ @identity_range = ] identity_range ]
    [ , [ @threshold = ] threshold ]
    [ , [ @verify_resolver_signature = ] verify_resolver_signature ]
    [ , [ @destination_object = ] N'destination_object' ]
    [ , [ @allow_interactive_resolver = ] N'allow_interactive_resolver' ]
    [ , [ @fast_multicol_updateproc = ] N'fast_multicol_updateproc' ]
    [ , [ @check_permissions = ] check_permissions ]
    [ , [ @force_invalidate_snapshot = ] force_invalidate_snapshot ]
    [ , [ @published_in_tran_pub = ] N'published_in_tran_pub' ]
    [ , [ @force_reinit_subscription = ] force_reinit_subscription ]
    [ , [ @logical_record_level_conflict_detection = ] N'logical_record_level_conflict_detection' ]
    [ , [ @logical_record_level_conflict_resolution = ] N'logical_record_level_conflict_resolution' ]
    [ , [ @partition_options = ] partition_options ]
    [ , [ @processing_order = ] processing_order ]
    [ , [ @subscriber_upload_options = ] subscriber_upload_options ]
    [ , [ @identityrangemanagementoption = ] N'identityrangemanagementoption' ]
    [ , [ @delete_tracking = ] N'delete_tracking' ]
    [ , [ @compensate_for_errors = ] N'compensate_for_errors' ]
    [ , [ @stream_blob_columns = ] N'stream_blob_columns' ]
[ ; ]

Argumentos

@publication [ = ] N'publicação'

O nome da publicação que contém o artigo. @publication é sysname, sem padrão.

@article [ = ] N'artigo'

O nome do artigo. O nome deve ser exclusivo na publicação. @article é sysname, sem padrão. @article deve estar no computador local que executa o SQL Server e deve estar em conformidade com as regras de identificadores.

@source_object [ = ] N'source_object'

O objeto de banco de dados a ser publicado. @source_object é sysname, sem padrão. Para obter mais informações sobre os tipos de objetos que podem ser publicados usando a replicação de mesclagem, consulte Publicar dados e objetos de banco de dados.

@type [ = ] N'tipo'

O tipo de artigo. @type é sysname, com um padrão de table, e pode ser um dos seguintes valores.

@description [ = ] N'descrição'

Uma descrição do artigo. @description é nvarchar(255), com um padrão de NULL.

@column_tracking [ = ] N'column_tracking'

A configuração para o acompanhamento no nível da coluna. @column_tracking é nvarchar(10), com um padrão de false. false Ativa o rastreamento de colunas. false Desativa o rastreamento de coluna e deixa a detecção de conflitos no nível da linha. Se a tabela já tiver sido publicada em outras publicações de mesclagem, o controle da coluna deverá ser o mesmo que o valor usado por artigos existentes com base nessa tabela. Esse parâmetro só é específico a artigos de tabela.

@status [ = ] N'status'

O status do artigo. @status é nvarchar(10), com um padrão de unsynced. Se active, o script de processamento inicial para publicar a tabela será executado. Se unsynced, o script de processamento inicial para publicar a tabela será executado na próxima vez que o Snapshot Agent for executado.

@pre_creation_cmd [ = ] N'pre_creation_cmd'

Especifica o que o sistema deve fazer se a tabela existe no assinante quando aplicar o instantâneo. @pre_creation_cmd é nvarchar(10) e pode ser um dos seguintes valores.

@creation_script [ = ] N'creation_script'

O caminho e o nome de um script de esquema de artigo opcional usado para criar o artigo no banco de dados de assinatura. @creation_script é nvarchar(255), com um padrão de NULL.

@schema_option [ = ] schema_option

Um bitmap da opção de geração de esquema para o artigo fornecido. @schema_option é varbinary(8) e pode ser o | (OU bit a bit) produto de um ou mais desses valores.

Se esse valor for NULL, o sistema gerará automaticamente uma opção de esquema válida para o artigo. A tabela de opções de esquema padrão mostra o valor escolhido com base no tipo de artigo. Além disso, nem todos os valores @schema_option são válidos para todos os tipos de replicação e tipo de artigo. A tabela de opções de esquema válido mostra as opções que podem ser especificadas para um determinado tipo de artigo.

@subset_filterclause [ = ] N'subset_filterclause'

Uma cláusula WHERE especificando a filtragem horizontal de um artigo de tabela sem a palavra WHERE incluída. @subset_filterclause é nvarchar(1000), com um padrão de uma cadeia de caracteres vazia.

@article_resolver [ = ] N'article_resolver'

O resolvedor baseado em COM usado para resolver conflitos no artigo da tabela ou o assembly do .NET Framework invocado para executar a lógica de negócios personalizada no artigo da tabela. @article_resolver é nvarchar(255), com um padrão de NULL. Os valores disponíveis para esse parâmetro estão listados em Resolvedores Personalizados da Microsoft. Se o valor fornecido não for um dos resolvedores da Microsoft, o SQL Server usará o resolvedor especificado em vez do resolvedor fornecido pelo sistema. Use sp_enumcustomresolvers para enumerar a lista de resolvedores personalizados disponíveis. Para obter mais informações, consulte Executar lógica de negócios durante a sincronização de mesclagem e Replicação de mesclagem avançada - Detecção e resolução de conflitos.

@resolver_info [ = ] N'resolver_info'

Usado para especificar informações adicionais exigidas por um resolvedor personalizado. Alguns dos Resolvedores da Microsoft exigem uma coluna fornecida como entrada para o resolvedor. @resolver_info é nvarchar(517), com um padrão de NULL. Para obter mais informações, consulte Conflito avançado de replicação de mesclagem – Resolvedores baseados em COM.

@source_owner [ = ] N'source_owner'

O nome do proprietário do @source_object. @source_owner é sysname, com um padrão de NULL. Se NULL, o usuário atual é considerado o proprietário.

@destination_owner [ = ] N'destination_owner'

O proprietário do objeto no banco de dados de assinatura, se não dbo. @destination_owner é sysname, com um padrão de NULL. Se NULL, dbo é considerado o proprietário.

@vertical_partition [ = ] N'vertical_partition'

Habilita e desabilita a filtragem de coluna em um artigo de tabela. @vertical_partition é nvarchar(5), com um padrão de false.

• false indica que não há filtragem vertical e publica todas as colunas.

• false Limpa todas as colunas, exceto a chave primária e ROWGUID as colunas declaradas. As colunas são adicionadas usando sp_mergearticlecolumn.

@auto_identity_range [ = ] N'auto_identity_range'

Habilita e desabilita a manipulação automática de intervalo de identidade para este artigo de tabela em uma publicação no momento em que ela é criada. @auto_identity_range é nvarchar(5), com um padrão de NULL. false Habilita o tratamento automático do intervalo de identidade, enquanto false o desabilita.

@pub_identity_range [ = ] pub_identity_range

Controla o tamanho do intervalo de identidades alocado a um Assinante com assinatura de servidor quando o gerenciamento automático do intervalo de identidades for usado. Esse intervalo de identidade é reservado para um Assinante de republicação para ser alocado a seus próprios Assinantes. @pub_identity_range é bigint, com um padrão de NULL. Você deve especificar esse parâmetro se @identityrangemanagementoption for auto ou se @auto_identity_range for false.

@identity_range [ = ] identity_range

Controla o tamanho do intervalo de identidades alocado ao Publicador e ao Assinante quando o gerenciamento automático do intervalo é usado. @identity_range é bigint, com um padrão de NULL. Você deve especificar esse parâmetro se @identityrangemanagementoption for auto ou se @auto_identity_range for false.

@threshold [ = ] limiar

Valor de porcentagem que controla quando o Merge Agent atribui um novo intervalo de identidade. Quando a porcentagem de valores especificada em @threshold é usada, o Merge Agent cria um novo intervalo de identidade. @threshold é int, com um padrão de NULL. Você deve especificar esse parâmetro se @identityrangemanagementoption for auto ou se @auto_identity_range for false.

@verify_resolver_signature [ = ] verify_resolver_signature

Especifica se uma assinatura digital é verificada antes de usar um resolvedor em replicação de mesclagem. @verify_resolver_signature é int, com um padrão de 1.

• 0 especifica que a assinatura não é verificada.

• 1 Especifica que a assinatura é verificada para ver se é de uma fonte confiável.

@destination_object [ = ] N'destination_object'

O nome do objeto no banco de dados de assinatura. @destination_object é sysname, com um valor padrão do que está em @source_object. Este parâmetro é especificado somente se o artigo for um artigo apenas de esquema, como procedimentos armazenados, exibições e UDFs. Se o artigo especificado for um artigo de tabela, o valor em @source_object substituirá o valor em @destination_object.

@allow_interactive_resolver [ = ] N'allow_interactive_resolver'

Habilita ou desabilita o uso do Resolvedor Interativo de um artigo. @allow_interactive_resolver é nvarchar(5), com um padrão de false. false permite o uso do Resolvedor Interativo no artigo; false desativa-o.

@fast_multicol_updateproc [ = ] N'fast_multicol_updateproc'

Esse parâmetro foi preterido e é mantido para compatibilidade com versões anteriores de scripts.

@check_permissions [ = ] check_permissions

Um bitmap das permissões em nível de tabela que são verificadas quando o Merge Agent aplica alterações ao Publicador. Se a conta de usuário/logon do editor usada pelo processo de mesclagem não tiver as permissões de tabela corretas, as alterações inválidas serão registradas como conflitos. @check_permissions é int, e pode ser o | (OU bit a bit) produto de um ou mais dos seguintes valores.

@force_invalidate_snapshot [ = ] force_invalidate_snapshot

Confirma que a ação executada por esse procedimento armazenado pode invalidar um instantâneo existente. @force_invalidate_snapshot é bit, com um padrão de 0.

• 0 Especifica que adicionar um artigo não faz com que o instantâneo seja inválido. Se o procedimento armazenado detectar que a alteração requer um novo instantâneo, ocorrerá um erro e nenhuma alteração será feita.

• 1 Especifica que a adição de um artigo pode fazer com que o instantâneo seja inválido e, se houver assinaturas existentes que exijam um novo instantâneo, dá permissão para que o instantâneo existente seja marcado como obsoleto e um novo instantâneo seja gerado. @force_invalidate_snapshot é definido como 1 ao adicionar um artigo a uma publicação com um instantâneo existente.

@published_in_tran_pub [ = ] N'published_in_tran_pub'

Indica que um artigo em uma publicação de mesclagem também é publicado em uma publicação transacional. @published_in_tran_pub é nvarchar(5), com um padrão de false. false especifica que o artigo também é publicado em uma publicação transacional.

@force_reinit_subscription [ = ] force_reinit_subscription

Confirma que a ação executada por esse procedimento armazenado pode exigir que as assinaturas existentes sejam reinicializadas. @force_reinit_subscription é bit, com um padrão de 0.

• 0 Especifica que adicionar um artigo não faz com que a assinatura seja reinicializada. Se o procedimento armazenado detectar que a alteração requer que as assinaturas existentes sejam reinicializadas, ocorrerá um erro e nenhuma alteração será feita.

• 1 significa que as alterações no artigo de mesclagem fazem com que as assinaturas existentes sejam reinicializadas e dá permissão para que a reinicialização da assinatura ocorra. @force_reinit_subscription é definido como 1 quando @subset_filterclause especifica um filtro de linha com parâmetros.

@logical_record_level_conflict_detection [ = ] N'logical_record_level_conflict_detection'

Especifica o nível de detecção de conflito para um artigo que é um membro de um registro lógico. @logical_record_level_conflict_detection é nvarchar(5), com um padrão de false.

• false Especifica que um conflito será detectado se as alterações forem feitas em qualquer lugar no registro lógico.

• false Especifica que a detecção de conflito padrão é usada conforme especificado pelo @column_tracking. Para obter mais informações, consulte Agrupar alterações a linhas relacionadas com registros lógicos.

@logical_record_level_conflict_resolution [ = ] N'logical_record_level_conflict_resolution'

Especifica o nível de resolução de conflito para um artigo que é um membro de um registro lógico. @logical_record_level_conflict_resolution é nvarchar(5), com um padrão de false.

• false Especifica que todo o registro lógico vencedor substitui o registro lógico perdedor.

• false Especifica que as linhas vencedoras não são restritas ao registro lógico.

Se @logical_record_level_conflict_detection for false, então @logical_record_level_conflict_resolution também deve ser definido como false. Para obter mais informações, consulte Agrupar alterações a linhas relacionadas com registros lógicos.

@partition_options [ = ] partition_options

Define a forma pela qual os dados no artigo são particionados, o que habilita otimizações de desempenho quando todas as linhas pertencem a apenas uma partição ou assinatura. @partition_options é tinyint e pode ser um dos seguintes valores.

@processing_order [ = ] processing_order

Indica a ordem de processamento de artigos em uma publicação de mesclagem. @processing_order é int, com um padrão de 0. 0 Especifica que o artigo não está ordenado e qualquer outro valor representa o valor ordinal da ordem de processamento para este artigo. Os artigos são processados em ordem crescente de valores. Se dois artigos tiverem o mesmo valor, a ordem de processamento será determinada pela ordem do apelido do artigo na tabela do sistema sysmergearticles . Para obter mais informações, confira propriedades de Especificar Replicação de Mesclagem.

@subscriber_upload_options [ = ] subscriber_upload_options

Define restrições em atualizações realizadas em um Assinante com uma assinatura de cliente. Para obter mais informações, consulte Otimizar o desempenho da replicação de mesclagem com artigos somente para download. @subscriber_upload_options é tinyint e pode ser um dos seguintes valores.

Alterar @subscriber_upload_options requer que a assinatura seja reinicializada chamando sp_reinitmergepullsubscription.

@identityrangemanagementoption [ = ] N'identityrangemanagementoption'

Especifica como o gerenciamento de intervalo de identidade é tratado para o artigo. @identityrangemanagementoption é nvarchar(10) e pode ser um dos seguintes valores.

Para compatibilidade com versões anteriores, quando o valor de @identityrangemanagementoption é NULL, o valor de @auto_identity_range é verificado. No entanto, quando o valor de @identityrangemanagementoption não NULLé , o valor de @auto_identity_range é ignorado. Para obter mais informações, consulte Replicar colunas de identidade.

@delete_tracking [ = ] N'delete_tracking'

Indica se as exclusões são replicadas. @delete_tracking é nvarchar(5), com um padrão de true. false indica que as exclusões não são replicadas e true indica que as exclusões são replicadas, que é o comportamento usual para replicação de mesclagem. Quando @delete_tracking é definido como false, as linhas excluídas no Assinante devem ser removidas manualmente no Publicador e as linhas excluídas no Publicador devem ser removidas manualmente no Assinante.

@compensate_for_errors [ = ] N'compensate_for_errors'

Indica se ações de compensação são executadas quando são encontrados erros durante a sincronização. @compensate_for_errors é nvarchar(5), com um padrão de false. Quando definido como true, as alterações que não podem ser aplicadas em um Assinante ou Publicador durante a sincronização sempre levam a ações de compensação para desfazer a alteração; no entanto, um Assinante configurado incorretamente que gera um erro pode fazer com que as alterações em outros Assinantes e Publicadores sejam desfeitas. false desabilita essas ações de compensação, no entanto, os erros ainda são registrados como com compensação e as mesclagens subsequentes continuam tentando aplicar as alterações até serem bem-sucedidas.

@stream_blob_columns [ = ] N'stream_blob_columns'

Especifica que uma otimização de fluxo de dados seja usada ao replicar colunas binárias de objetos grandes. @stream_blob_columns é nvarchar(5), com um padrão de false. true significa que a otimização será tentada. @stream_blob_columns é definido como true quando FILESTREAM está habilitado. Isso permite a replicação de dados FILESTREAM para executar da maneira ideal e reduzir a utilização de memória. Para forçar os artigos da tabela FILESTREAM a não usar o streaming de blob, use sp_changemergearticle para definir @stream_blob_columns como false.

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Comentários

sp_addmergearticle é usado na replicação de mesclagem.

Quando você publicar objetos, suas definições são copiadas aos Assinantes. Se você estiver publicando um objeto de banco de dados que depende de um ou mais outros objetos, deverá publicar todos os objetos referenciados. Por exemplo, se você publicar uma exibição que depende de uma tabela, terá de publicar a tabela também.

Se você especificar um valor de 3 para @partition_options:

• Pode haver apenas uma única assinatura para cada partição de dados nesse artigo. Se uma segunda assinatura for criada na qual o critério de filtragem da nova assinatura for resolvido para a mesma partição como a assinatura existente, a assinatura existente será cancelada.

• Os metadados são limpos sempre que o Merge Agent é executado e o instantâneo particionado expira mais rapidamente. Ao usar essa opção, considere habilitar o instantâneo particionado solicitado pelo assinante. Para obter mais informações, consulte Criar um instantâneo para uma publicação de mesclagem com filtros com parâmetros.

Se você adicionar um artigo com um filtro horizontal estático, usando @subset_filterclause, a uma publicação existente com artigos que têm filtros parametrizados, as assinaturas deverão ser reinicializadas.

Ao especificar @processing_order, recomendamos deixar espaços entre os valores da ordem do artigo, o que facilita a definição de novos valores no futuro. Por exemplo, se você tiver três artigos, , , e Article3, defina @processing_order como 10, 20, e 30, em vez de 1, 2, e 3. Article2Article1 Para obter mais informações, confira propriedades de Especificar Replicação de Mesclagem.

Tabela de opções de esquema padrão

Esta tabela descreve o valor padrão que o procedimento armazenado define, se um NULL valor for especificado para @schema_option, que depende do tipo de artigo.

Tabela de opções de esquema válido

A tabela a seguir descreve os valores permitidos @schema_option dependendo do tipo de artigo.

Exemplos

DECLARE @publication AS sysname;
DECLARE @table1 AS sysname;
DECLARE @table2 AS sysname;
DECLARE @table3 AS sysname;
DECLARE @salesschema AS sysname;
DECLARE @hrschema AS sysname;
DECLARE @filterclause AS nvarchar(1000);
SET @publication = N'AdvWorksSalesOrdersMerge'; 
SET @table1 = N'Employee'; 
SET @table2 = N'SalesOrderHeader'; 
SET @table3 = N'SalesOrderDetail'; 
SET @salesschema = N'Sales';
SET @hrschema = N'HumanResources';
SET @filterclause = N'Employee.LoginID = HOST_NAME()';

-- Add a filtered article for the Employee table.
EXEC sp_addmergearticle 
  @publication = @publication, 
  @article = @table1, 
  @source_object = @table1, 
  @type = N'table', 
  @source_owner = @hrschema,
  @schema_option = 0x0004CF1,
  @description = N'article for the Employee table',
  @subset_filterclause = @filterclause;

-- Add an article for the SalesOrderHeader table that is filtered
-- based on Employee and horizontally filtered.
EXEC sp_addmergearticle 
  @publication = @publication, 
  @article = @table2, 
  @source_object = @table2, 
  @type = N'table', 
  @source_owner = @salesschema, 
  @vertical_partition = N'true',
  @schema_option = 0x0034EF1,
  @description = N'article for the SalesOrderDetail table';

-- Add an article for the SalesOrderDetail table that is filtered
-- based on SaledOrderHeader.
EXEC sp_addmergearticle 
  @publication = @publication, 
  @article = @table3, 
  @source_object = @table3, 
  @source_owner = @salesschema,
  @description = 'article for the SalesOrderHeader table', 
  @identityrangemanagementoption = N'auto', 
  @pub_identity_range = 100000, 
  @identity_range = 100, 
  @threshold = 80,
  @schema_option = 0x0004EF1;

-- Add all columns to the SalesOrderHeader article.
EXEC sp_mergearticlecolumn 
  @publication = @publication, 
  @article = @table2, 
  @force_invalidate_snapshot = 1, 
  @force_reinit_subscription = 1;

-- Remove the credit card Approval Code column.
EXEC sp_mergearticlecolumn 
  @publication = @publication, 
  @article = @table2, 
  @column = N'CreditCardApprovalCode', 
  @operation = N'drop', 
  @force_invalidate_snapshot = 1, 
  @force_reinit_subscription = 1;

-- Add a merge join filter between Employee and SalesOrderHeader.
EXEC sp_addmergefilter 
  @publication = @publication, 
  @article = @table2, 
  @filtername = N'SalesOrderHeader_Employee', 
  @join_articlename = @table1, 
  @join_filterclause = N'Employee.BusinessEntityID = SalesOrderHeader.SalesPersonID', 
  @join_unique_key = 1, 
  @filter_type = 1, 
  @force_invalidate_snapshot = 1, 
  @force_reinit_subscription = 1;

-- Add a merge join filter between SalesOrderHeader and SalesOrderDetail.
EXEC sp_addmergefilter 
  @publication = @publication, 
  @article = @table3, 
  @filtername = N'SalesOrderDetail_SalesOrderHeader', 
  @join_articlename = @table2, 
  @join_filterclause = N'SalesOrderHeader.SalesOrderID = SalesOrderDetail.SalesOrderID', 
  @join_unique_key = 1, 
  @filter_type = 1, 
  @force_invalidate_snapshot = 1, 
  @force_reinit_subscription = 1;
GO

Permissões

Exige associação à função de servidor fixa sysadmin ou à função de banco de dados fixa db_owner .

Conteúdo relacionado

• Defina um Artigo
• Publicar dados e objetos de banco de dados
• Replicar colunas de identidade
• sp_changemergearticle (Transact-SQL)
• sp_dropmergearticle (Transact-SQL)
• sp_helpmergearticle (Transact-SQL)
• Procedimentos armazenados de replicação (Transact-SQL)