sp_helpmergearticle (Transact-SQL)

  • Artigo

Aplica-se: SQL Server

Retorna informações sobre um artigo. Esse procedimento armazenado é executado no Publicador no banco de dados de publicação ou em um Assinante de republicação no banco de dados de assinatura.

Convenções de sintaxe de Transact-SQL

Sintaxe

sp_helpmergearticle
    [ [ @publication = ] N'publication' ]
    [ , [ @article = ] N'article' ]
[ ; ]

Argumentos

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

O nome da publicação sobre a qual recuperar informações. @publication é sysname, com um padrão de , que retorna informações sobre todos os artigos de mesclagem contidos em todas as publicações no banco de %dados atual.

@article [ = ] N'artigo'

O nome do artigo para o qual retornar informações. @article é sysname, com um padrão de , que retorna informações sobre todos os artigos de %mesclagem na publicação fornecida.

Conjunto de resultados

Nome da coluna Tipo de dados Descrição
id int Identificador do artigo.
name sysname Nome do artigo.
source_owner sysname Nome do proprietário do objeto de origem.
source_object sysname Nome do objeto de origem do qual adicionar o artigo.
sync_object_owner sysname Nome do proprietário da exibição que define o artigo publicado.
sync_object sysname Nome do objeto personalizado usado para estabelecer os dados iniciais para a partição.
description nvarchar(255) Descrição do artigo.
status tinyint Status do artigo, que pode ser um dos seguintes valores:

1 = inativo

2 = ativo

5 = operação de linguagem de definição de dados (DDL) pendente

6 = Operação DDL com um instantâneo recém-gerado

Observação: quando um artigo é reinicializado, os valores de 5 e 6 são alterados para 2.
creation_script nvarchar(255) Caminho e nome de um script de esquema de artigo opcional usados para criar o artigo no banco de dados de assinatura.
conflict_table nvarchar(270) Nome da tabela que armazena os conflitos de entrada ou atualização.
article_resolver nvarchar(255) Resolvedor personalizado para o artigo.
subset_filterclause nvarchar(1000) Cláusula WHERE especificando filtragem horizontal.
pre_creation_command tinyint Método de pré-criação, que pode ser um dos seguintes valores:

0 = nenhum

1 = soltar

2 = excluir

3 = truncar
schema_option binary(8) Bitmap da opção de geração de esquema para o artigo. Para obter informações sobre essa opção de bitmap, consulte sp_addmergearticle ou sp_changemergearticle.
type smallint Tipo de artigo, que pode ser um dos seguintes valores:

10 = tabela

32 = procedimento armazenado

64 = visualização ou visualização indexada

128 = função definida pelo usuário

