Freigeben über


PublisherMonitor.EnumMergeAgentSessions2(String, Int32, Boolean) Methode

Definition

Gibt zusätzliche Informationen zu Merge-Agentsitzungen zurück.

public:
 System::Data::DataSet ^ EnumMergeAgentSessions2(System::String ^ agentName, int sessionDuration, bool returnOnlyErrorSessions);
public System.Data.DataSet EnumMergeAgentSessions2 (string agentName, int sessionDuration, bool returnOnlyErrorSessions);
member this.EnumMergeAgentSessions2 : string * int * bool -> System.Data.DataSet
Public Function EnumMergeAgentSessions2 (agentName As String, sessionDuration As Integer, returnOnlyErrorSessions As Boolean) As DataSet

Parameter

agentName
String

Ein String-Wert, der den Namen des Merge-Agentauftrags angibt. Sie können diesen Wert mithilfe der SynchronizationAgentName-Eigenschaft des MergeSubscription-Objekts abrufen.

sessionDuration
Int32

Ein Int32-Wert, der die Anzahl der Stunden vor der aktuellen Zeit angibt, auf die die Ergebnisse beschränkt werden. Wenn der Wert z. B. "24" ist, werden Informationen zu Agentsitzungen der letzten 24 Stunden zurückgegeben. Bein einem Wert von "-1" werden Informationen zu den letzten 100 Sitzungen und bei einem Wert von "0" Informationen zu allen Sitzungen zurückgegeben.

returnOnlyErrorSessions
Boolean

Ein Boolean Wert, der angibt, ob Informationen nur für Sitzungen zurückgegeben werden sollen, die zu einem Fehler geführt haben, oder für alle Sitzungen. Wenn true, werden nur Informationen zu Sitzungen zurückgegeben, bei denen ein Fehler aufgetreten ist. Wenn false, werden Informationen zu allen Sitzungen zurückgegeben.

Gibt zurück

Ein DataSet-Objekt, das die folgenden Spalten enthält.

Column Datentyp BESCHREIBUNG
Session_idInt32 ID der Agentauftragssitzung.
StatusInt32 Agentausführungsstatus:

1 = Start

2 = Erfolg

3 = In Bearbeitung

4 = Im Leerlauf

5 = Wiederholen

6 = Fehler

StartTimeDateTime Uhrzeit, zu der die Agentauftragssitzung gestartet wurde.
EndTimeDateTime Uhrzeit, zu der die Agentauftragssitzung beendet wurde.
Dauer (Duration)Int32 Kumulierte Dauer dieser Agentauftragssitzung in Sekunden
UploadedCommandsInt32 Anzahl von Befehlen, die während der Agentauftragssitzung hochgeladen wurden.
DownloadedCommandsInt32 Anzahl von Befehlen, die während der Agentauftragssitzung heruntergeladen wurden.
ErrorMessagesInt32 Anzahl von Fehlermeldungen, die während der Agentauftragssitzung generiert wurden.
ErrorIDInt32 ID des aufgetretenen Fehlers.
PercentageDoneDecimal Geschätzter Prozentsatz der gesamten Änderungen, die bereits in einer aktiven Sitzung übermittelt wurden.
TimeRemainingInt32 Geschätzte verbleibende Zeit (in Sekunden) in einer aktiven Sitzung.
CurrentPhaseInt32 Die aktuelle Phase einer aktiven Sitzung kann wie folgt aussehen:

1 = Upload

2 = Download

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

Hinweise

Sie sollten alle Eigenschaftsänderungen am PublisherMonitor Objekt committen, bevor Sie diese Methode aufrufen, da Eigenschaften dieses Objekts möglicherweise geladen werden müssen, wenn sie noch nicht geladen wurden.

Die EnumMergeAgentSessions2 -Methode kann nur von Membern oder db_ownerreplmonitor festen Datenbankrollen in der Verteilungsdatenbank aufgerufen werden.

Das Aufrufen EnumMergeAgentSessions2 entspricht der Ausführung sp_replmonitorhelpmergesession (Transact-SQL).

Gilt für:

Weitere Informationen