sp_replmonitorhelpmergesession (Transact-SQL)
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.
.gif "Ícone de vínculo de tópico")
Convenções da sintaxe Transact-SQL
Sintaxe
sp_replmonitorhelpmergesession [ [ @agent_name = ] 'agent_name' ]
[ , [ @hours = ] hours ]
[ , [ @session_type = ] session_type ]
[ , [ @publisher = ] 'publisher' ]
[ , [ @publisher_db = ] 'publisher_db' ]
[ , [ @publication = ] 'publication' ]
Argumentos
[ @agent_name = ] 'agent_name'
É o nome do agente. agent_name é nvarchar(100), sem padrão.[ @hours = ] hours
É o intervalo de tempo, em horas, para o qual as informações da sessão do agente são retornadas. hours é int, que pode ter 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 último número de horas hours.
[ @session_type = ] session_type
Filtra o conjunto de resultados baseado no resultado final da sessão. session_type é int, e pode ter um destes 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 = ] 'publisher'
É o nome do Publicador. publisher é sysname, com um padrão de NULL. Esse parâmetro é usado ao executar sp_replmonitorhelpmergesession no Assinante.[ @publisher_db = ] '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= ] 'publication'
É o nome da publicação. publication é sysname, com um padrão de NULL. Esse parâmetro é usado ao executar sp_replmonitorhelpmergesession no Assinante.
Conjuntos 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 = Iniciar 2 = Êxito 3 = Em andamento 4 = Ocioso 5 = Repetir 6 = Falha |
StartTime |
datetime |
Hora em que a sessão de trabalho do agente começou. |
EndTime |
datetime |
Hora em que a sessão de trabalho do agente 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 da sessão de uma sessão ativa, que pode ser uma das seguintes: 1 = Carregar 2 = Baixar |
LastMessage |
nvarchar(500) |
É a última mensagem registrada pelo Merge Agent durante a sessão. |
Valores de código de retorno
0 (êxito) ou 1 (falha)
Comentários
sp_replmonitorhelpmergesession é usado para monitorar replicação de mesclagem.
Quando executado no Assinante, sp_replmonitorhelpmergesession só retorna informações sobre as últimas cinco sessões do Merge Agent .
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 no Distribuidor ou no banco de dados de assinatura no Assinante podem executar sp_replmonitorhelpmergesession.