Ziele für erweiterte Ereignisse in SQL Server

  • Artikel

Gilt für:SQL ServerAzure SQL Managed Instance

In diesem Artikel wird erläutert, wann und wie sie die Paket0-Ziele für erweiterte Ereignisse in SQL Server verwenden. Der vorliegende Artikel erläutert für jedes Ziel:

  • dessen Fähigkeiten im Sammeln und Melden der von Ereignissen gesendeten Daten
  • dessen Parameter, es sei denn, der Parameter ist selbsterklärend

XQuery-Beispiel

Der ring_buffer-Abschnitt enthält ein Beispiel zur Verwendung von XQuery in Transact-SQL zum Kopieren einer XML-Zeichenfolge in ein relationales Rowset.

Voraussetzungen

  • Machen Sie sich mit den Grundlagen erweiterter Ereignisse vertraut, wie in der Schnellstartanleitung beschrieben: Erweiterte Ereignisse in SQL Server.

  • Sie haben eine aktuelle Version des häufig aktualisierten Hilfsprogramms SQL Server Management Studio (SSMS) installiert. Einzelheiten dazu finden Sie unter:

  • In SSMS.exe sollte die Verwendung des Objekt-Explorers bekannt sein, um mit der rechten Maustaste auf den Zielknoten für die Ereignissitzung zu klicken, um die bequeme Anzeige der Ausgabedatenzu erreichen.

    • Die Ereignisdaten werden als XML-Zeichenfolge erfasst. Hingegen werden die Daten in diesem Artikel als relationale Zeilen angezeigt. SSMS wurde zum Anzeigen der Daten verwendet, daraus wurden sie kopiert und in diesen Artikel eingefügt.
    • Die alternative T-SQL-Technik zum Generieren von Rowsets aus XML wird im ring_buffer-Abschnitterläutert. Sie umfasst den Einsatz von XQuery.

Parameter, Aktionen und Felder

In Transact-SQL ist die CREATE EVENT SESSION-Anweisung für erweiterte Ereignisse zentral. Zum Erstellen der Anweisung benötigen Sie in vielen Fällen eine Liste und eine Beschreibung folgender Punkte:

  • die dem ausgewählten Ereignis zugeordneten Felder
  • die dem ausgewählten Ziel zugeordneten Parameter

SELECT-Anweisungen, die solche Listen aus Systemansichten zurückgeben, stehen in ihrem Abschnitt C zum Kopieren aus dem folgenden Artikel zur Verfügung:

Sie können die im Kontext einer realen CREATE EVENT SESSION-Anweisung verwendeten Parameter, Felder und Aktionen über diesen Linkanzeigen.

etw_classic_sync_target-Ziel

Erweiterte SQL Server-Ereignisse können mit der Ereignisablaufverfolgung für Windows (ETW) zusammenarbeiten, um die Systemaktivität zu überwachen. Weitere Informationen finden Sie unter:

Dieses ETW-Ziel verarbeitet die empfangenen Daten synchron , während die meisten Ziele asynchroneVerarbeitung aufweisen.

Hinweis

Die verwaltete Azure SQL-Instanz und die Azure SQL-Datenbank unterstützen das etw_classic_sync_target Ziel nicht. Verwenden Sie stattdessen event_file .xel-Dateien, die in Azure Blob Storage gespeichert sind.

event_counter-Ziel

Das event_counter-Ziel zählt lediglich, wie oft jedes angegebene Ereignis eintritt.

Im Gegensatz zu den meisten anderen Zielen:

  • besitzt event_counter keine Parameter
  • Im Gegensatz zu den meisten Zielen verarbeitet das event_counter-Ziel die empfangenen Daten synchron
    • Die synchrone Verarbeitung ist für den einfachen event_counter akzeptabel, da event_counter sehr wenig Verarbeitungsleitung beansprucht
    • Das Datenbankmodul trennt sich von allen Zielen, die zu langsam sind und dadurch die Leistung des Datenbankmoduls verlangsamen. Das ist ein Grund, warum die meisten Ziele asynchroneVerarbeitung aufweisen.

Von event_counter erfasste Beispielausgabe

