PublisherMonitor.EnumMergeAgentSessions2(String, Int32, Boolean) Methode

Referenz

Definition

Namespace:: Microsoft.SqlServer.Replication

Assembly:: Microsoft.SqlServer.Rmo.dll

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.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

DataSet

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).

Gilt für: