sp_replmonitorhelpmergesession (Transact-SQL)

S’applique à : SQL Server Azure SQL Managed Instance

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é.

Conventions de la syntaxe Transact-SQL

Syntaxe

sp_replmonitorhelpmergesession
    [ [ @agent_name = ] N'agent_name' ]
    [ , [ @hours = ] hours ]
    [ , [ @session_type = ] session_type ]
    [ , [ @publisher = ] N'publisher' ]
    [ , [ @publisher_db = ] N'publisher_db' ]
    [ , [ @publication = ] N'publication' ]
[ ; ]

Arguments

[ @agent_name = ] N’agent_name'

Nom de l’agent. @agent_name est nvarchar(100), sans valeur par défaut.

[ @hours = ] heures

Intervalle de temps, en heures, pour lequel les informations de session de l’agent historique sont retournées. @hours est int et peut être 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 des dernières heures .

[ @session_type = ] session_type

Filtre l'ensemble de résultats en fonction du résultat final de la session. @session_type est int et peut être l’une de ces valeurs.

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 = ] N’publisher'

Nom du serveur de publication. @publisher est sysname, avec la valeur par défaut NULL. Ce paramètre est utilisé lors de l’exécution sp_replmonitorhelpmergesession sur l’Abonné.

[ @publisher_db = ] N’publisher_db'

Nom de la base de données de publication. @publisher_db est sysname, avec la valeur par défaut NULL. Ce paramètre est utilisé lors de l’exécution sp_replmonitorhelpmergesession sur l’Abonné.

[ @publication = ] N’publication'

Nom de la publication. @publication est sysname, avec la valeur par défaut NULL. Ce paramètre est utilisé lors de l’exécution sp_replmonitorhelpmergesession sur l’Abonné.

Jeu de résultats

Nom de la colonne Type de données Description
Session_id int ID de la session de travail d'Agent.
Status int État de l'exécution de l'Agent :

1 = Démarrer

2 = Réussite

3 = En cours

4 = Inactif

5 = Nouvelle tentative

6 = Échec
StartTime datetime La session de travail de l’agent de temps a commencé.
EndTime datetime La session de travail de l’agent de temps a été terminé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 La phase actuelle d’une session active et peut être l’une des suivantes.

1 = Charger

2 = Télécharger
LastMessage nvarchar(500) Dernier message enregistré par Agent de fusion pendant la session.

Valeurs des codes de retour

0 (réussite) ou 1 (échec).

Notes

sp_replmonitorhelpmergesession est utilisé pour surveiller la réplication de fusion.

Lorsqu’il est exécuté sur l’Abonné, sp_replmonitorhelpmergesession retourne uniquement des informations sur les cinq dernières sessions Agent de fusion.

autorisations

Seuls les membres du rôle de base de données fixe db_owner ou replmonitor sur la base de données de distribution sur le serveur de distribution ou sur la base de données d’abonnement sur l’Abonné peuvent s’exécuter sp_replmonitorhelpmergesession.