package_name   event_name         count
------------   ----------         -----
sqlserver      checkpoint_begin   4

Der nächste Punkt ist die CREATE EVENT SESSION, die zu den vorstehenden Ergebnissen geführt hat. Für diesen Test wurde in der EVENT...WHERE-Klausel das Feld package0.counter verwendet, um die Zählung abzubrechen, nachdem die Anzahl auf 4 angestiegen ist.

CREATE EVENT SESSION [event_counter_1]
    ON SERVER 
    ADD EVENT sqlserver.checkpoint_begin   -- Test by issuing CHECKPOINT; statements.
    (
        WHERE ([package0].[counter] <= (4))   -- A predicate filter.
    )
    ADD TARGET package0.event_counter
    WITH
    (
        MAX_MEMORY = 4096 KB,
        MAX_DISPATCH_LATENCY = 3 SECONDS
    );

event_file-Ziel

Das Ziel event_file schreibt Ereignissitzungsausgaben vom Puffer in eine Datenträgerdatei:

  • Sie geben den Parameter filename= in der ADD TARGET-Klausel an.
    • Die Erweiterung der Datei muss.xel lauten.
  • Der gewählte Dateiname wird vom System als Präfix verwendet, an das eine auf Datum-/Uhrzeit basierende Ganzzahl vom Typ long integer angehängt wird, gefolgt von der XEL-Erweiterung.

Hinweis

Azure SQL Managed Instance und Azure SQL-Datenbank unterstützen nur das Speichern von xel Dateien in Azure Blob Storage.

Ein event_file Codebeispiel für SQL-Datenbank oder sql Managed Instance finden Sie unter Ereignisdateizielcode für erweiterte Ereignisse in SQL-Datenbank.

CREATE EVENT SESSION mit event_file

Nun folgt die CREATE EVENT SESSION, die wir für den Test verwendet haben. Eine der ADD TARGET-Klauseln gibt eine event_file-Datei an.

CREATE EVENT SESSION [locks_acq_rel_eventfile_22]
    ON SERVER 
    ADD EVENT sqlserver.lock_acquired
    (
        SET
            collect_database_name=(1),
            collect_resource_description=(1)

        ACTION (sqlserver.sql_text,sqlserver.transaction_id)

        WHERE
        (
            [database_name]=N'InMemTest2'
            AND
            [object_id]=(370100359)
        )
    ),
    ADD EVENT sqlserver.lock_released
    (
        SET
            collect_database_name=(1),
            collect_resource_description=(1)

        ACTION(sqlserver.sql_text,sqlserver.transaction_id)

        WHERE
        (
            [database_name]=N'InMemTest2'
            AND
            [object_id]=(370100359)
        )
    )
    ADD TARGET package0.event_counter,
    ADD TARGET package0.event_file
    (
        SET     filename=N'C:\Junk\locks_acq_rel_eventfile_22-.xel'
    )
    WITH
    (
        MAX_MEMORY=4096 KB,
        MAX_DISPATCH_LATENCY=10 SECONDS
    );

sys.fn_xe_file_target_read_file-Funktion

Das event_file Ziel speichert die Empfangenen Daten in einem Binärformat, das nicht lesbar ist. Transact-SQL kann den Inhalt der xel-Datei von SELECTing aus der sys.fn_xe_file_target_read_file-Funktion melden.

Für SQL Server 2016 und höher hat die folgende T-SQL SELECT-Anweisung die Daten gemeldet. Das Suffix *.xel im Dateinamen ist erforderlich.

SELECT f.*
        --,CAST(f.event_data AS XML)  AS [Event-Data-Cast-To-XML]  -- Optional
    FROM
        sys.fn_xe_file_target_read_file(
            'C:\junk\locks_acq_rel_eventfile_22-*.xel',
            null, null, null)  AS f;

Für SQL Server 2014würde eine SELECT-Anweisung ähnlich der folgenden die Meldung der Daten übernehmen. Nach SQL Server 2014 werden keine XEM-Dateien mehr verwendet.

