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.
.gif "Icono de vínculo a temas")
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)