sp_replmonitorhelpmergesession (Transact-SQL)

  • Artigo

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

Retorna informações de sessões anteriores para um determinado Merge Agent de replicação, com uma linha retornada para cada sessão correspondente aos critérios de filtragem. Esse procedimento armazenado, usado para monitorar replicação de mesclagem, é executado no Distribuidor, no banco de dados de distribuição, e no Assinante, no banco de dados de assinatura.

Convenções de sintaxe de Transact-SQL

Sintaxe

sp_replmonitorhelpmergesession
    [ [ @agent_name = ] N'agent_name' ]
    [ , [ @hours = ] hours ]
    [ , [ @session_type = ] session_type ]
    [ , [ @publisher = ] N'publisher' ]
    [ , [ @publisher_db = ] N'publisher_db' ]
    [ , [ @publication = ] N'publication' ]
[ ; ]

Argumentos

@agent_name [ = ] N'agent_name'

O nome do agente. @agent_name é nvarchar(100), sem padrão.

@hours [ = ] horas

O intervalo de tempo, em horas, para o qual as informações históricas da sessão do agente são retornadas. @hours é int e pode ser um dos intervalos a seguir.

Valor Descrição
< 0 Retorna informações sobre execuções de agente anteriores, até um máximo de 100 execuções.
0 (padrão) Retorna informações sobre todas as execuções de agente anteriores.
> 0 Retorna informações sobre execuções de agente que ocorreram no número de horas das últimas horas .

@session_type [ = ] session_type

Filtra o conjunto de resultados baseado no resultado final da sessão. @session_type é int e pode ser um desses valores.

Valor Descrição
1 (padrão) Sessões de agente com um resultado de repetição ou êxito.
0 Sessões de agente com um resultado de falha.

@publisher [ = ] N'editor'

O nome do Editor. @publisher é sysname, com um padrão de NULL. Esse parâmetro é usado ao executar sp_replmonitorhelpmergesession no Assinante.

@publisher_db [ = ] N'publisher_db'

O nome do banco de dados de publicação. @publisher_db é sysname, com um padrão de NULL. Esse parâmetro é usado ao executar sp_replmonitorhelpmergesession no Assinante.

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

O nome da publicação. @publication é sysname, com um padrão de NULL. Esse parâmetro é usado ao executar sp_replmonitorhelpmergesession no Assinante.

Conjunto de resultados

Nome da coluna Tipo de dados Descrição
Session_id int ID da sessão de trabalho do agente.
Status int Status de execução do agente:

1 = Início

2 = Sucesso

3 = Em andamento

4 = Ocioso

5 = Tentar novamente

6 = Falha
StartTime datetime A sessão de trabalho do agente de tempo foi iniciada.
EndTime datetime A sessão de trabalho do agente de tempo foi concluída.
Duration int Duração acumulada, em segundos, dessa sessão de trabalho.
UploadedCommands int Número de comandos carrgeado durante a sessão do agente.
DownloadedCommands int Número de comandos baixados durante a sessão do agente.
ErrorMessages int Número de mensagens de erro geradas durante a sessão do agente.
ErrorID int ID do erro ocorrido.
PercentageDone decimal Porcentagem estimada do total de alterações que já foi entregue em uma sessão ativa.
TimeRemaining int Número estimado de segundos restantes em uma sessão ativa.
CurrentPhase int A fase atual de uma sessão ativa e pode ser uma das seguintes.

1 = Carregar

2 = Baixar
LastMessage nvarchar(500) A última mensagem registrada pelo Merge Agent durante a sessão.

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Comentários

sp_replmonitorhelpmergesession é usado para monitorar a replicação de mesclagem.

Quando executado no Assinante, sp_replmonitorhelpmergesession retorna apenas informações sobre as últimas cinco sessões do Merge Agent.

Permissões

Somente membros da função de banco de dados fixa db_owner ou replmonitorar no banco de dados de distribuição no Distribuidor ou no banco de dados de assinatura no Assinante podem executar sp_replmonitorhelpmergesession.

Conteúdo relacionado