SELECT f.*
        --,CAST(f.event_data AS XML)  AS [Event-Data-Cast-To-XML]  -- Optional
    FROM
        sys.fn_xe_file_target_read_file(
            'C:\junk\locks_acq_rel_eventfile_22-*.xel',
            'C:\junk\metafile.xem',
            null, null)  AS f;

Natürlich können Sie auch die SSMS-Benutzeroberfläche manuell verwenden, um die .xel-Daten anzuzeigen.

Im event_file-Ziel gespeicherte Daten

Als Nächstes ist der Bericht von SELECTing aus sys.fn_xe_file_target_read_file, in SQL Server 2016.

module_guid                            package_guid                           object_name     event_data                                                                                                                                                                                                                                                                                          file_name                                                      file_offset
-----------                            ------------                           -----------     ----------                                                                                                                                                                                                                                                                                          ---------                                                      -----------
D5149520-6282-11DE-8A39-0800200C9A66   03FDA7D0-91BA-45F8-9875-8B6DD0B8E9F2   lock_acquired   <event name="lock_acquired" package="sqlserver" timestamp="2016-08-07T20:13:35.827Z"><action name="transaction_id" package="sqlserver"><value>39194</value></action><action name="sql_text" package="sqlserver"><value><![CDATA[  select top 1 * from dbo.T_Target;  ]]></value></action></event>   C:\junk\locks_acq_rel_eventfile_22-_0_131150744126230000.xel   11776
D5149520-6282-11DE-8A39-0800200C9A66   03FDA7D0-91BA-45F8-9875-8B6DD0B8E9F2   lock_released   <event name="lock_released" package="sqlserver" timestamp="2016-08-07T20:13:35.832Z"><action name="transaction_id" package="sqlserver"><value>39194</value></action><action name="sql_text" package="sqlserver"><value><![CDATA[  select top 1 * from dbo.T_Target;  ]]></value></action></event>   C:\junk\locks_acq_rel_eventfile_22-_0_131150744126230000.xel   11776

Histogrammziel

Das histogram -Ziel ist cooler als das event_counter-Ziel. histogram kann Folgendes:

  • Vorkommen für mehrere Elemente separat zählen
  • Zählen von Vorkommen verschiedener Elementtypen:
    • Ereignisfelder
    • Aktionen:

Der Parameter source_type bildet den Schlüssel bei der Steuerung des histogram-Ziels:

  • source_type=0 : Sammeln von Daten für Ereignisfelder
  • source_type=1 : Sammeln von Daten für Aktionen
    • 1 ist der Standardwert

Der Standardwert des Parameters „slots“ ist 256. Wenn Sie einen anderen Wert zuweisen, wird der Wert auf die nächste Potenz von 2 aufgerundet.

  • Beispielsweise würde „slots=59“ auf „=64“ aufgerundet.

Während einer Erweiterten Ereignissitzung mit Histogramm als Ziel werden manchmal unerwartete Ergebnisse angezeigt. Einige Ereignisse werden möglicherweise nicht gleichzeitig angezeigt, wenn die Anzahl anderer Ereignisse einen höheren Wert aufweist als sie sollten.

Dies ist ein Nebeneffekt des Histogramm-Zieldesigns. Die Histogrammentität verwendet eine Hashfunktion, um Entitäten in Buckets zu aggregieren. Je nach Auswahl des Aggregationsfelds werden daher möglicherweise zwei Objekte im gleichen Bucket gespeichert, und beide Objekte werden unter dem Namen der ersten Ausgeführten angezeigt.

Dies kann auch passieren, wenn Sie den NO_EVENT_LOSS Parameter verwenden. Betrachten Sie folgendes Szenario:

  • Sie richten eine Erweiterte Ereignissitzung mit Histogramm als Ziel und Gruppierung nach object_idein, um die Ausführung gespeicherter Prozeduren zu sammeln.
  • Sie führen die gespeicherte Prozedur A aus. Anschließend führen Sie die gespeicherte Prozedur B aus.

Wenn beide gespeicherten Prozeduren object_id denselben Wert für die Hashfunktion zurückgeben, zeigt das Histogramm die gespeicherte Prozedur A zweimal an, und die gespeicherte Prozedur B wird nicht angezeigt.

