sp_replmonitorhelpmergesession (Transact-SQL)

  • Artículo

Se aplica a:SQL ServerAzure SQL Managed Instance

Devuelve información acerca de sesiones pasadas de un Agente de mezcla de replicación concreto, con una fila por cada sesión que coincida con el criterio de filtrado. Este procedimiento almacenado, que se utiliza para supervisar la replicación de mezcla, se ejecuta en el distribuidor de la base de datos de distribución o en el suscriptor de la base de datos de suscripciones.

Convenciones de sintaxis de Transact-SQL

Sintaxis

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'

Nombre del agente. @agent_name es nvarchar(100), sin ningún valor predeterminado.

[ @hours = ] horas

Intervalo de tiempo, en horas, para el que se devuelve información de sesión del agente histórico. @hours es int y puede ser uno de los siguientes intervalos.

Valor Descripción
< 0 Devuelve información sobre las ejecuciones pasadas del agente, hasta un máximo de 100.
0 (valor predeterminado) Devuelve información sobre todas las ejecuciones pasadas del agente.
> 0 Devuelve información sobre las ejecuciones del agente que se produjeron en el último número de horas .

[ @session_type = ] session_type

Filtra el conjunto de resultados según el resultado del fin de la sesión. @session_type es int y puede ser uno de estos valores.

Valor Descripción
1 (valor predeterminado) Sesiones del agente con un reintento o un resultado correcto.
0 Sesiones del agente con un resultado erróneo.

[ @publisher = ] N'publisher'

El nombre del publicador. @publisher es sysname, con un valor predeterminado de NULL. Este parámetro se usa al ejecutar sp_replmonitorhelpmergesession en el suscriptor.

[ @publisher_db = ] N'publisher_db'

Nombre de la base de datos de publicación. @publisher_db es sysname, con un valor predeterminado de NULL. Este parámetro se usa al ejecutar sp_replmonitorhelpmergesession en el suscriptor.

[ @publication = ] N'publication'

Nombre de la publicación. @publication es sysname, con un valor predeterminado de NULL. Este parámetro se usa al ejecutar sp_replmonitorhelpmergesession en el suscriptor.

Conjunto de resultados

Nombre de la columna Tipo de datos Descripción
Session_id int Identificador de la sesión de trabajo del agente.
Status int Estado de la ejecución del agente:

1 = Iniciar

2 = Correcto

3 = En curso

4 = Inactivo

5 = Reintento

6 = Error
StartTime datetime Hora en que se inició la sesión de trabajo de agente.
EndTime datetime Hora en que finalizó la sesión de trabajo de agente.
Duration int Duración acumulada, en segundos, de esta sesión de trabajo.
UploadedCommands int Número de comandos cargados durante la sesión del agente.
DownloadedCommands int Número de comandos descargados durante la sesión del agente.
ErrorMessages int Número de mensajes de error generados durante la sesión del agente.
ErrorID int Id. del error producido.
PercentageDone decimal Porcentaje estimado de los cambios totales que ya se han entregado en una sesión activa.
TimeRemaining int Número estimado de segundos que restan en una sesión activa.
CurrentPhase int La fase actual de una sesión activa y puede ser una de las siguientes.

1 = Cargar

2 = Descargar
LastMessage nvarchar(500) El último mensaje registrado por Agente de mezcla durante la sesión.

Valores de código de retorno

0 (correcto) o 1 (erróneo).

Comentarios

sp_replmonitorhelpmergesession se usa para supervisar la replicación de mezcla.

Cuando se ejecuta en el suscriptor, sp_replmonitorhelpmergesession solo devuelve información sobre las últimas cinco Agente de mezcla sesiones.

Permisos

Solo los miembros del rol fijo de base de datos db_owner o replmonitor en la base de datos de distribución en el distribuidor o en la base de datos de suscripciones del suscriptor pueden ejecutar sp_replmonitorhelpmergesession.

Contenido relacionado