sys.sp_helparticle (Transact-SQL)

Aplica-se a: SQL ServerAzure SQL Managed Instance

Apresenta informações sobre um artigo. Este procedimento armazenado é executado no Publisher no banco de dados de publicação. Para a Oracle Publishers, este procedimento armazenado é executado no Distribuidor em qualquer base de dados.

Transact-SQL convenções de sintaxe

Syntax

sys.sp_helparticle
    [ @publication = ] N'publication'
    [ , [ @article = ] N'article' ]
    [ , [ @returnfilter = ] returnfilter ]
    [ , [ @publisher = ] N'publisher' ]
    [ , [ @found = ] found OUTPUT ]
[ ; ]

Arguments

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

O nome da publicação. @publication é sysname, sem padrão.

[ @article = ] N'artigo'

O nome de um artigo na publicação. @article é sysname, com um padrão de %. Se @article não for fornecida, a informação de todos os artigos da publicação especificada é devolvida.

[ @returnfilter = ] retorno

Especifica se a cláusula de filtro deve ser devolvida. @returnfilter é bit, com um padrão de 1, que devolve a cláusula de filtro.

@publisher [ = ] N'editor'

Especifica um editor que não seja SQL Server. @publisher é sysname, com um padrão de NULL.

@publisher não deve ser especificado ao solicitar informações sobre um artigo publicado por um SQL Server Publisher.

[ @found = ] encontrado SAÍDA

Identificado apenas para fins informativos. Não suportado. A compatibilidade futura não é garantida.

Conjunto de resultados

Nome da coluna Tipo de dados Description
article id int ID do artigo.
article name sysname Nome do artigo.
base object nvarchar(257) Nome da tabela subjacente representada pelo artigo ou procedimento armazenado.
destination object sysname Nome da tabela de destino (subscrição).
synchronization object nvarchar(257) Nome da visão que define o artigo publicado.
type smallint O tipo de artigo:

1 = Baseado em log.
3 = Baseado em logs com filtro manual.
5 = Baseado em logs com vista manual.
7 = Baseado em log, com filtro manual e vista manual.
8 = Execução de procedimento armazenado.
24 = Execução de procedimento armazenado serializável.
32 = Procedimento armazenado (apenas esquema).
64 = Vista (apenas esquema).
96 = Função agregada (apenas esquema).
128 = Função (apenas esquema).
257 = Vista indexada baseada em log.
259 = Vista indexada baseada em logs com filtro manual.
261 = Vista indexada baseada em registos com vista manual.
263 = Vista indexada baseada em log, com filtro manual e vista manual.
320 = Vista indexada (apenas esquema).
status tinyint Pode ser o resultado & (bit a bit AND) de uma ou mais destas propriedades do artigo:

0x00 = Identificado apenas para fins informativos. Não suportado. A compatibilidade futura não é garantida.
0x01 = O artigo está ativo.
0x08 = Incluir o nome da coluna nas instruções de inserção.
0x16 = Usar instruções parametrizadas.
0x32 = Usar instruções parametrizadas e incluir o nome da coluna em inserir sentenças.
filter nvarchar(257) Procedimento armazenado usado para filtrar horizontalmente a tabela. Este procedimento armazenado deve ser criado usando a FOR REPLICATION cláusula.
description nvarchar(255) Entrada descritiva para o artigo.
insert_command nvarchar(255) O tipo de comando de replicação usado ao replicar inserções com artigos de tabela. 1
update_command nvarchar(255) O tipo de comando de replicação usado ao replicar atualizações com artigos de tabela. 1
delete_command nvarchar(255) O tipo de comando de replicação usado ao replicar eliminações com artigos de tabela. 1
creation script path nvarchar(255) Caminho e nome de um script de esquema de artigo usado para criar tabelas de alvo.
vertical partition bit É se a partição vertical está ativada para o artigo; onde um valor de 1 significa que a partição vertical está ativada.
pre_creation_cmd tinyint Comando de pré-criação para DROP TABLE, DELETE TABLE, ou TRUNCATE TABLE.
filter_clause ntext cláusula WHERE especificando o filtro horizontal.
schema_option binário(8) Bitmap da opção de geração de esquemas para o artigo em questão. Para uma lista completa de schema_option valores, veja sp_addarticle.
dest_owner sysname Nome do proprietário do objeto de destino.
source_owner sysname Proprietário do objeto de origem.
unqua_source_object sysname Nome do objeto de origem, sem o nome do proprietário.
sync_object_owner sysname Proprietário da visão que define o artigo publicado.
unqualified_sync_object sysname Nome da vista que define o artigo publicado, sem o nome do proprietário.
filter_owner sysname Dono do filtro.
unqua_filter sysname Nome do filtro, sem o nome do proprietário.
auto_identity_range int Flag a indicar se o tratamento automático de intervalos de identidade estava ativado na publicação na altura da sua criação. 1 significa que o intervalo automático de identidade está ativado; 0 Significa que está desativado.
publisher_identity_range int Tamanho do intervalo da identidade no Publisher se o artigo tiver identityrangemanagementoption definido como auto ou auto_identity_range definido para true.
identity_range bigint Tamanho do intervalo da identidade no Assinante se o artigo tiver identityrangemanagementoption definido como auto ou auto_identity_range definido para true.
threshold bigint Valor percentual que indica quando o Distribution Agent atribui um novo intervalo de identidade.
identityrangemanagementoption int Indica a gestão do intervalo de identidade gerida para o artigo.
fire_triggers_on_snapshot bit É se os gatilhos replicados do utilizador forem executados quando o snapshot inicial é aplicado.

1 = os gatilhos do utilizador são executados.
0 = os gatilhos do utilizador não são executados.

1 Para mais informações, consulte Artigos Transacionais - Especificar Como as Alterações São Propagadas.

Valores de código de retorno

0 (sucesso) ou 1 (fracasso).

Remarks

sp_helparticle é usado na replicação instantânea e na replicação transacional.

Permissions

Apenas os membros do papel de servidor fixo de sysadmin , o papel de base de dados fixa db_owner ou a lista de acesso à publicação para a publicação atual podem executar sp_helparticle.

Exemplos

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

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

Conteúdo relacionado

  • Last updated on