Partager via


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

Icône Lien de rubriqueConventions 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) et n'a pas de 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. Sa valeur par défaut est NULL. 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. L'argument publisher_db est de type sysname, avec la valeur NULL 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. L'argument publication est de type sysname, avec la valeur NULL 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 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émarrage

2 = succès

3 = en cours

4 = inactif

5 = reprise

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.