Monitore programaticamente a replicação
Aplica-se a: 
SQL Server Instância Gerenciada de SQL do Azure
O Replication Monitor é uma ferramenta gráfica que permite monitorar uma topologia de replicação. É possível acessar os mesmos dados de monitoração programaticamente usando o RMO (Replication Management Objects) ou procedimentos armazenados de replicação do Transact-SQL. Esses objetos permitem programar as seguintes tarefas:
Monitorar o estado de Publicadores, publicações e assinaturas.
Monitorar as sessões do Merge Agent em um ou mais Assinantes.
Monitorar os comandos transacionais que estão esperando para serem aplicados em um ou mais Assinantes.
Definir os limites métricos que determinam quando uma publicação requer intervenção.
Monitorar o estado de tokens de rastreamento.
Neste tópico:
RMO (Replication Management Objects)
Transact-SQL
Para monitorar Publicador, publicações e assinatura a partir do Distribuidor
No Distribuidor, no banco de dados de distribuição, execute sp_replmonitorhelppublisher. Isso retornará informações para todos os Publicadores que usarem esse Distribuidor. Para limitar o conjunto de resultados a um único Publicador, especifique @publisher.
No Distribuidor do banco de dados de distribuição, execute sp_replmonitorhelppublication. Isso retornará informações para todas as publicações que usarem esse Distribuidor. Para limitar o conjunto de resultados a um único Publicador, publicação ou banco de dados publicado, especifique @publisher, @publicationou @publisher_db, respectivamente.
No Distribuidor do banco de dados de distribuição, execute sp_replmonitorhelpsubscription. Isso retornará informações para todas as assinaturas que usarem esse Distribuidor. Para limitar o conjunto de resultados às assinaturas pertencentes a um único Publicador, publicação ou banco de dados publicado, especifique @publisher, @publicationou @publisher_db, respectivamente.
Para monitorar os comandos transacionais que estão esperando para serem aplicados no Assinante.
- No Distribuidor do banco de dados de distribuição, execute sp_replmonitorsubscriptionpendingcmds. Isso retornará informações de monitoração para todos os comandos pendentes, de todas as assinaturas que usam esse Distribuidor. Para limitar o conjunto de resultados aos comandos pendentes das assinaturas pertencentes a um único Publicador, publicação ou banco de dados publicado, especifique @publisher, @subscriber, @publicationou @publisher_db, respectivamente.
Para monitorar as alterações de mesclagem a espera de serem carregadas ou baixadas
No Publicador do banco de dados de publicação, execute sp_showpendingchanges. Isso retornará um conjunto de resultados que mostra informações sobre as alterações esperando para ser replicadas nos Assinantes. Para limitar o conjunto de resultados às mudanças pertencentes a um único Publicador, publicação ou artigo, especifique @publication ou @article, respectivamente.
Em um Assinante, no banco de dados da assinatura, execute sp_showpendingchanges. Isso retornará um conjunto de resultados que mostra informações sobre as alterações esperando para ser replicadas no Publicador. Para limitar o conjunto de resultados às mudanças pertencentes a um único Publicador, publicação ou artigo, especifique @publication ou @article, respectivamente.
Para monitorar sessões do Merge Agent
No Distribuidor do banco de dados de distribuição, execute sp_replmonitorhelpmergesession. Isso retornará informações de monitoração, inclusive Session_id, em todas as sessões do Merge Agent de todas as assinaturas que usam esse Distribuidor. Você também pode obter o Session_id consultando a tabela do sistema MSmerge_sessions .
No Distribuidor, no banco de dados de distribuição, execute sp_replmonitorhelpmergesession. Especifique um valor de Session_id da etapa 1 para @session_id. Isso exibirá informações de monitoramento detalhadas sobre a sessão.
Repita a etapa 2 para cada sessão que interessar.
Para monitorar sessões do Merge Agent para assinatura pull do Assinante
No Assinante, no banco de dados da assinatura, execute sp_replmonitorhelpmergesession. Para uma assinatura determinada, especifique @publisher, @publicatione o nome do banco de dados de publicação para @publisher_db. Isso retornará informações de monitoração das últimas cinco sessões do Merge Agent para essa assinatura. Observe que o valor de Session_id para as sessões que interessarem, no conjunto de resultados.
No Assinante, no banco de dados da assinatura, execute sp_replmonitorhelpmergesessiondetail. Especifique um valor de Session_id da etapa 1 para @session_id. Isso exibirá informações de monitoramento detalhadas sobre a sessão.
Repita a etapa 2 para cada sessão que interessar.
Para exibir e modificar as métricas de limite do monitor para uma publicação
No Distribuidor, no banco de dados de distribuição, execute sp_replmonitorhelppublicationthresholds. Isso retornará o conjunto de limites de monitoramento, para todas as publicações que usam esse Distribuidor. Para limitar o conjunto de resultados e monitorar os limites das publicações pertencentes a um único Publicador, a um banco de dados publicado ou a uma única publicação, especifique @publisher, @publisher_dbou @publication, respectivamente. Observe o valor de Metric_id para qualquer limite que deva ser alterado. Para obter mais informações, consulte Set Thresholds and Warnings in Replication Monitor.
No Distribuidor, no banco de dados de distribuição, execute sp_replmonitorchangepublicationthreshold. Especifique o seguinte, quando necessário:
O valor Metric_id obtido na etapa 1 para @metric_id.
Um valor novo para a métrica de limite do monitor para @value.
O valor 1 para @shouldalert , para ser registrado um alerta, quando esse limite for atingido, ou o valor 0 , se não for necessário um alerta.
Um valor 1 para @mode , para habilitar a métrica de limite do monitor, ou um valor 2 para desabilitá-la.
RMO (Replication Management Objects)
Para monitorar uma assinatura para uma publicação de mesclagem no Assinante
Crie uma conexão com o Assinante usando a classe ServerConnection .
Crie uma instância da classe MergeSubscriberMonitor e defina as propriedades Publisher, Publication, PublisherDB, SubscriberDB para a assinatura, e defina a propriedade ConnectionContext como ServerConnection criado na etapa 1.
Chame um dos métodos seguintes para retornar informações sobre as sessões do Merge Agent para essa assinatura:
GetSessionsSummary - retorna uma matriz de objetos MergeSessionSummary com informações até as últimas cinco sessões do Merge Agent. Observe o valor SessionId para qualquer sessão do seu interesse.
GetSessionsSummary - retorna uma matriz de objetos MergeSessionSummary com informações das sessões do Merge Agent que ocorreram durante o número de horas passadas no parâmetro hours (até as últimas cinco sessões). Observe o valor SessionId para qualquer sessão do seu interesse.
GetLastSessionSummary - retorna um objeto MergeSessionSummary com informações sobre a última sessão do Merge Agent. Observe o valor de SessionId para esta sessão.
GetSessionsSummaryDataSet - retorna uma matriz de objetos DataSet com informações até as últimas cinco sessões do Merge Agent, uma em cada linha. Observe o valor da coluna Session_id para qualquer sessão do seu interesse.
GetLastSessionSummaryDataRow - retorna um objeto DataRow com informações sobre a última sessão do Merge Agent. Observe o valor da coluna Session_id para essa sessão.
(Opcional) Chame o RefreshSessionSummary para atualizar os dados para o objeto MergeSessionSummary passado como mss, ou chame RefreshSessionSummary para atualizar os dados no objeto DataRow passado como drRefresh.
Usando a id de sessão obtida na etapa 3, chame um dos métodos seguintes para retornar informações sobre os detalhes de uma sessão em particular:
GetSessionDetails - retorna uma matriz de objetos MergeSessionDetail para a SessionId.
GetSessionDetailsDataSet - retorna um objeto DataSet com informações para a SessionId.
Para monitorar as propriedades de replicação para todas as publicações em um Distribuidor
Crie uma conexão com o Distribuidor usando a classe ServerConnection .
Criar uma instância da classe ReplicationMonitor.
Defina a propriedade ConnectionContext como ServerConnection criada na etapa 1.
Chame o método LoadProperties para obter as propriedades do objeto.
Execute um ou mais dos métodos seguintes para retornar informações de replicação para todos os Publicador que usam esse Distribuidor.
EnumDistributionAgents - retorna um objeto DataSet que contém informações sobre todos os Distribution Agents nesse Distribuidor.
EnumErrorRecords - retorna um objeto DataSet que contém informações sobre os erros armazenados no Distribuidor.
EnumLogReaderAgents - retorna um objeto DataSet que contém informações sobre todos os Log Reader Agents no Distribuidor.
EnumMergeAgents - retorna um objeto DataSet que contém informações sobre todos os Merge Agents no Distribuidor.
EnumMiscellaneousAgents - retorna um objeto DataSet que contém informações sobre todos os outros agentes de replicação no Distribuidor.
EnumPublishers - retorna um objeto DataSet que contém informações sobre todos os Publicador nesse Distribuidor.
EnumPublishers2 - retorna um objeto DataSet que retorna os Publicadores que usam esse Distribuidor.
EnumQueueReaderAgents - retorna um objeto DataSet que contém informações sobre todos os Queue Reader Agents no Distribuidor.
EnumQueueReaderAgentSessionDetails - retorna um objeto DataSet que contém detalhes sobre o Queue Reader Agent e a sessão especificados.
EnumQueueReaderAgentSessions - retorna um objeto DataSet que contém informações de sessão sobre o Queue Reader Agent especificado.
EnumSnapshotAgents - retorna um objeto DataSet que contém informações sobre todos os Snapshot Agents no Distribuidor.
Para monitorar as propriedades de publicação para um Publicador específico no Distribuidor
Crie uma conexão com o Distribuidor usando a classe ServerConnection .
Consiga um objeto PublisherMonitor em um desses modos.
Criar uma instância da classe PublisherMonitor. Defina a propriedade Name para o Publicador e defina a propriedade ConnectionContext como ServerConnection criada na etapa 1. Chame o método LoadProperties para obter as propriedades do objeto. Se esse método retornar false, o nome do Publicador estava definido incorretamente ou a publicação não existe.
Do PublisherMonitorCollection acessado por meio da propriedade PublisherMonitors de um objeto existente ReplicationMonitor .
Execute um ou mais dos métodos a seguir para retornar informações de replicação para todas as publicações que pertençam a esse Publicador.
EnumDistributionAgentSessionDetails - retorna um objeto DataSet que contém detalhes sobre o Distribution Agent e a sessão especificados.
EnumDistributionAgentSessions - retorna um objeto DataSet que contém informação da sessão sobre o Distribution Agent especificado.
EnumErrorRecords - retorna um objeto DataSet que contém informações de registro de erros sobre o erro especificado.
EnumLogReaderAgentSessionDetails - retorna um objeto DataSet que contém detalhes sobre o Log Reader Agent e a sessão especificados.
EnumLogReaderAgentSessions - retorna um objeto DataSet que contém informações de sessão sobre o Log Reader Agent especificado.
EnumMergeAgentSessionDetails - retorna um objeto DataSet que contém detalhes sobre o Merge Agent e a sessão especificados.
EnumMergeAgentSessionDetails2 - retorna um objeto DataSet que contém detalhes adicionais sobre o Merge Agent e a sessão especificados.
EnumMergeAgentSessions - retorna um objeto DataSet que contém informação da sessão para o Merge Agent especificado.
EnumMergeAgentSessions2 - retorna um objeto DataSet que contém informações de sessão adicional para o Merge Agent especificado.
EnumPublications - retorna um objeto DataSet que contém informações sobre todas as publicações nesse Distribuidor.
EnumPublications2 - retorna um objeto DataSet que contém informações adicionais sobre todas as publicações nesse Distribuidor.
EnumSnapshotAgentSessionDetails - retorna um objeto DataSet que contém detalhes sobre o Snapshot Agent e a sessão especificados.
EnumSnapshotAgentSessions - retorna um objeto DataSet que contém informação da sessão para o Snapshot Agent especificado.
EnumSubscriptions - retorna um objeto DataSet que contém informações sobre todas as assinaturas para publicações nesse Distribuidor.
Para monitorar as propriedades para uma publicação específica no Distribuidor
Crie uma conexão com o Distribuidor usando a classe ServerConnection .
Consiga um objeto PublicationMonitor em um desses modos.
Criar uma instância da classe PublicationMonitor. Defina as propriedades DistributionDBName, PublisherName, PublicationDBName, e Name para a publicação e defina a propriedade ConnectionContext como ServerConnection criado na etapa 1. Chame o método LoadProperties para obter as propriedades do objeto. Se esse método retornar false, as propriedades de publicação foram definidas incorretamente ou a publicação não existe.
Do PublicationMonitorCollection acessado por meio da propriedade PublicationMonitors de um objeto existente PublisherMonitor .
Execute um ou mais dos métodos seguintes para retornar informações sobre essa publicação.
EnumErrorRecords - retorna um objeto DataSet que contém registros de erro sobre o erro especificado.
EnumLogReaderAgent - retorna um objeto DataSet que contém informações sobre o Log Reader Agent para essa publicação.
EnumMonitorThresholds - retorna um objeto DataSet que contém informações sobre o conjunto de limites de monitoração de avisos para essa publicação.
EnumQueueReaderAgent - retorna um objeto DataSet que contém informações sobre o Queue Reader Agent usado por essa publicação.
EnumSnapshotAgent - retorna um objeto DataSet que contém informações sobre o Snapshot Agent para essa publicação.
EnumSubscriptions - retorna um objeto DataSet que contém informações sobre assinaturas para essa publicação.
EnumSubscriptions2 - retorna um objeto DataSet que contém informações adicionais sobre assinaturas para essa publicação com base no SubscriptionResultOptionfornecido.
EnumTracerTokenHistory - retorna um objeto DataSet que contém informações de latência para o token de rastreamento especificado.
EnumTracerTokens - retorna um objeto DataSet que contém informações sobre todos os tokens de rastreamento inseridos nessa publicação.
Para monitorar os comandos transacionais que estão esperando para serem aplicados no Assinante.
Crie uma conexão com o Distribuidor usando a classe ServerConnection .
Consiga um objeto PublicationMonitor em um desses modos.
Criar uma instância da classe PublicationMonitor. Defina as propriedades DistributionDBName, PublisherName, PublicationDBName, e Name para a publicação e defina a propriedade ConnectionContext como ServerConnection criado na etapa 1. Chame o método LoadProperties para obter as propriedades do objeto. Se esse método retornar false, as propriedades de publicação foram definidas incorretamente ou a publicação não existe.
Do PublicationMonitorCollection acessado por meio da propriedade PublicationMonitors de um objeto existente PublisherMonitor .
Execute o método TransPendingCommandInfo que retorna um objeto PendingCommandInfo .
Use as propriedades desse objeto PendingCommandInfo para determinar o número estimado de comandos pendentes e o tempo que levará para completar a entrega desses comandos.
Para definir os limites de aviso de monitoração para uma publicação
Crie uma conexão com o Distribuidor usando a classe ServerConnection .
Consiga um objeto PublicationMonitor em um desses modos.
Criar uma instância da classe PublicationMonitor. Defina as propriedades DistributionDBName, PublisherName, PublicationDBName, e Name para a publicação e defina a propriedade ConnectionContext como ServerConnection criado na etapa 1. Chame o método LoadProperties para obter as propriedades do objeto. Se esse método retornar false, as propriedades de publicação foram definidas incorretamente ou a publicação não existe.
Do PublicationMonitorCollection acessado por meio da propriedade PublicationMonitors de um objeto existente PublisherMonitor .
Execute o método EnumMonitorThresholds . Observe as configurações de limite atuais no ArrayList retornado de objetos MonitorThreshold .
Execute o método ChangeMonitorThreshold . Passe os seguintes parâmetros:
metricID - um valor Int32 que representa a métrica de limite de monitoração da tabela a seguir:
Valor Description 1 expiration - monitora a expiração iminente de assinaturas para publicações transacionais. 2 latency - monitora o desempenho de assinaturas para publicações transacionais. 4 mergeexpiration - monitora a expiração iminente de assinaturas para publicações de mesclagem. 5 mergeslowrunduration - monitora a duração de sincronizações de mesclagem em conexões da baixa largura da banda (discadas). 6 mergefastrunduration - monitora a duração de sincronizações de mesclagem em conexões da alta largura da banda (LAN). 7 mergefastrunspeed - monitora a taxa de sincronizações de mesclagem em conexões de alta largura da banda (LAN). 8 mergeslowrunspeed - monitora a taxa de sincronizações de mesclagem em conexões de baixa largura da banda (discadas). enable - Boolean valor que indica se a métrico está habilitado para a publicação.
thresholdValue - valor inteiro que define o limite.
shouldAlert - inteiro que indica se esse limite deve gerar um alerta.