sp_replmonitorhelpmergesession (Transact-SQL)

  • Artikel

Gilt für:SQL ServerAzure SQL Managed Instance

Gibt Informationen zu vergangenen Sitzungen für einen angegebenen Replikationsmerge-Agent zurück. Für jede Sitzung, die den Filterkriterien entspricht, wird dabei eine Zeile zurückgegeben. Diese gespeicherte Prozedur dient zum Überwachen der Mergereplikation. Sie wird beim Verteiler auf der Verteilungsbank oder beim Abonnenten auf der Abonnementdatenbank ausgeführt.

Transact-SQL-Syntaxkonventionen

Syntax

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

Argumente

[ @agent_name = ] N'agent_name'

Der Name des Agents. @agent_name ist nvarchar(100), ohne Standard.

[ @hours = ] Stunden

Der Zeitraum in Stunden, für den Historische Agent-Sitzungsinformationen zurückgegeben werden. @hours ist int und kann eines der folgenden Bereiche sein:

Wert Beschreibung
< 0 Gibt Informationen zu vergangenen Agentausführungen (bis zu maximal 100 Ausführungen) zurück.
0 (Standard) Gibt Informationen zu allen vergangenen Agentausführungen zurück.
> 0 Gibt Informationen zu Agentausführungen zurück, die in der letzten Stundenanzahl aufgetreten sind.

[ @session_type = ] session_type

Filtert das Resultset auf Grundlage des Sitzungsendergebnisses. @session_type ist int und kann einer dieser Werte sein.

Wert Beschreibung
1 (Standardwert) Agentsitzungen mit einem Neuversuch oder erfolgreichem Abschluss.
0 Agentsitzungen mit einem Fehlerergebnis.

[ @publisher = ] N'publisher'

Der Name des Herausgebers. @publisher ist "sysname" mit der Standardeinstellung "NULL. Dieser Parameter wird beim Ausführen sp_replmonitorhelpmergesession beim Abonnenten verwendet.

[ @publisher_db = ] N'publisher_db'

Der Name der Publikationsdatenbank. @publisher_db ist "sysname" mit der Standardeinstellung "NULL. Dieser Parameter wird beim Ausführen sp_replmonitorhelpmergesession beim Abonnenten verwendet.

[ @publication = ] N'Publikation'

Der Name der Veröffentlichung. @publication ist "sysname" mit der Standardeinstellung "NULL. Dieser Parameter wird beim Ausführen sp_replmonitorhelpmergesession beim Abonnenten verwendet.

Resultset

Spaltenname Datentyp BESCHREIBUNG
Session_id int ID der Agentauftragssitzung.
Status int Agent-Ausführungsstatus:

1 = Start

2 = Erfolgreich

3 = In Bearbeitung

4 = Leerlauf

5 = Wiederholen

6 = Fehler
StartTime datetime Zeit-Agent-Auftragssitzung begann.
EndTime datetime Die Zeit-Agent-Auftragssitzung wurde abgeschlossen.
Duration int Kumulierte Dauer dieser Auftragssitzung in Sekunden.
UploadedCommands int Anzahl von Befehlen, die während der Agentsitzung hochgeladen wurden.
DownloadedCommands int Anzahl von Befehlen, die während der Agentsitzung heruntergeladen wurden.
ErrorMessages int Anzahl von Fehlermeldungen, die während der Agentsitzung generiert wurden.
ErrorID int ID des aufgetretenen Fehlers.
PercentageDone decimal Geschätzter prozentualer Anteil an der Gesamtzahl von Änderungen, die bereits in einer aktiven Sitzung zugestellt wurden.
TimeRemaining int Geschätzte verbleibende Zeit (in Sekunden) in einer aktiven Sitzung.
CurrentPhase int Die aktuelle Phase einer aktiven Sitzung und kann eine der folgenden Sein:

1 = Hochladen

2 = Herunterladen
LastMessage nvarchar(500) Die letzte von Merge-Agent während der Sitzung protokollierte Nachricht.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler).

Hinweise

sp_replmonitorhelpmergesession wird verwendet, um die Seriendruckreplikation zu überwachen.

Wenn sie auf dem Abonnenten ausgeführt wird, sp_replmonitorhelpmergesession werden nur Informationen zu den letzten fünf Merge-Agent Sitzungen zurückgegeben.

Berechtigungen

Nur Mitglieder der db_owner- oder replmonitor-Festen Datenbankrolle in der Verteilungsdatenbank im Distributor oder in der Abonnementdatenbank des Abonnenten können ausgeführt werdensp_replmonitorhelpmergesession.

Zugehöriger Inhalt