sp_replmonitorhelppublication (Transact-SQL)

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 Transact-SQL

Sintaxe

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

Argumentos

• [ @publisher = ] 'publisher'
  É o nome do Publicador cujo status está sendo monitorado publisher é sysname, com um valor padrão NULL. Se for null, as informações serão retornadas para todos os Publicadores que usam o Distribuidor.

• [ @publisher_db = ] 'publisher_db'
  É o nome do banco de dados publicado. publisher_db é sysname, com um valor padrão NULL. Se for NULL, as informações serão retornadas para todos os bancos de dados publicados no Publicador.

• [ @publication = ] 'publication'
  É o nome da publicação que está sendo monitorada. publication é sysname, com um valor padrão NULL.

• [ @publication_type = ] publication_type
  É o tipo de publicação. publication_type é int e pode ser um destes 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= ] refreshpolicy
  Somente para uso interno.

Conjuntos de resultados

Nome da coluna	Tipo de dados	Descrição
publisher_db	sysname	É o nome do Publicador.
publication	sysname	É o nome de uma publicação.
publication_type	int	É o tipo de publicação, que pode ser um destes valores: 0 = Publicação transacional 1 = Publicação de instantâneo 2 = Publicação de mesclagem
status	int	Status máximo de todos os agentes de replicação associados com a publicação, que pode ser um destes valores. 1 = Iniciado 2 = Êxito 3 = Em andamento 4 = Ocioso 5 = Tentando novamente 6 = Falha
warning	int	Limite máximo gerado por uma assinatura pertencente à publicação, que pode ser o resultado OR lógico de um ou mais destes valores. 1 = expiration – uma assinatura para uma publicação transacional não foi sincronizada dentro do limite de período da 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 para uma publicação de mesclagem não foi sincronizada dentro do limite de período da 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 veloz de rede. 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 lenta de rede. 32 = mergefastrunspeed – a taxa de entrega de linhas durante a sincronização de uma assinatura de mesclagem não conseguiu manter a taxa limite de linhas por segundo em uma conexão veloz de rede. 64 = mergeslowrunspeed – a taxa de entrega de linhas durante a sincronização de uma assinatura de mesclagem não conseguiu manter a taxa limite de linhas por segundo em uma conexão dial-up ou lenta ou de rede.
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 de execução do Distribution Agent.
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 período mais longo de não execução de um agente.
subscriptioncount	int	O número de assinaturas para uma publicação.
runningdistagentcount	int	O número de agentes de distribuição em execução para a publicação
snapshot_agentname	sysname	Nome do trabalho do Snapshot Agent para a publicação.
logreader_agentname	sysname	Nome de trabalho do Log Reader Agent para a publicação transacional.
qreader_agentname	sysname	Nome de trabalho do Queue Reader Agent para uma publicação transacional que dá suporte a atualização enfileirada.
worst_runspeedPerf	int	O tempo mais longo de sincronização para a publicação de mesclagem.
best_runspeedPerf	int	O tempo mais curto 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.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Comentários

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

Permissões

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

Consulte também

Tarefas

Como monitorar programaticamente a replicação (Programação Transact-SQL de replicação)