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.

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 Publikationsdatenbank. 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 Publikation. publication ist vom Datentyp sysname, der Standardwert ist NULL. Dieser Parameter wird beim Ausführen von sp_replmonitorhelpmergesession auf dem Abonnenten verwendet.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

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 geuploadet wurden.
DownloadedCommands	int	Anzahl von Befehlen, die während der Agentsitzung gedownloadet 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.

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.

Siehe auch

Andere Ressourcen

How to: Programmatically Monitor Replication (Replication Transact-SQL Programming)

Hilfe und Informationen

Informationsquellen für SQL Server 2005