PublisherMonitor.EnumDistributionAgentSessions(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 Informationen zu Verteilungs-Agentsitzungen zurück.
public:
System::Data::DataSet ^ EnumDistributionAgentSessions(System::String ^ agentName, int sessionDuration, bool returnOnlyErrorSessions);
public System.Data.DataSet EnumDistributionAgentSessions (string agentName, int sessionDuration, bool returnOnlyErrorSessions);
member this.EnumDistributionAgentSessions : string * int * bool -> System.Data.DataSet
Public Function EnumDistributionAgentSessions (agentName As String, sessionDuration As Integer, returnOnlyErrorSessions As Boolean) As DataSet
Parameter
- agentName
- String
Ein String-Wert, der den Namen des Verteilungs-Agentauftrags angibt. Sie können diesen Wert mithilfe der SynchronizationAgentName-Eigenschaft des TransSubscription-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 Verteilungs-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 zu Sitzungen, bei denen ein Fehler aufgetreten ist, oder zu allen Sitzungen zurückgegeben werden. 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 |
---|---|---|
runstatus | Int32 | Der Ausführungsstatus: 1 = Start 2 = Erfolg 3 = In Bearbeitung 4 = Im Leerlauf 5 = Wiederholen 6 = Fehler |
start_time | String | Datum und Uhrzeit der letzten Agentausführung. |
time | String | Datum und Uhrzeit der Sitzungsprotokollierung. |
comments | String | Meldungstext, der vom Agent protokolliert wurde. |
duration | Int32 | Verstrichene Zeit der Sitzung, in Sekunden. |
delivery_rate | Single | Durchschnittliche Anzahl der pro Sekunde übermittelten Befehle. |
delivery_latency | Int32 | Latenzzeit (in Millisekunden) zwischen dem Eintritt der Transaktion in die Verteilungsdatenbank und deren Anwendung auf den Abonnenten. |
(Kein Spaltenname) | Nicht verfügbar | Nur zur internen Verwendung. |
delivered_transactions | Int32 | Gesamtzahl der in der Sitzung übermittelten Transaktionen. |
delivered_commands | Int32 | Gesamtzahl der in der Sitzung übermittelten Befehle. |
average_commands | Int32 | Durchschnittliche Anzahl der in der Sitzung pro Transaktion übermittelten Befehle. |
action_count | Int32 | Anzahl von Agentprotokollmeldungen, die in der Sitzung aufgezeichnet wurden. |
error_id | Int32 | Die ID des Fehlers in der Systemtabelle [MSrepl_errors (Transact-SQL)](http://msdn.microsoft.com/library/c6e023c1-2c32-4269-8d76-e442ea309e4b) Verwenden Sie die EnumErrorRecords(Int32)-Methode, um ausführliche Informationen zu einem Fehler zurückzugeben. |
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 EnumDistributionAgentSessions -Methode kann nur von Membern oder db_owner
replmonitor
festen Datenbankrollen in der Verteilungsdatenbank aufgerufen werden.