• Artigo

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.

Ícone de vínculo de tópicoConvenções de 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 históricas de sessão de agente são retornadas. hours é int, que 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 último número de horas hours.

  • [ @session_type = ] session_type
    Filtra o conjunto de resultados com base no resultado final da sessão. session_type é int, e pode ser 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 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 NULL. Esse parâmetro é usado ao executar sp_replmonitorhelpmergesession no Assinante.

  • [ @publication= ] 'publication'
    É o nome da publicação. publication é sysname, com um padrão 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.