Action -Beispiel für histogram

In der TARGET...SET-Klausel legt die folgende Transact-SQL CREATE EVENT SESSION-Anweisung die Zielparameterzuweisung als source_type=1fest. Die 1 bedeutet, dass das histogram-Ziel eine Aktion nachverfolgt.

Im vorliegenden Beispiel wird das EREIGNIS... DAS ACTION-Klauselangebot bietet nur eine Aktion für das zu wählende Ziel an, nämlich sqlos.system_thread_id. Auf dem ZIEL... SET-Klausel wird die Zuordnungszuweisung source=N'sqlos.system_thread_id' angezeigt.

Hinweis

Es ist nicht möglich, pro Ereignissitzung mehr als ein Ziel desselben Typs (einschließlich das Histogrammziel) hinzuzufügen. Es ist auch nicht möglich, mehr als eine Quelle (Aktions-/Ereignisfeld) pro Histogrammziel zu verwenden. Daher ist eine neue Ereignissitzung erforderlich, um zusätzliche Aktionsfelder (oder Ereignisfelder) in einem neuen Histogrammziel nachzuverfolgen.

CREATE EVENT SESSION [histogram_lockacquired]
    ON SERVER 
    ADD EVENT sqlserver.lock_acquired
        (
        ACTION
            (
            sqlos.system_thread_id
            )
        )
    ADD TARGET package0.histogram
        (
        SET
            filtering_event_name=N'sqlserver.lock_acquired',
            slots=(16),
            source=N'sqlos.system_thread_id',
            source_type=1
        )
    WITH
        (
        <.... (For brevity, numerous parameter assignments generated by SSMS.exe are not shown here.) ....>
        );

Die folgenden Daten wurden erfasst. Die Werte in der Spalte value waren system_thread_id-Werte. Beispielsweise wurden im Thread 6540 insgesamt 236 Sperren in Anspruch genommen.

value   count
-----   -----
 6540     236
 9308      91
 9668      74
10144      49
 5244      44
 2396      28

Verwenden von SELECT zum Entdecken der verfügbaren Aktionen

Die C.3 SELECT-Anweisung kann die Aktionen finden, die Ihnen im System zur Angabe in Ihrer CREATE EVENT SESSION-Anweisung zur Verfügung stehen. In der WHERE-Klausel würden Sie zuerst den o.name LIKE Filter bearbeiten, um den Aktionen zu entsprechen, die Sie interessieren.

Hier sehen Sie ein Beispielrowset, das von der C.3 SELECT-Anweisung zurückgegeben wird. Die system_thread_id Aktion wird in der zweiten Zeile angezeigt.

Package-Name   Action-Name                 Action-Description
------------   -----------                 ------------------
package0       collect_current_thread_id   Collect the current Windows thread ID
sqlos          system_thread_id            Collect current system thread ID
sqlserver      create_dump_all_threads     Create mini dump including all threads
sqlserver      create_dump_single_thread   Create mini dump for the current thread

Ereignisfeld -Beispiel für histogram

Im folgenden Beispiel ist source_type=0festgelegt. Der source= zugewiesene Wert ist ein Ereignisfeld (keine Aktion).

CREATE EVENT SESSION [histogram_checkpoint_dbid]
    ON SERVER 
    ADD EVENT  sqlserver.checkpoint_begin
    ADD TARGET package0.histogram
    (
    SET
        filtering_event_name = N'sqlserver.checkpoint_begin',
        source               = N'database_id',
        source_type          = (0)
    )
    WITH
    ( <....> );

Die folgenden Daten wurden vom histogram-Ziel erfasst. Die Daten zeigen, dass in der Datenbank mit ID=5 7 checkpoint_begin-Ereignisse aufgetreten sind.

value   count
-----   -----
5       7
7       4
6       3

Verwenden von SELECT zum Ermitteln der für das ausgewählte Ereignis verfügbaren Felder

Die C.4 SELECT-Anweisung zeigt Ereignisfelder an, unter denen Sie wählen können. Sie würden zuerst den o.name LIKE Filter so bearbeiten, dass er der ausgewählte Ereignisname ist.

