sp_replmonitorhelpmergesession (Transact-SQL)

Devuelve información acerca de sesiones pasadas de un Agente de mezcla de réplica concreto, con una fila por cada sesión que coincida con el criterio de filtrado. Este procedimiento almacenado, que se utiliza para supervisar la réplica 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 = ] 'agent_name' ]
    [ , [ @hours = ] hours ]
    [ , [ @session_type = ] session_type ]
    [ , [ @publisher = ] 'publisher' ]
    [ , [ @publisher_db = ] 'publisher_db' ]
    [ , [ @publication = ] 'publication' ] 

Argumentos

• [ @agent_name = ] 'agent_name'
  Es el nombre del agente. agent_name es de tipo nvarchar(100) y no tiene ningún valor predeterminado.

• [ @hours = ] hours
  Es el intervalo temporal en horas sobre el que se devuelve información de historial de las sesiones del agente. hours es de tipo int y puede tener 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 han tenido lugar en el último número de horas hours.

• [ @session_type = ] session_type
  Filtra el conjunto de resultados según el resultado del fin de la sesión. session_type es de tipo int y puede tener 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 = ] 'publisher'
  Es el nombre del publicador. publisher es de tipo sysname y su valor predeterminado es NULL. Este parámetro se utiliza al ejecutar sp_replmonitorhelpmergesession en el suscriptor.

• [ @publisher_db = ] 'publisher_db'
  Es el nombre de la base de datos de publicaciones. publisher_db es de tipo sysname y su valor predeterminado es NULL. Este parámetro se utiliza al ejecutar sp_replmonitorhelpmergesession en el suscriptor.

• [ @publication= ] 'publication'
  Es el nombre de la publicación. publication es de tipo sysname y su valor predeterminado es NULL. Este parámetro se utiliza al ejecutar sp_replmonitorhelpmergesession en el suscriptor.

Conjuntos de resultados

Nombre de columna	Tipo de datos	Descripción
Session_id	int	Id. de la sesión de trabajo de agente.
Status	int	Estado de la ejecución del agente: 1 = Inicio 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	Es la fase actual de una sesión activa y puede ser una de las siguientes. 1 = Carga 2 = Descarga
LastMessage	nvarchar(500)	Es el último mensaje registrado por el Agente de mezcla durante la sesión.

Notas

sp_replmonitorhelpmergesession se utiliza para supervisar la réplica de mezcla.

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

Permisos

Sólo los miembros de las funciones fijas de base de datos db_owner o replmonitor de la base de datos de distribución del distribuidor o de la base de datos de suscripciones del suscriptor pueden ejecutar sp_replmonitorhelpmergesession.

Valores de código de retorno

0 (correcto) o 1 (error)

Vea también

Otros recursos

How to: Programmatically Monitor Replication (Replication Transact-SQL Programming)

Ayuda e información

Obtener ayuda sobre SQL Server 2005