sp_replmonitorhelpmergesession (Transact-SQL)sp_replmonitorhelpmergesession (Transact-SQL)

S’APPLIQUE À : ouiSQL Server ouiAzure SQL Database (Managed Instance uniquement) nonAzure SQL Data Warehouse nonParallel Data Warehouse APPLIES TO: yesSQL Server yesAzure SQL Database (Managed Instance only) noAzure SQL Data Warehouse noParallel Data Warehouse

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.Returns information on past sessions for a given replication Merge Agent, with one row returned for each session that matches the filtering criterion. 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é.This stored procedure, which is used to monitor merge replication, is executed at the Distributor on the distribution database or at the Subscriber on the subscription database.

Icône de lien de rubrique Conventions de la syntaxe Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SyntaxeSyntax

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

ArgumentsArguments

[ @agent_name = ] 'agent_name'Nom de l’agent.[ @agent_name = ] 'agent_name' Is the name of the agent. agent_name est de type nvarchar (100) et n’a pas de valeur par défaut.agent_name is nvarchar(100) with no default.

[ @hours = ] hoursPlage de temps, en heures, pendant laquelle les informations de session de l’agent historique sont retournées.[ @hours = ] hours Is the range of time, in hours, for which historical agent session information is returned. hours est de type int, qui peut être l’une des plages suivantes.hours is int, which can be one of the following ranges.

ValueValue DescriptionDescription
< 0< 0 Retourne des informations sur les exécutions passées de l'Agent, dans la limite de 100 exécutions.Returns information on past agent runs, up to a maximum of 100 runs.
0 (valeur par défaut)0 (default) Retourne des informations sur toutes les exécutions passées de l'Agent.Returns information on all past agent runs.
> 0> 0 Retourne des informations sur les exécutions de l’agent qui se sont produites au cours des dernières heures .Returns information on agent runs that occurred in the last hours number of hours.

[ @session_type = ] session_typeFiltre le jeu de résultats en fonction du résultat final de la session.[ @session_type = ] session_type Filters the result set based on the session end result. session_type est de type intet peut prendre l’une des valeurs suivantes.session_type is int, and can be one of these values.

ValueValue DescriptionDescription
1 (par défaut)1 (default) Sessions de l'Agent se soldant par une nouvelle tentative ou par un succès.Agent sessions with a retry or succeed result.
00 Sessions de l'Agent se soldant par un échec.Agent sessions with a failure result.

[ @publisher = ] 'publisher'Nom du serveur de publication.[ @publisher = ] 'publisher' Is the name of the Publisher. Publisher est de type sysname, avec NULL comme valeur par défaut.publisher is sysname, with a default of NULL. Ce paramètre est utilisé lors de l’exécution de sp_replmonitorhelpmergesession sur l’abonné.This parameter is used when executing sp_replmonitorhelpmergesession at the Subscriber.

[ @publisher_db = ] 'publisher_db'Nom de la base de données de publication.[ @publisher_db = ] 'publisher_db' Is the name of the publication database. publisher_db est de type sysname, avec NULL comme valeur par défaut.publisher_db is sysname, with a default of NULL. Ce paramètre est utilisé lors de l’exécution de sp_replmonitorhelpmergesession sur l’abonné.This parameter is used when executing sp_replmonitorhelpmergesession at the Subscriber.

[ @publication = ] 'publication'Nom de la publication.[ @publication = ] 'publication' Is the name of the publication. publication est de type sysname, avec NULL comme valeur par défaut.publication is sysname, with a default of NULL. Ce paramètre est utilisé lors de l’exécution de sp_replmonitorhelpmergesession sur l’abonné.This parameter is used when executing sp_replmonitorhelpmergesession at the Subscriber.

Jeux de résultatsResult Sets

Nom de la colonneColumn name Type de donnéesData type DescriptionDescription
Session_idSession_id intint ID de la session de travail d'Agent.ID of the agent job session.
ÉtatStatus Intint État de l'exécution de l'Agent :Agent run status:

1 = début1 = Start

2 = opération réussie2 = Succeed

3 = en cours3 = In progress

4 = inactif4 = Idle

5 = nouvelle tentative5 = Retry

6 = échec6 = Fail
StartTimeStartTime datetimedatetime Heure de début de la session de travail de l’agent.Time agent job session began.
EndTimeEndTime datetimedatetime Heure de fin de la session du travail de l’agent.Time agent job session was completed.
DurationDuration Intint Durée cumulée de cette session de travail (en secondes)Cumulative duration, in seconds, of this job session.
UploadedCommandsUploadedCommands intint Nombre de commandes téléchargées (upload) pendant la session d'Agent.Number of commands uploaded during the agent session.
DownloadedCommandsDownloadedCommands Intint Nombre de commandes téléchargées (download) pendant la session d'Agent.Number of commands downloaded during the agent session.
ErrorMessagesErrorMessages intint Nombre de messages d'erreur générés pendant la session d'Agent.Number of error messages that were generated during the agent session.
ErrorIDErrorID intint ID de l'erreur qui s'est produiteID of the error that occurred
PercentageDonePercentageDone decimaldecimal Pourcentage estimé des modifications déjà remises dans une session active.Estimated percent of the total changes that have already been delivered in an active session.
TimeRemainingTimeRemaining intint Nombre estimé de secondes restantes dans une session active.Estimated number of seconds left in an active session.
CurrentPhaseCurrentPhase intint Phase actuelle d'une session active ; ce paramètre peut prendre l'une des valeurs suivantes.Is the current phase of an active session, which can be one of the following.

1 = téléchargement1 = Upload

2 = téléchargement2 = Download
LastMessageLastMessage nvarchar(500)nvarchar(500) Dernier message journalisé par l'Agent de fusion pendant la session.Is the last message logged by Merge Agent during the session.

Valeurs des codes de retourReturn Code Values

0 (succès) ou 1 (échec)0 (success) or 1 (failure)

NotesRemarks

sp_replmonitorhelpmergesession est utilisé pour surveiller la réplication de fusion.sp_replmonitorhelpmergesession is used to monitor merge replication.

Lorsqu’il est exécuté sur l’abonné, sp_replmonitorhelpmergesession renvoie uniquement des informations sur les cinq dernières sessions de agent de fusion.When executed on the Subscriber, sp_replmonitorhelpmergesession only returns information on the last five Merge Agent sessions.

AutorisationsPermissions

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 exécuter sp_replmonitorhelpmergesession.Only members of the db_owner or replmonitor fixed database role on the distribution database at the Distributor or on the subscription database at the Subscriber can execute sp_replmonitorhelpmergesession.

Voir aussiSee Also

Surveiller la réplication par programmationProgrammatically Monitor Replication