Überwachen von Ablaufverfolgungen (XMLA)
Sie können den Subscribe-Befehl in XML for Analysis (XMLA) verwenden, um eine vorhandene Ablaufverfolgung zu überwachen, die in einer Instanz von MicrosoftSQL ServerAnalysis Services definiert wurde. Der Subscribe-Befehl gibt die Ergebnisse einer Ablaufverfolgung als Rowset zurück.
Festlegen einer Ablaufverfolgung
DieObjekt-Eigenschaft des Subscribe-Befehls muss einen Objektverweis zu einer Analysis Services-Instanz oder zu einer Ablaufverfolgung in einer Analysis Services-Instanz enthalten. Wenn die Object-Eigenschaft nicht festgelegt wird oder wenn in der Object-Eigenschaft kein Ablaufverfolgungsbezeichner festgelegt wird, überwacht der Subscribe-Befehl die Standardablaufverfolgung der expliziten Sitzung, die im SOAP-Header für den Befehl festgelegt wurde.
Zurückgeben von Ergebnissen
Der Subscribe-Befehl gibt ein Rowset zurück, das die Ablaufverfolgungsereignisse enthält, die von der festgelegten Ablaufverfolgung erfasst wurden. Der Subscribe-Befehl gibt Ablaufverfolgungsergebnisse zurück, bis der Befehl durch den Cancel-Befehl abgebrochen wird.
Das Rowset enthält die in der folgenden Tabelle aufgeführten Spalten.
Spalte |
Datentyp |
Beschreibung |
|---|---|---|
EventClass |
Ganzzahl |
Die von der Ablaufverfolgung empfangene Ereignisklasse des Ereignisses. |
EventSubClass |
Lange ganze Zahl |
Die von der Ablaufverfolgung empfangene Ereignisunterklasse des Ereignisses. |
CurrentTime |
Datetime |
Der Zeitpunkt, zu dem das Ereignis begonnen hat (falls verfügbar). Für das Filtern lauten die erwarteten Formate „JJJJ-MM-TT“ und „JJJJ-MM-TT HH:MM:SS“. |
StartTime |
Datetime |
Der Zeitpunkt, zu dem das Ereignis begonnen hat (falls verfügbar). Für das Filtern lauten die erwarteten Formate „JJJJ-MM-TT“ und „JJJJ-MM-TT HH:MM:SS“. |
EndTime |
Datetime |
Zeitpunkt, zu dem das Ereignis beendet wurde (falls verfügbar). Für das Filtern lauten die erwarteten Formate „JJJJ-MM-TT“ und „JJJJ-MM-TT HH:MM:SS“. Diese Spalte wird nicht für Ereignisklassen aufgefüllt, die den Beginn eines Prozesses oder einer Aktion beschreiben. |
Dauer |
Lange ganze Zahl |
Die Gesamtzeitspanne (in Millisekunden), die für das Ereignis vergangen ist. |
CPUTime |
Lange ganze Zahl |
Die Prozessorzeit (in Millisekunden), die für das Ereignis vergangen ist. |
JobID |
Lange ganze Zahl |
Der Auftragsbezeichner für den Prozess. |
SessionID |
Zeichenfolge |
Der Bezeichner der Sitzung, für die das Ereignis aufgetreten ist. |
SessionType |
Zeichenfolge |
Der Typ der Sitzung, für die das Ereignis aufgetreten ist. |
ProgressTotal |
Lange ganze Zahl |
Der Gesamtfortschritt, der von dem Ereignis gemeldet wurde. |
IntegerData |
Lange ganze Zahl |
Die diesem Ereignis zugeordneten ganzzahligen Daten. Der Inhalt dieser Spalte ist von der Ereignisklasse und der Unterklasse des Ereignisses abhängig. |
ObjectID |
Zeichenfolge |
Der Bezeichner des Objekts, für das das Ereignis aufgetreten ist. |
ObjectType |
Zeichenfolge |
Der Typ des in ObjectName festgelegten Objekts. |
ObjectName |
Zeichenfolge |
Der Name des Objekts, für das das Ereignis aufgetreten ist. |
ObjectPath |
Zeichenfolge |
Der hierarchische Pfad des Objekts, für das das Ereignis aufgetreten ist. Der Pfad wird als kommagetrennte Zeichenfolge von Objektbezeichnern für die übergeordneten Elemente des in ObjectName festgelegten Objekts dargestellt. |
ObjectReference |
Zeichenfolge |
Die XML-Darstellung des Objektverweises für das in ObjectName festgelegte Objekt. |
NestLevel |
Ganzzahl |
Die Ebene der Transaktion, für die das Ereignis aufgetreten ist. |
NumSegments |
Lange ganze Zahl |
Die Anzahl der Datensegmente, die von dem Befehl, für den das Ereignis aufgetreten ist, betroffen ist, oder auf die zugegriffen wurde. |
Severity |
Ganzzahl |
Der Schweregrad einer Ausnahme für das Ereignis. Die Spalte kann einen der folgenden Werte enthalten:
WertBeschreibung
0Success
1Information
2Warning
3Error
|
Success |
Boolean |
Gibt an, ob ein Befehl erfolgreich war oder fehlgeschlagen ist. |
Error |
Lange ganze Zahl |
Die Fehlernummer des Ereignisses (falls zutreffend). |
ConnectionID |
Zeichenfolge |
Der Bezeichner der Verbindung, für die das Ereignis aufgetreten ist. |
DatabaseName |
Zeichenfolge |
Der Name der Datenbank, für die das Ereignis aufgetreten ist. |
NTUserName |
Zeichenfolge |
Der Windows-Benutzername des Benutzers, der dem Ereignis zugeordnet ist. |
NTDomainName |
Zeichenfolge |
Die Windows-Domäne des Benutzers, der dem Ereignis zugeordnet ist. |
ClientHostName |
Zeichenfolge |
Der Name des Computers, auf dem die Clientanwendung ausgeführt wird. Diese Spalte wird mit den von der Clientanwendung übergebenen Werten aufgefüllt. |
ClientProcessID |
Lange ganze Zahl |
Der Prozessbezeichner der Clientanwendung. |
ApplicationName |
Zeichenfolge |
Der Name der Clientanwendung, die die Verbindung mit der Analysis Services-Instanz hergestellt hat. Diese Spalte wird mit den Werten aufgefüllt, die von der Clientanwendung übergeben werden, und nicht mit dem angezeigten Namen des Programms. |
NTCanonicalUserName |
Zeichenfolge |
Der kanonische Windows-Benutzername des Benutzers, der dem Ereignis zugeordnet ist. |
SPID |
Zeichenfolge |
Die Serverprozess-ID (SPID) der Sitzung, für die das Ereignis aufgetreten ist. Der Wert dieser Spalte entspricht direkt der Sitzungs-ID, die im SOAP-Header der XMLA-Nachricht festgelegt wurde, für die das Ereignis aufgetreten ist. |
TextData |
Zeichenfolge |
Die diesem Ereignis zugeordneten Textdaten. Der Inhalt dieser Spalte ist von der Ereignisklasse und der Unterklasse des Ereignisses abhängig. |
ServerName |
Zeichenfolge |
Der Name der Analysis Services-Instanz, für die das Ereignis aufgetreten ist. |
RequestParameters |
Zeichenfolge |
Die Parameter der parametrisierten Abfrage oder des XMLA-Befehls, für die oder den das Ereignis aufgetreten ist. |
RequestProperties |
Zeichenfolge |
Die Eigenschaften der XMLA-Methode, für die das Ereignis aufgetreten ist. |