PublisherMonitor.EnumMergeAgentSessions2(String, Int32, Boolean) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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.DataSetPublic Function EnumMergeAgentSessions2 (agentName As String, sessionDuration As Integer, returnOnlyErrorSessions As Boolean) As DataSetParameter
- 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_id | Int32 | ID der Agentauftragssitzung. |
| Status | Int32 | Agentausführungsstatus: 1 = Start 2 = Erfolg 3 = In Bearbeitung 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. |
| Dauer (Duration) | Int32 | Kumulierte Dauer dieser Agentauftragssitzung in Sekunden |
| UploadedCommands | Int32 | Anzahl von Befehlen, die während der Agentauftragssitzung hochgeladen wurden. |
| DownloadedCommands | Int32 | Anzahl von Befehlen, die während der Agentauftragssitzung heruntergeladen wurden. |
| ErrorMessages | Int32 | Anzahl von Fehlermeldungen, die während der Agentauftragssitzung generiert wurden. |
| ErrorID | Int32 | ID des aufgetretenen Fehlers. |
| PercentageDone | Decimal | Geschätzter Prozentsatz der gesamten Änderungen, die bereits in einer aktiven Sitzung übermittelt wurden. |
| TimeRemaining | Int32 | Geschätzte verbleibende Zeit (in Sekunden) in einer aktiven Sitzung. |
| CurrentPhase | Int32 | Die aktuelle Phase einer aktiven Sitzung kann wie folgt aussehen: 1 = Upload 2 = Download |
| LastMessage | String | 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).