• Artikel

sp_replmonitorhelpmergesession (Transact-SQL)

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.

Themenlink (Symbol)Transact-SQL-Syntaxkonventionen

Syntax

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

Argumente

  • [ @agent_name = ] 'agent_name'
    Der Name des Agents. agent_name ist vom Datentyp nvarchar(100) und hat keinen Standardwert.

  • [ @hours = ] hours
    Der Zeitabschnitt (in Stunden), für den Verlaufsinformationen zur Agentsitzung zurückgegeben werden. hours ist vom Datentyp int und kann einen der folgenden Bereiche umfassen:

    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 den letzten hours Stunden stattgefunden haben.

  • [ @session_type = ] session_type
    Filtert das Resultset basierend auf dem Endergebnis der Sitzung. session_type ist vom Datentyp int. Die folgenden Werte sind möglich:

    Wert

    Beschreibung

    1 (Standard)

    Agentsitzungen mit einem Neuversuch oder erfolgreichem Abschluss.

    0

    Agentsitzungen mit einem Fehlerergebnis.

  • [ @publisher= ] 'publisher'
    Der Name des Verlegers. publisher ist vom Datentyp sysname; der Standard ist NULL. Dieser Parameter wird beim Ausführen von sp_replmonitorhelpmergesession auf dem Abonnenten verwendet.

  • [ @publisher_db = ] 'publisher_db'
    Der Name der Veröffentlichungsdatenbank. publisher_db ist vom Datentyp sysname; der Standard ist NULL. Dieser Parameter wird beim Ausführen von sp_replmonitorhelpmergesession auf dem Abonnenten verwendet.

  • [ @publication= ] 'publication'
    Der Name der Veröffentlichung. publication ist vom Datentyp sysname, der Standardwert ist NULL. Dieser Parameter wird beim Ausführen von sp_replmonitorhelpmergesession auf dem Abonnenten verwendet.

Resultsets

Spaltenname

Datentyp

Beschreibung

Session_id

int

ID der Agentauftragssitzung.

Status

int

Ausführungsstatus des Agents:

1 = Gestartet

2 = Erfolgreich beendet

3 = Wird ausgeführt

4 = Im Leerlauf

5 = Wiederholen

6 = Fehler

StartTime

datetime

Uhrzeit, zu der die Agentauftragssitzung gestartet wurde.

EndTime

datetime

Uhrzeit, zu der die Agentauftragssitzung beendet wurde.

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, die Folgendes sein kann:

1 = Upload

2 = Download

LastMessage

nvarchar(500)

Die letzte protokollierte Meldung des Merge-Agents während der Sitzung.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Hinweise

sp_replmonitorhelpmergesession wird zum Überwachen von Mergereplikationen verwendet.

Wird die sp_replmonitorhelpmergesession-Prozedur auf dem Abonnenten ausgeführt, gibt sie nur Informationen zu den letzten fünf Sitzungen des Merge-Agents zurück.

Berechtigungen

Nur Mitglieder der festen Datenbankrolle db_owner oder replmonitor für die Verteilungsdatenbank auf dem Verteiler oder für die Abonnementdatenbank auf dem Abonnenten können sp_replmonitorhelpmergesession ausführen.