sys.sp_article_validation (Transact-SQL)

Aplica-se a: SQL ServerAzure SQL Managed Instance

Inicia um pedido de validação de dados para o artigo especificado. Este procedimento armazenado é executado no Publisher na base de dados de publicações e no Assinante na base de dados de subscrição.

Transact-SQL convenções de sintaxe

Syntax

sys.sp_article_validation
    [ @publication = ] N'publication'
    , [ @article = ] N'article'
    [ , [ @rowcount_only = ] rowcount_only ]
    [ , [ @full_or_fast = ] full_or_fast ]
    [ , [ @shutdown_agent = ] shutdown_agent ]
    [ , [ @subscription_level = ] subscription_level ]
    [ , [ @reserved = ] reserved ]
    [ , [ @publisher = ] N'publisher' ]
[ ; ]

Arguments

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

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

[ @article = ] N'artigo'

O nome do artigo para validar. @article é sysname, sem padrão.

[ @rowcount_only = ] rowcount_only

Especifica se apenas a contagem de linhas da tabela é devolvida. @rowcount_only é smallint, com um padrão de 1.

  • Se 0, realiza uma contagem de linhas e um checksum compatível com o SQL Server 7.0.
  • Se 1, realiza apenas uma verificação de contagem de linhas.
  • Se 2, realiza uma contagem de linhas e um checksum binário.

[ @full_or_fast = ] full_or_fast

O método utilizado para calcular a contagem de linhas. @full_or_fast é minyint, e pode ser um destes valores:

Value Description
0 Realiza a contagem total usando COUNT(*).
1 Realiza contagem rápida a partir de sysindexes.rows. Contar linhas em sysindexes é mais rápido do que contar linhas na tabela propriamente dita. No entanto, sysindexes é atualizado de forma preguiçosa, e a contagem de linhas pode não ser precisa.
2 (padrão) Realiza contagem rápida condicional tentando primeiro o método rápido. Se o método fast mostrar diferenças, reverte para o método completo. Se expected_rowcount for NULL e o procedimento armazenado estiverem a ser usados para obter o valor, é sempre usado um procedimento completo COUNT(*) .

[ @shutdown_agent = ] shutdown_agent

Especifica se o agente de distribuição deve desligar imediatamente após a conclusão da validação. @shutdown_agent é bit, com um padrão de 0.

  • Se 0, o Distribution Agent não desliga.
  • Se 1, o Distribution Agent encerra após a validação do artigo.

[ @subscription_level = ] subscription_level

Especifica se a validação é captada por um conjunto de subscritores. @subscription_levelé bit, com um padrão de 0.

  • Se 0, validação é aplicada a todos os Subscritores.
  • Se 1, a validação é aplicada apenas a um subconjunto dos Subscritores especificados por chamadas para sp_marksubscriptionvalidation na transação aberta atual.

[ @reserved = ] reservado

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

@publisher [ = ] N'editor'

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

@publisher não deve ser usado ao pedir validação numa SQL Server Publisher.

Valores de código de retorno

0 (sucesso) ou 1 (fracasso).

Remarks

sp_article_validation é usado na replicação transacional.

sp_article_validation faz com que a informação de validação seja recolhida no artigo especificado e publica um pedido de validação no registo de transações. Quando o Distribution Agent recebe este pedido, o Distribution Agent compara a informação de validação do pedido com a tabela do Assinante. Os resultados da validação são exibidos no Replication Monitor e nos alertas do SQL Server Agent.

Permissions

Apenas os utilizadores com SELECT ALL permissões na tabela de origem do artigo validado podem executar sp_article_validation.