sp_replmonitorhelpmergesession (Transact-SQL)
Retourne des informations sur les sessions passées d'un Agent de fusion de réplication, à raison d'une ligne par session correspondant au critère de filtrage. Cette procédure stockée, qui est utilisée pour surveiller la réplication de fusion, est exécutée sur la base de données de distribution du serveur de distribution ou sur la base de données d'abonnement de l'Abonné.
.gif "Icône Lien de rubrique")
Conventions de la syntaxe de Transact-SQL
Syntaxe
sp_replmonitorhelpmergesession [ [ @agent_name = ] 'agent_name' ]
[ , [ @hours = ] hours ]
[ , [ @session_type = ] session_type ]
[ , [ @publisher = ] 'publisher' ]
[ , [ @publisher_db = ] 'publisher_db' ]
[ , [ @publication = ] 'publication' ]
Arguments
[ @agent_name = ] 'agent_name'
Nom de l'agent. agent_name est de type nvarchar(100), sans valeur par défaut.[ @hours = ] hours
Plage horaire pour laquelle sont retournées les informations d'historique des sessions de l'Agent. hours est de type int et peut correspondre à l'une des plages suivantes.Valeur
Description
< 0
Retourne des informations sur les exécutions passées de l'Agent, dans la limite de 100 exécutions.
0 (valeur par défaut)
Retourne des informations sur toutes les exécutions passées de l'Agent.
> 0
Retourne des informations sur les exécutions de l'Agent qui se sont produites au cours de la dernière plage horaire (hours).
[ @session_type = ] session_type
Filtre l'ensemble de résultats en fonction du résultat final de la session. session_type est de type int et peut prendre l'une des valeurs suivantes.Valeur
Description
1 (valeur par défaut)
Sessions de l'Agent se soldant par une nouvelle tentative ou par un succès.
0
Sessions de l'Agent se soldant par un échec.
[ @publisher = ] 'publisher'
Nom du serveur de publication. publisher est de type sysname, avec NULL comme valeur par défaut. Ce paramètre est utilisé lors de l'exécution de sp_replmonitorhelpmergesession sur l'Abonné.[ @publisher_db = ] 'publisher_db'
Nom de la base de données de publication. publisher_db est de type sysname, avec NULL comme valeur par défaut. Ce paramètre est utilisé lors de l'exécution de sp_replmonitorhelpmergesession sur l'Abonné.[ @publication= ] 'publication'
Nom de la publication. publication est de type sysname, avec NULL comme valeur par défaut. Ce paramètre est utilisé lors de l'exécution de sp_replmonitorhelpmergesession sur l'Abonné.
Jeux de résultats
Nom de la colonne |
Type de données |
Description |
|---|---|---|
Session_id |
int |
ID de la session de travail d'Agent. |
Statut |
int |
État de l'exécution de l'Agent : 1 = démarrage 2 = Succès 3 = Opération en cours 4 = Inactif 5 = Nouvelle tentative 6 = Échec |
StartTime |
datetime |
Heure à laquelle la session de travail d'Agent a commencé. |
EndTime |
datetime |
Heure à laquelle la session de travail d'Agent s'est achevée. |
Duration |
int |
Durée cumulée de cette session de travail (en secondes) |
UploadedCommands |
int |
Nombre de commandes téléchargées (upload) pendant la session d'Agent. |
DownloadedCommands |
int |
Nombre de commandes téléchargées (download) pendant la session d'Agent. |
ErrorMessages |
int |
Nombre de messages d'erreur générés pendant la session d'Agent. |
ErrorID |
int |
ID de l'erreur qui s'est produite |
PercentageDone |
decimal |
Pourcentage estimé des modifications déjà remises dans une session active. |
TimeRemaining |
int |
Nombre estimé de secondes restantes dans une session active. |
CurrentPhase |
int |
Phase actuelle d'une session active ; ce paramètre peut prendre l'une des valeurs suivantes. 1 = téléchargement (Upload) 2 = téléchargement (Download) |
LastMessage |
nvarchar(500) |
Dernier message journalisé par l'Agent de fusion pendant la session. |
Valeurs des codes de retour
0 (succès) ou 1 (échec)
Notes
sp_replmonitorhelpmergesession permet de surveiller la réplication des fusions.
Lorsque vous l'exécutez sur l'Abonné, sp_replmonitorhelpmergesession retourne uniquement des informations relatives aux cinq dernières sessions d'Agent de fusion.
Autorisations
Seuls les membres du rôle de base de données fixe db_owner ou replmonitor de la base de données de distribution sur le serveur de distribution ou de la base de données d'abonnement sur l'Abonné peuvent exécuter sp_replmonitorhelpmergesession.