sp_replmonitorhelppublication (Transact-SQL)

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

Retorna informações de status atual para uma ou mais publicações em um Publicador. Esse procedimento armazenado, usado para monitorar a replicação, é executado no Distribuidor, no banco de dados de distribuição.

Convenções de sintaxe de Transact-SQL

Sintaxe

sp_replmonitorhelppublication
    [ [ @publisher = ] N'publisher' ]
    [ , [ @publisher_db = ] N'publisher_db' ]
    [ , [ @publication = ] N'publication' ]
    [ , [ @publication_type = ] publication_type ]
    [ , [ @refreshpolicy = ] refreshpolicy ]
[ ; ]

Argumentos

@publisher [ = ] N'editor'

O nome do Publicador cujo status está sendo monitorado. @publisher é sysname, com um padrão de NULL. Se NULL, as informações serão retornadas para todos os Publicadores que usam o Distribuidor.

@publisher_db [ = ] N'publisher_db'

O nome do banco de dados publicado. @publisher_db é sysname, com um padrão de NULL. Se NULL, as informações serão retornadas para todos os bancos de dados publicados no Publicador.

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

O nome da publicação que está sendo monitorada. @publication é sysname, com um padrão de NULL.

@publication_type [ = ] publication_type

O tipo de publicação. @publication_type é int e pode ser um desses valores.

Valor Descrição
0 Publicação transacional.
1 Publicação de instantâneo.
2 Publicação de mesclagem.
NULL (padrão) A replicação tenta determinar o tipo de publicação.

@refreshpolicy [ = ] política de atualização

Identificado apenas para fins informativos. Não há suporte. A compatibilidade futura não está garantida.

Conjunto de resultados

Nome da coluna Tipo de dados Descrição
publisher_db sysname O nome do Editor.
publication sysname O nome de uma publicação.
publication_type int O tipo de publicação, e pode ser um desses valores.

0 = Publicação transacional
1 = Publicação de instantâneo
2 = Mesclar publicação
status int Status máximo de todos os agentes de replicação associados à publicação e pode ser um desses valores.

1 = Iniciado
2 = Bem sucedido
3 = Em andamento
4 = Ocioso
5 = Repetindo
6 = Falha
warning int Aviso de limite máximo gerado por uma assinatura pertencente à publicação e pode ser o resultado lógico OR de um ou mais desses valores.

1 = expiration - Uma assinatura de uma publicação transacional não foi sincronizada dentro do limite do período de retenção.
2 = latency - o tempo necessário para replicar dados de um Publicador transacional para o Assinante excede o limite, em segundos.
4 = mergeexpiration - Uma assinatura de uma publicação de mesclagem não foi sincronizada dentro do limite do período de retenção.
8 = mergefastrunduration - O tempo necessário para concluir a sincronização de uma assinatura de mesclagem excede o limite, em segundos, em uma conexão de rede rápida.
16 = mergeslowrunduration - O tempo necessário para concluir a sincronização de uma assinatura de mesclagem excede o limite, em segundos, em uma conexão de rede lenta.
32 = mergefastrunspeed - A taxa de entrega de linhas durante a sincronização de uma assinatura de mesclagem falhou ao manter a taxa de limite, em linhas por segundo, em uma conexão de rede rápida.
64 = mergeslowrunspeed - A taxa de entrega de linhas durante a sincronização de uma assinatura de mesclagem falhou ao manter a taxa de limite, em linhas por segundo, em uma conexão de rede lenta.
worst_latency int A latência mais alta, em segundos, para alterações de dados propagadas pelo Log Reader ou Distribution Agents para uma publicação transacional.
best_latency int A latência mais baixa, em segundos, para alterações de dados propagadas pelo Log Reader ou Distribution Agents para uma publicação transacional.
average_latency int A latência média, em segundos, para alterações de dados propagadas pelo Log Reader ou Distribution Agents para uma publicação transacional.
last_distsync datetime A última data e hora em que o Agente de Distribuição foi executado.
retention int O período de retenção para a publicação.
latencythreshold int O limite de latência definido para a publicação transacional.
expirationthreshold int O limite de expiração definido para a publicação se for uma publicação de mesclagem.
agentnotrunningthreshold int O limite definido para o tempo mais longo para que um agente não tenha sido executado.
subscriptioncount int O número de assinaturas de uma publicação.
runningdistagentcount int O número de agentes de distribuição em execução para a publicação
snapshot_agentname sysname O nome do trabalho do Snapshot Agent para a publicação.
logreader_agentname sysname O nome do trabalho do Log Reader Agent para a publicação transacional.
qreader_agentname sysname O nome da tarefa do Queue Reader Agent para uma publicação transacional que oferece suporte à atualização enfileirada.
worst_runspeedPerf int O tempo de sincronização mais longo para a publicação de mesclagem.
best_runspeedPerf int O menor tempo de sincronização para a publicação de mesclagem.
average_runspeedPerf int O tempo médio de sincronização para a publicação de mesclagem.
retention_period_unit int A unidade usada para expressar retention.
publisher sysname O nome da instância do SQL Server que publica a publicação.

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Comentários

sp_replmonitorhelppublication é usado com todos os tipos de replicação.

Permissões

Somente membros da função de banco de dados fixa db_owner ou replmonitorar no banco de dados de distribuição podem executar sp_replmonitorhelppublication.