Das folgende Rowset wurde von C.4 SELECT zurückgegeben. Das Rowset zeigt, dass database_id es sich um das einzige Feld des checkpoint_begin Ereignisses handelt, das Werte für das Histogrammziel angeben kann.

Package-Name   Event-Name         Field-Name   Field-Description
------------   ----------         ----------   -----------------
sqlserver      checkpoint_begin   database_id  NULL
sqlserver      checkpoint_end     database_id  NULL

pair_matching-Ziel

Mit dem pair_matching Ziel können Sie Startereignisse erkennen, die ohne ein entsprechendes Endereignis auftreten. Es kann z. B. ein Problem sein, wenn ein lock_acquired Ereignis auftritt, aber kein übereinstimmende lock_released Ereignis rechtzeitig folgt.

Das System stimmt nicht automatisch mit Start- und Endereignissen überein. Vielmehr müssen Sie dem System die Zuordnung mithilfe Ihrer CREATE EVENT SESSION-Anweisung erläutern. Wenn ein Start- und ein Endeereignis zugeordnet wurden, wird das Paar verworfen, damit die Konzentration ganz auf den nicht zugeordneten Startereignissen liegt.

Suchen von zuzuordnenden Feldern für das Start- und Endeereignispaar

Mithilfe der C.4 SELECT sehen wir im folgenden Rowset etwa 16 Felder für das lock_acquired Ereignis. Das hier angezeigte Rowset wurde manuell geteilt, um zu zeigen, welche Felder in unserem Beispiel zugeordnet wurden. Einige Felder wären dumm, um den Abgleich zu versuchen, z. B. auf den duration beiden Ereignissen.

Package-Name   Event-Name   Field-Name               Field-Description
------------   ----------   ----------               -----------------
sqlserver   lock_acquired   database_name            NULL
sqlserver   lock_acquired   mode                     NULL
sqlserver   lock_acquired   resource_0               The ID of the locked object, when lock_resource_type is OBJECT.
sqlserver   lock_acquired   resource_1               NULL
sqlserver   lock_acquired   resource_2               The ID of the lock partition, when lock_resource_type is OBJECT, and resource_1 is 0.
sqlserver   lock_acquired   transaction_id           NULL

sqlserver   lock_acquired   associated_object_id     The ID of the object that requested the lock that was acquired.
sqlserver   lock_acquired   database_id              NULL
sqlserver   lock_acquired   duration                 The time (in microseconds) between when the lock was requested and when it was canceled.
sqlserver   lock_acquired   lockspace_nest_id        NULL
sqlserver   lock_acquired   lockspace_sub_id         NULL
sqlserver   lock_acquired   lockspace_workspace_id   NULL
sqlserver   lock_acquired   object_id                The ID of the locked object, when lock_resource_type is OBJECT. For other lock resource types it will be 0
sqlserver   lock_acquired   owner_type               NULL
sqlserver   lock_acquired   resource_description     The description of the lock resource. The description depends on the type of lock. This is the same value as the resource_description column in the sys.dm_tran_locks view.
sqlserver   lock_acquired   resource_type            NULL

Beispiel für pair_matching

Die folgende CREATE EVENT SESSION-Anweisung gibt zwei Ereignisse und zwei Ziele an. Das pair_matching Ziel gibt zwei Gruppen von Feldern an, die mit den Ereignissen in Paaren übereinstimmen sollen. Die Abfolge von durch Trennzeichen getrennten Feldern, die zugewiesen begin_matching_columns= sind und end_matching_columns= identisch sein müssen. Zwischen den durch Trennzeichen getrennten Feldern sind keine Tabstopp- oder Zeilenvorschubzeichen zulässig, jedoch Leerzeichen.

Um die Ergebnisse einzugrenzen, haben wir zuerst ausgewählt sys.objects , um die object_id Testtabelle zu finden. Wir haben der EVENT...WHERE-Klausel einen Filter für die betreffende ID hinzugefügt.