160 = somente esquema de sinônimos
column_tracking int Configuração para rastreamento em nível de coluna; onde 1 significa que o controle no nível da coluna está ativado e 0 significa que o controle no nível da coluna está desativado.
resolver_info nvarchar(255) Nome do resolvedor do artigo.
vertical_partition bit Se o artigo for dividido verticalmente; onde 1 significa que o artigo está dividido verticalmente e 0 significa que não está.
destination_owner sysname Proprietário do objeto de destino. Aplicável apenas em procedimentos armazenados de mesclagem, exibições e artigos de esquema UDF (função definida pelo usuário).
identity_support int Se o tratamento automático de intervalo de identidade estiver habilitado; onde 1 está habilitado e 0 está desabilitado.
pub_identity_range bigint O tamanho de intervalo a ser usado ao atribuir novos valores de identidade. Para obter mais informações, consulte a seção "Replicação de mesclagem" de Replicar colunas de identidade.
identity_range bigint O tamanho de intervalo a ser usado ao atribuir novos valores de identidade. Para obter mais informações, consulte a seção "Replicação de mesclagem" de Replicar colunas de identidade.
threshold int Valor percentual usado para Assinantes que executam o SQL Server Compact ou versões anteriores do SQL Server. threshold controla quando o Merge Agent atribui um novo intervalo de identidade. Quando a porcentagem de valores especificada no limite é usada, o Merge Agent cria um novo intervalo de identidade. Para obter mais informações, consulte a seção "Replicação de mesclagem" de Replicar colunas de identidade.
verify_resolver_signature int Se uma assinatura digital for verificada antes de usar um resolvedor na replicação de mesclagem; where 0 significa que a assinatura não foi verificada e 1 significa que a assinatura foi verificada para ver se é de uma fonte confiável.
destination_object sysname Nome do objeto de destino. Aplicável apenas a procedimentos armazenados de mesclagem, exibições e artigos de esquema UDF.
allow_interactive_resolver int Se o Resolvedor Interativo for usado em um artigo; where 1 significa que esse resolvedor é usado e 0 significa que ele não é usado.
fast_multicol_updateproc int Habilita ou desabilita o Merge Agent para aplicar alterações a várias colunas na mesma linha em uma instrução UPDATE; onde 1 significa que várias colunas são atualizadas em uma instrução e 0 significa que instruções UPDATE separadas são problemas para cada coluna atualizada.
check_permissions int Valor inteiro que representa o bitmap de permissões de nível de tabela verificadas. Para obter uma lista de valores possíveis, consulte sp_addmergearticle (Transact-SQL).
processing_order int A ordem na qual as alterações de dados são aplicadas a artigos em uma publicação.
upload_options tinyint Define restrições em atualizações feitas em um Assinante com uma assinatura de cliente, que pode ser um dos valores a seguir.

0 = Não há restrições sobre atualizações feitas em um Assinante com uma assinatura de cliente; todas as alterações são carregadas no Publicador.

1 = As alterações são permitidas em um Assinante com uma assinatura de cliente, mas não são carregadas no Publicador.

2 = As alterações não são permitidas 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.
identityrangemanagementoption int Especifica se o tratamento de intervalo de identidade automático está habilitado. 1 está habilitado e 0 está desabilitado.
delete_tracking bit Especifica se as exclusões são replicadas. 1 significa que as exclusões são replicadas e 0 significa que não são.
compensate_for_errors bit Indica se as ações de compensação são executadas quando erros são encontrados durante a sincronização; onde 1 indica que ações de compensação são tomadas e 0 significa que ações de compensação não são tomadas.
partition_options tinyint Define a maneira como os dados no artigo são particionados. Essa opção permite otimizações de desempenho quando todas as linhas pertencem a apenas uma partição ou a apenas uma assinatura. partition_options pode ser um dos seguintes valores.

0 = A filtragem do artigo é estática ou não produz um subconjunto exclusivo de dados para cada partição; ou seja, é uma partição "sobreposta".

1 = As partições estão sobrepostas e as atualizações de DML (linguagem de manipulação de dados) feitas no Assinante não podem alterar a partição à qual uma linha pertence.

2 = A filtragem do artigo produz partições não sobrepostas, mas vários Assinantes podem receber a mesma partição.

3 = A filtragem do artigo produz partições não sobrepostas que são exclusivas para cada assinatura.
artid uniqueidentifier Um identificador que identifica exclusivamente o artigo.
pubid uniqueidentifier Um identificador que identifica exclusivamente a publicação na qual o artigo é publicado.
stream_blob_columns bit Se a otimização de fluxo de dados for usada ao replicar colunas de objeto binário grande. 1 significa que a otimização está sendo usada e 0 significa que a otimização não está sendo usada.

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Comentários

sp_helpmergearticle é usado na replicação de mesclagem.

Permissões

Somente os membros da db_owner função de banco de dados fixa no banco de dados de publicação, a função replmonitor no banco de dados de distribuição ou a lista de acesso à publicação de uma publicação podem executar sp_helpmergearticle.

Exemplos

DECLARE @publication AS sysname;
SET @publication = N'AdvWorksSalesOrdersMerge';

USE [AdventureWorks2022]
EXEC sp_helpmergearticle
  @publication = @publication;
GO

Conteúdo relacionado