Partilhar via

sp_replmonitorhelpmergesession (Transact-SQL)

Aplica-se a:SQL ServerAzure SQL Managed Instance

Retorna informações sobre sessões anteriores para um determinado Merge Agent de replicação, com uma linha retornada para cada sessão que corresponde ao critério de filtragem. Este procedimento armazenado, que é usado para monitorar a replicação de mesclagem, é executado no Distribuidor no banco de dados de distribuição ou no Assinante no banco de dados de assinatura.

Transact-SQL convenções de sintaxe

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 de sessão do agente histórico são retornadas. @hours é int e pode ser um dos seguintes intervalos.

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

@session_type [ = ] session_type

Filtra o conjunto de resultados com base 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 sucesso.
0 Sessões de agente com um resultado de falha.

[ @publisher = ] N'editora'

O nome do Editor. @publisher é sysname, com um padrão de NULL. Este 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. Este 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. Este 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 curso

4 = Inativo

5 = Repetir

6 = Reprovado
StartTime datetime Sessão de trabalho do agente de tempo começou.
EndTime datetime A sessão de trabalho do agente de tempo foi concluída.
Duration Int Duração cumulativa, em segundos, desta sessão de trabalho.
UploadedCommands Int Número de comandos carregados 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 que ocorreu
PercentageDone decimais Porcentagem estimada do total de alterações que já foram entregues 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 de código de retorno

0 (sucesso) ou 1 (fracasso).

Observações

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 replmonitor 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

  • Last updated on