CREATE EVENT SESSION [pair_matching_lock_a_r_33]
    ON SERVER 
    ADD EVENT sqlserver.lock_acquired
    (
        SET
            collect_database_name = (1),
            collect_resource_description = (1)

        ACTION (sqlserver.transaction_id)

        WHERE
        (
            [database_name] = 'InMemTest2'
            AND
            [object_id] = 370100359
        )
    ),
    ADD EVENT sqlserver.lock_released
    (
        SET
            collect_database_name = (1),
            collect_resource_description = (1)

        ACTION (sqlserver.transaction_id)

        WHERE
        (
            [database_name] = 'InMemTest2'
            AND
            [object_id] = 370100359
        )
    )
    ADD TARGET package0.event_counter,
    ADD TARGET package0.pair_matching
    (
        SET
            begin_event = N'sqlserver.lock_acquired',
            begin_matching_columns =
                N'resource_0, resource_1, resource_2, transaction_id, database_id',

            end_event = N'sqlserver.lock_released',
            end_matching_columns =
                N'resource_0, resource_1, resource_2, transaction_id, database_id',

            respond_to_memory_pressure = (1)
    )
    WITH
    (
        MAX_MEMORY = 8192 KB,
        MAX_DISPATCH_LATENCY = 15 SECONDS
    );

Zum Testen der Ereignissitzung haben wir absichtlich die Freigabe von erworbenen Sperren verhindert. Dies haben wir mit den folgenden T-SQL-Schritten erreicht:

  1. BEGIN TRANSACTION.
  2. UPDATE MeineTabelle....
  3. Absichtlich wird COMMIT TRANSACTION erst nach dem Untersuchen der Ziele ausgegeben.
  4. Später, nach den Tests, haben wir ein COMMIT TRANSACTION ausgegeben.

Das einfache event_counter -Ziel hat die folgenden Ausgabezeilen bereitgestellt. Da 52-50=2, bedeutet die Ausgabe, dass 2 entkoppelte lock_acquired Ereignisse angezeigt werden, wenn wir die Ausgabe aus dem Paarabgleichsziel untersuchen.

package_name   event_name      count
------------   ----------      -----
sqlserver      lock_acquired   52
sqlserver      lock_released   50

Das pair_matching -Ziel hat die folgende Ausgabe bereitgestellt. Wie von der ausgabe event_counter vorgeschlagen, sehen wir tatsächlich zwei lock_acquired Zeilen. Die Tatsache, dass wir diese zwei Zeilen überhaupt finden, bedeutet, dass diese zwei lock_acquired-Ereignisse nicht gepaart wurden.

package_name   event_name      timestamp                     database_name   duration   mode   object_id   owner_type   resource_0   resource_1   resource_2   resource_description   resource_type   transaction_id
------------   ----------      ---------                     -------------   --------   ----   ---------   ----------   ----------   ----------   ----------   --------------------   -------------   --------------
sqlserver      lock_acquired   2016-08-05 12:45:47.9980000   InMemTest2      0          S      370100359   Transaction  370100359    3            0            [INDEX_OPERATION]      OBJECT          34126
sqlserver      lock_acquired   2016-08-05 12:45:47.9980000   InMemTest2      0          IX     370100359   Transaction  370100359    0            0                                   OBJECT          34126

Die Zeilen für die entkoppelten lock_acquired-Ereignisse können den T-SQL-Text oder sqlserver.sql_textdie Sperre enthalten. Aber wir wollten das Display nicht aufblähen.

ring_buffer-Ziel

Das ring_buffer Ziel ist praktisch für schnelle und einfache Ereignistests. Beim Beenden der Ereignissitzung wird die gespeicherte Ausgabe verworfen.

In diesem ring_buffer Abschnitt wird auch gezeigt, wie Sie die Transact-SQL-Implementierung von XQuery verwenden können, um den XML-Inhalt der ring_buffer in ein besser lesbares relationales Rowset zu kopieren.

CREATE EVENT SESSION mit ring_buffer

Diese CREATE EVENT SESSION-Anweisung, die das ring_buffer-Ziel verwendet, hat nichts Bemerkenswertes.

CREATE EVENT SESSION [ring_buffer_lock_acquired_4]
    ON SERVER 
    ADD EVENT sqlserver.lock_acquired
    (
        SET collect_resource_description=(1)

        ACTION(sqlserver.database_name)

        WHERE
        (
            [object_id]=(370100359)  -- ID of MyTable
            AND
            sqlserver.database_name='InMemTest2'
        )
    )
    ADD TARGET package0.ring_buffer
    (
        SET max_events_limit=(98)
    )
    WITH
    (
        MAX_MEMORY=4096 KB,
        MAX_DISPATCH_LATENCY=3 SECONDS
    );

Für lock_acquired von ring_buffer empfangene XML-Ausgabe

Wenn er mithilfe einer SELECT-Anweisung abgerufen wird, liegt der Inhalt in Form einer XML-Zeichenfolge vor. Die folgende Abbildung zeigt die XML-Zeichenfolge, die vom ring_buffer-Ziel in unserem Test gespeichert wurde. Aus Platzgründen der folgenden XML-Anzeige wurden jedoch alle, aber zwei <event> Elemente gelöscht. Darüber hinaus wurden innerhalb der einzelnen <event>Elemente eine Handvoll überflüssiger <data> Elemente gelöscht.

<RingBufferTarget truncated="0" processingTime="0" totalEventsProcessed="6" eventCount="6" droppedCount="0" memoryUsed="1032">
  <event name="lock_acquired" package="sqlserver" timestamp="2016-08-05T23:59:53.987Z">
    <data name="mode">
      <type name="lock_mode" package="sqlserver"></type>
      <value>1</value>
      <text><![CDATA[SCH_S]]></text>
    </data>
    <data name="transaction_id">
      <type name="int64" package="package0"></type>
      <value>111030</value>
    </data>
    <data name="database_id">
      <type name="uint32" package="package0"></type>
      <value>5</value>
    </data>
    <data name="resource_0">
      <type name="uint32" package="package0"></type>
      <value>370100359</value>
    </data>
    <data name="resource_1">
      <type name="uint32" package="package0"></type>
      <value>0</value>
    </data>
    <data name="resource_2">
      <type name="uint32" package="package0"></type>
      <value>0</value>
    </data>
    <data name="database_name">
      <type name="unicode_string" package="package0"></type>
      <value><![CDATA[]]></value>
    </data>
    <action name="database_name" package="sqlserver">
      <type name="unicode_string" package="package0"></type>
      <value><![CDATA[InMemTest2]]></value>
    </action>
  </event>
  <event name="lock_acquired" package="sqlserver" timestamp="2016-08-05T23:59:56.012Z">
    <data name="mode">
      <type name="lock_mode" package="sqlserver"></type>
      <value>1</value>
      <text><![CDATA[SCH_S]]></text>
    </data>
    <data name="transaction_id">
      <type name="int64" package="package0"></type>
      <value>111039</value>
    </data>
    <data name="database_id">
      <type name="uint32" package="package0"></type>
      <value>5</value>
    </data>
    <data name="resource_0">
      <type name="uint32" package="package0"></type>
      <value>370100359</value>
    </data>
    <data name="resource_1">
      <type name="uint32" package="package0"></type>
      <value>0</value>
    </data>
    <data name="resource_2">
      <type name="uint32" package="package0"></type>
      <value>0</value>
    </data>
    <data name="database_name">
      <type name="unicode_string" package="package0"></type>
      <value><![CDATA[]]></value>
    </data>
    <action name="database_name" package="sqlserver">
      <type name="unicode_string" package="package0"></type>
      <value><![CDATA[InMemTest2]]></value>
    </action>
  </event>
</RingBufferTarget>

Um den vorstehenden XML-Code anzuzeigen, können Sie die folgende SELECT-Anweisung ausgeben, während die Ereignissitzung aktiv ist. Die aktiven XML-Daten werden aus der Systemansicht sys.dm_xe_session_targetsabgerufen.

SELECT
        CAST(LocksAcquired.TargetXml AS XML)  AS RBufXml
    INTO
        #XmlAsTable
    FROM
        (
        SELECT
                CAST(t.target_data AS XML)  AS TargetXml
            FROM
                     sys.dm_xe_session_targets  AS t
                JOIN sys.dm_xe_sessions         AS s

                    ON s.address = t.event_session_address
            WHERE
                t.target_name = 'ring_buffer'
                AND
                s.name        = 'ring_buffer_lock_acquired_4'
        )
            AS LocksAcquired;


SELECT * FROM #XmlAsTable;

XQuery zur Ausgabe des XML-Codes als Rowset

Um den vorstehenden XML-Code als relationales Rowset darzustellen, fahren Sie nach der vorstehenden SELECT-Anweisung durch Ausgeben der folgenden T-SQL-Anweisung fort. In den kommentierten Zeilen ist jede Verwendung von XQuery erläutert.

SELECT
         -- (A)
         ObjectLocks.value('(@timestamp)[1]',
            'datetime'     )  AS [OccurredDtTm]

        -- (B)
        ,ObjectLocks.value('(data[@name="mode"]/text)[1]',
            'nvarchar(32)' )  AS [Mode]

        -- (C)
        ,ObjectLocks.value('(data[@name="transaction_id"]/value)[1]',
            'bigint' )  AS [TxnId]

        -- (D)
        ,ObjectLocks.value('(action[@name="database_name" and @package="sqlserver"]/value)[1]',
            'nvarchar(128)')  AS [DatabaseName]
    FROM
        #TableXmlCell
    CROSS APPLY
        -- (E)
        TargetDateAsXml.nodes('/RingBufferTarget/event[@name="lock_acquired"]')  AS T(ObjectLocks);

XQuery-Anmerkungen zur vorstehenden SELECT-Anweisung

(A)

  • timestamp= Attributwert im <Ereigniselement> .
  • Das '(...) [1]' Konstrukt stellt nur einen Wert pro Iteration sicher, wie eine erforderliche Einschränkung der XQuery-Methode von XML-Datentypvariablen und -spalten ist.

(B)

  • <Der innere Wert des Textelements> innerhalb eines <Datenelements> , dessen Name= Attribut gleich "mode" ist.

(C)

  • <Wertelemente> inneren Werts innerhalb eines <Datenelements> , das seinen Namen= Attribut hat, das dem Wert "transaction_id" entspricht.

(D)

  • <-Ereignis> enthält <Aktion>.
  • <action> having name= attribute equal to "database_name", and package= attribute equal to "sqlserver" (not "package0"), get the inner value of <value> element.

(E)

  • C.A. bewirkt, dass die Verarbeitung für jedes einzelne <Ereigniselement> wiederholt wird, das seinen Namen= Attribut hat, das "lock_acquired" entspricht.
  • Dies gilt für den von der vorherigen FROM-Klausel zurückgegebenen XML-Code.

Ausgabe von XQuery SELECT

Als Nächstes ist das rowset, das von dem vorherigen T-SQL generiert wird, das XQuery enthält.

OccurredDtTm              Mode    DatabaseName
------------              ----    ------------
2016-08-05 23:59:53.987   SCH_S   InMemTest2
2016-08-05 23:59:56.013   SCH_S   InMemTest2

XEvent .NET-Namespaces und C#

Package0 weist zwei weitere Ziele auf, die aber in Transact-SQL nicht verwendet werden können:

  • compressed_history
  • event_stream

Eine Möglichkeit, dass diese beiden Ziele nicht in T-SQL verwendet werden können, besteht darin, dass ihre Nicht-Null-Werte in der Spalte sys.dm_xe_objects.capabilities nicht die Bit-0x1 enthalten.

Das event_stream-Ziel kann in .NET-Programmen verwendet werden, die in Sprachen wie C# erstellt wurden. C# und andere .NET-Entwickler können über eine .NET Framework-Klasse, z. B. im Namespace Microsoft.SqlServer.XEvents.Linq, auf einen Ereignisdatenstrom zugreifen.

Wenn er auftritt, bedeutet Fehler 25726 , dass der Ereignisstream sich schneller mit Daten gefüllt hat, als der Client die Daten nutzen konnte. Dies bewirkt, dass das Datenbankmodul die Verbindung mit dem Ereignisdatenstrom trennt, um die Leistung des Servers zu verlangsamen.

XEvent-Namespaces