확장 이벤트의 대상

적용 대상:SQL ServerAzure SQL DatabaseAzure SQL Managed Instance

이 문서에서는 확장 이벤트 대상을 사용하는 시기와 방법을 설명합니다. 각 대상에 대해 현재 문서에서는 다음을 설명합니다.

• 이벤트에서 보낸 데이터를 수집하고 보고하는 기능
• 매개 변수가 자체 설명이 있는 경우를 제외하고 해당 매개 변수

다음 표에서는 서로 다른 데이터베이스 엔진에서 각 대상 형식의 가용성을 설명합니다.

대상 형식	SQL Server	Azure SQL Database	Azure SQL Managed Instance
etw_classic_sync_target	예	없음	아니요
event_counter	예	네	예
event_file	예	네	예
event_stream	예	네	예
히스토그램	예	네	예
pair_matching	예	없음	아니요
ring_buffer	예	네	예

필수 조건

이 문서를 최대한 활용하려면 다음을 수행해야 합니다.

• 빠른 시작: 확장 이벤트에 설명된 대로 확장 이벤트의 기본 사항에 대해 잘 알고 있어야 합니다.

• 최신 버전의 SSMS(SQL Server Management Studio)를 설치했습니다. 자세한 내용은 SSMS(SQL Server Management Studio) 다운로드를 참조하세요.

• SSMS에서 출력 데이터를 쉽게 볼 수 있도록 개체 탐색기 사용하여 이벤트 세션 아래의 대상 노드를 마우스 오른쪽 단추로 클릭하는 방법을 알고 있습니다.

매개 변수, 작업 및 필드

CREATE EVENT SESSION 문은 확장 이벤트의 중심입니다. 문을 작성하려면 다음이 필요합니다.

• 세션에 추가하려는 이벤트
• 선택한 각 이벤트와 연결된 필드
• 세션에 추가하려는 각 대상과 연결된 매개 변수

시스템 뷰에서 이러한 목록을 반환하는 SELECT 문은 C 섹션의 다음 문서에서 복사할 수 있습니다.

• SQL Server 확장 이벤트에 대한 시스템 뷰의 SELECT 및 JOIN
  • 이벤트에 대한 C.4 SELECT 필드입니다.
  • C.6 SELECT 대상에 대한 매개 변수.
  • C.3 SELECT 작업

B2 섹션(T-SQL 큐브 뷰)에서 실제 CREATE EVENT SESSION 문의 컨텍스트에서 사용되는 매개 변수, 필드 및 작업을 볼 수 있습니다.

etw_classic_sync_target 대상

SQL Server에서 확장 이벤트는 ETW(Windows용 이벤트 추적)와 상호 운용되어 시스템 활동을 모니터링할 수 있습니다. 자세한 내용은 다음을 참조하세요.

• Windows용 이벤트 추적 대상
• 확장 이벤트를 사용하여 시스템 활동 모니터링

이 ETW 대상은 동기적으로 수신하는 데이터를 처리하는 반면, 대부분의 대상은 비동기적으로 처리합니다.

event_counter 대상

대상은 event_counter 지정된 각 이벤트가 발생하는 횟수를 계산합니다.

대부분의 다른 대상과 달리:

• 대상에 event_counter 매개 변수가 없습니다.
• 대상은 event_counter 동기적으로 수신하는 데이터를 처리합니다.

event_counter 대상에서 캡처한 출력 예제

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

다음은 이전 결과를 반환한 문입니다 CREATE EVENT SESSION . 이 예제에서는 package0.counter 개수가 4에 WHERE 도달한 후 계산을 중지하기 위해 절 조건자에서 필드를 사용했습니다.

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 대상

대상은 event_file 버퍼에서 디스크 파일 또는 Azure Storage의 Blob에 이벤트 세션 출력을 씁니다.

• 절에 filename 매개 변수를 지정합니다 ADD TARGET . 파일 확장명은 .이어야 xel합니다.
• 선택한 파일 이름은 시스템에서 날짜-시간 기반 긴 정수가 추가된 xel 후 확장명을 추가하는 접두사로 사용됩니다.

event_file 대상을 사용하여 이벤트 세션 만들기

다음은 대상을 추가하는 절의 CREATE EVENT SESSIONADD TARGET 예입니다 event_file .

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:\temp\locks_acq_rel_eventfile_22-.xel'
    )
    WITH
    (
        MAX_MEMORY=4096 KB,
        MAX_DISPATCH_LATENCY=10 SECONDS
    );

sys.fn_xe_file_target_read_file() 함수

대상은 event_file 수신한 데이터를 사람이 읽을 수 없는 이진 형식으로 저장합니다. sys.fn_xe_file_target_read_file 함수를 사용하면 파일의 xel 내용을 관계형 행 집합으로 나타낼 수 있습니다.

SQL Server 2016 이상 버전의 경우 다음 예제와 SELECT 유사한 문을 사용합니다.

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

SQL Server 2014의 경우 다음 예제와 SELECT 유사한 문을 사용합니다. SQL Server 2014 이후 xem 파일은 더 이상 사용되지 않습니다.

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

이 두 예제 * 에서 wild카드는 지정된 접두사로 시작하는 모든 xel 파일을 읽는 데 사용됩니다.

Azure SQL Database에서 Blob을 사용하여 컨테이너 xel 에 sys.fn_xe_file_target_read_file() 대한 권한 및 List SAS 토큰 Read 을 포함하는 데이터베이스 범위 자격 증명을 만든 후 함수를 호출할 수 있습니다.

/*
Create a master key to protect the secret of the credential
*/
IF NOT EXISTS (
    SELECT 1
    FROM sys.symmetric_keys
    WHERE name = '##MS_DatabaseMasterKey##'
)
CREATE MASTER KEY;

/*
(Re-)create a database scoped credential.
The name of the credential must match the URI of the blob container.
*/
IF EXISTS (
    SELECT *
    FROM sys.database_credentials
    WHERE name = 'https://exampleaccount4xe.blob.core.windows.net/extended-events-container'
)
DROP DATABASE SCOPED CREDENTIAL [https://exampleaccount4xe.blob.core.windows.net/extended-events-container];

/*
The secret is the SAS token for the container. The Read and List permissions are set.
*/
CREATE DATABASE SCOPED CREDENTIAL [https://exampleaccount4xe.blob.core.windows.net/extended-events-container]
    WITH IDENTITY = 'SHARED ACCESS SIGNATURE',
        SECRET = 'sp=rl&st=2023-10-09T22:12:54Z&se=2023-10-10T06:12:54Z&spr=https&sv=2022-11-02&sr=c&sig=REDACTED';

/*
Return event session data
*/
SELECT f.*
--,CAST(f.event_data AS XML)  AS [Event-Data-Cast-To-XML]  -- Optional
FROM sys.fn_xe_file_target_read_file('https://exampleaccount4xe.blob.core.windows.net/extended-events-container/event-session-1', DEFAULT, DEFAULT, DEFAULT) AS f;

Azure SQL Managed Instance에서 Blob을 사용하여 컨테이너 xel 에 sys.fn_xe_file_target_read_file() 대한 권한 및 List SAS 토큰 Read 을 포함하는 서버 자격 증명을 만든 후 함수를 호출할 수 있습니다.

IF NOT EXISTS (
    SELECT 1
    FROM sys.symmetric_keys
    WHERE name = '##MS_DatabaseMasterKey##'
)
CREATE MASTER KEY ENCRYPTION BY PASSWORD = 'REDACTED';

/*
(Re-)create a database scoped credential.
The name of the credential must match the URI of the blob container.
*/
IF EXISTS (
    SELECT *
    FROM sys.credentials
    WHERE name = 'https://exampleaccount4xe.blob.core.windows.net/extended-events-container'
)
DROP CREDENTIAL [https://exampleaccount4xe.blob.core.windows.net/extended-events-container];

/*
The secret is the SAS token for the container. The Read and List permissions are set.
*/
CREATE CREDENTIAL [https://exampleaccount4xe.blob.core.windows.net/extended-events-container]
    WITH IDENTITY = 'SHARED ACCESS SIGNATURE',
        SECRET = 'sp=rl&st=2023-10-09T22:12:54Z&se=2023-10-10T06:12:54Z&spr=https&sv=2022-11-02&sr=c&sig=REDACTED';

/*
Return event session data
*/
SELECT f.*
--,CAST(f.event_data AS XML)  AS [Event-Data-Cast-To-XML]  -- Optional
FROM sys.fn_xe_file_target_read_file('https://exampleaccount4xe.blob.core.windows.net/extended-events-container/event-session-1', DEFAULT, DEFAULT, DEFAULT) AS f;

event_file 대상에 저장된 데이터

SQL Server 2016(13.x) 이상 버전에서 sys.fn_xe_file_target_read_file 반환된 데이터의 예입니다.

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:\temp\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:\temp\locks_acq_rel_eventfile_22-_0_131150744126230000.xel   11776

히스토그램 대상

대상은 다음을 histogram 수행할 수 있습니다.

• 여러 항목의 발생 횟수를 개별적으로 계산합니다.
• 다양한 유형의 항목의 발생 횟수를 계산합니다.
  • 이벤트 필드
  • actions

대상은 histogram 동기적으로 수신하는 데이터를 처리합니다.

매개 source_type 변수는 히스토그램 대상을 제어하는 키입니다.

• source_type=0: 이벤트 필드에 대한 데이터를 수집합니다.
• source_type=1: 작업에 대한 데이터를 수집합니다. 기본값입니다.

매개 변수 기본값은 slots 256입니다. 다른 값을 할당하면 값이 2의 다음 값으로 반올림됩니다. 예를 들어 slots=59는 64로 반올림됩니다. 대상에 대한 histogram 히스토그램 슬롯의 최대 수는 16384입니다.

대상으로 사용할 histogram 때 예기치 않은 결과가 나타날 수 있습니다. 일부 이벤트는 예상 슬롯에 표시되지 않을 수 있지만 다른 슬롯은 예상보다 높은 이벤트 수를 표시할 수 있습니다.

이 문제는 슬롯에 이벤트를 할당할 때 해시 충돌이 발생하는 경우에 발생할 수 있습니다. 이 경우는 드물지만 해시 충돌이 발생하는 경우 한 슬롯에서 계산해야 하는 이벤트는 다른 슬롯에서 계산됩니다. 이러한 이유로 특정 슬롯의 개수가 0으로 표시되기 때문에 이벤트가 발생하지 않았다고 가정하면 주의해야 합니다.

예를 들어 다음 시나리오를 고려해 보세요.

• 확장 이벤트 세션을 설정하여 대상으로 사용하고 histogram 그룹화하여 object_id저장 프로시저 실행을 수집합니다.
• 저장 프로시저 A를 실행합니다. 그런 다음 저장 프로시저 B를 실행합니다.

해시 함수가 두 저장 프로시저의 동일한 값을 object_id 반환하면 히스토그램에 저장 프로시저 A가 두 번 실행되고 저장 프로시저 B가 표시되지 않습니다.

고유 값 수가 상대적으로 작은 경우 이 문제를 완화하려면 히스토그램 슬롯 수를 예상된 고유 값의 제곱보다 높게 설정합니다. 예를 들어 대상 source 에 histogram 이벤트 필드로 table_name 설정된 테이블이 있고 데이터베이스에 20개의 테이블이 있는 경우 20*20 = 400입니다. 다음으로 400보다 큰 2의 전원은 512이며, 이 예제에서는 권장되는 슬롯 수입니다.

동작이 있는 히스토그램 대상

해당 ADD TARGET ... (SET ...) 절에서 다음 CREATE EVENT SESSION 문은 대상 매개 변수 할당 source_type=1을 지정합니다. 즉, 히스토그램 대상이 작업을 추적합니다.

현재 예제에서 절은 ADD EVENT ... (ACTION ...) 선택할 작업( 즉 sqlos.system_thread_id, 하나만 제공)을 제공합니다. 절에 ADD TARGET ... (SET ...) 할당 source=N'sqlos.system_thread_id'이 표시됩니다.

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

다음 데이터가 캡처되었습니다. 열의 값은 value 값입니다 system_thread_id . 예를 들어 총 236 잠금 수는 스레드 6540에서 가져왔습니다.

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

SELECT를 사용하여 사용 가능한 작업 검색

C.3SELECT 문은 시스템에서 문에서 CREATE EVENT SESSION 지정할 수 있는 작업을 찾을 수 있습니다. WHERE 절에서 먼저 관심 있는 작업과 일치하도록 필터를 편집 o.name LIKE 합니다.

다음은 C.3 SELECT에서 반환하는 샘플 행 집합입니다. 작업은 system_thread_id 두 번째 행에 표시됩니다.

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

이벤트 필드가 있는 히스토그램 대상

다음 예제에서는 .를 설정합니다 source_type=0. 할당된 source 값은 이벤트 필드입니다.

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

다음 데이터는 대상에 의해 histogram 캡처되었습니다. 데이터는 ID가 5인 데이터베이스에 7개의 checkpoint_begin 이벤트가 발생했음을 보여 줍니다.

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

SELECT를 선택하여 선택한 이벤트에서 사용 가능한 필드를 검색합니다.

C.4SELECT 문에는 선택할 수 있는 이벤트 필드가 표시됩니다. 먼저 필터를 o.name LIKE 선택한 이벤트 이름으로 편집합니다.

다음 행 집합은 C.4 SELECT에서 반환되었습니다. 행 집합은 대상에 대한 checkpoint_begin 값을 제공할 수 있는 이벤트의 유일한 필드임을 보여 database_id 줍니다histogram.

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

pair_matching 대상

pair_matching 대상을 사용하면 해당 종료 이벤트 없이 발생하는 시작 이벤트를 검색할 수 있습니다. 예를 들어 이벤트가 발생할 때 lock_acquired 문제가 될 수 있지만 일치하는 lock_released 이벤트는 적시에 따르지 않습니다.

시스템은 시작 및 종료 이벤트와 자동으로 일치하지 않습니다. 대신 문에서 시스템에 대한 일치를 설명합니다 CREATE EVENT SESSION . 시작 및 종료 이벤트가 일치하면 쌍은 일치하지 않는 시작 이벤트에 집중하도록 카드.

시작 및 종료 이벤트 쌍에 대한 일치 가능한 필드 찾기

C.4 SELECT를 사용하면 다음 행 집합에 이벤트에 대한 약 16개의 필드가 lock_acquired 표시됩니다. 여기에 표시된 행 집합이 수동으로 분할되어 예제가 일치하는 필드를 표시합니다. 같은 duration일부 필드의 경우 일치를 시도하는 것은 의미가 없습니다.

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

pair_matching 대상의 예

다음 CREATE EVENT SESSION 문은 두 개의 이벤트와 두 개의 대상을 지정합니다. 대상은 pair_matching 이벤트를 쌍으로 일치시킬 두 개의 필드 집합을 지정합니다. 할당된 begin_matching_columnsend_matching_columns 쉼표로 구분된 필드의 시퀀스는 동일해야 합니다. 공백은 허용되지만 쉼표로 구분된 값에 멘션 필드 간에 탭이나 줄 바꿈이 허용되지 않습니다.

결과의 범위를 좁히기 위해 먼저 테스트 테이블의 찾기에서 sys.objectsobject_id 선택했습니다. 절에 해당 개체 ID 하나에 대한 필터를 추가했습니다 ADD EVENT ... (WHERE ...) .

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

이벤트 세션을 테스트하기 위해 두 개의 획득된 잠금이 해제되지 않도록 의도적으로 방지했습니다. 다음 T-SQL 단계를 사용하여 이 작업을 수행했습니다.

1. BEGIN TRANSACTION.
2. UPDATE MyTable....
3. 대상을 검사할 COMMIT TRANSACTION때까지 의도적으로 발급하지 않습니다.
4. 나중에 테스트 후 .COMMIT TRANSACTION

간단한 event_counter 대상은 다음과 같은 출력 행을 제공했습니다. 52-50=2이기 때문에 출력은 쌍 일치 대상의 출력을 검사할 때 2개의 짝이 없는 lock_acquired 이벤트를 표시합니다.

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

대상은 pair_matching 다음 출력을 제공했습니다. 출력에서 event_counter 제안한 대로 실제로 두 lock_acquired 행이 표시됩니다. 이러한 행을 전혀 볼 수 있다는 사실은 이 두 lock_acquired 이벤트가 무보수임을 의미합니다.

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

없으면 lock_acquired 이벤트에 대한 행에는 작업에서 제공하는 T-SQL 텍스트가 sqlserver.sql_text 포함될 수 있습니다. 잠금을 획득한 쿼리를 캡처합니다.

ring_buffer 대상

대상은 ring_buffer 메모리의 빠르고 간단한 이벤트 컬렉션에만 편리합니다. 이벤트 세션을 중지하면 저장된 출력이 해제됩니다카드.

이 섹션에서는 XQuery를 사용하여 링 버퍼 내용의 XML 표현을 보다 읽기 쉬운 관계형 행 집합으로 변환하는 방법도 보여 줍니다.

다음 예제와 같이 대상의 ring_buffer 데이터를 XML로 변환하여 사용합니다. 이 변환 중에 4MB XML 문서에 맞지 않는 데이터는 생략됩니다. 따라서 더 큰 MAX_MEMORY 값을 사용하거나 이 매개 변수를 기본값으로 두어 링 버퍼에서 더 많은 이벤트를 캡처하더라도 XML 태그 및 유니코드 문자열의 오버헤드를 고려할 때 XML 문서 크기의 4MB 제한으로 인해 이벤트를 모두 사용하지 못할 수 있습니다.

예를 들어 XML 문서의 특성이 설정된 1경우 truncated XML로 변환하는 동안 링 버퍼의 내용이 생략됩니다.

<RingBufferTarget truncated="1" processingTime="0" totalEventsProcessed="284" eventCount="284" droppedCount="0" memoryUsed="64139">

ring_buffer 대상을 사용하여 이벤트 세션 만들기

다음은 대상을 사용하여 이벤트 세션을 만드는 예제입니다 ring_buffer . 이 예제에서는 매개 변수가 MAX_MEMORY 두 번 나타납니다. 한 번은 대상 메모리를 1024KB로 설정하고 ring_buffer 한 번은 이벤트 세션 버퍼 메모리를 2MB로 설정합니다.

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,
            MAX_MEMORY = 1024
    )
    WITH
    (
        MAX_MEMORY = 2 MB,
        MAX_DISPATCH_LATENCY = 3 SECONDS
    );

ring_buffer 대상에서 lock_acquired 대해 받은 XML 출력

문으로 SELECT 검색하면 링 버퍼의 내용이 XML 문서로 표시됩니다. 다음 예제가 표시됩니다. 그러나 간단히 하기 위해 두 <event> 요소를 제외한 모든 요소가 제거되었습니다. 또한 각 <event>요소 내에서 소수의 <data> 요소도 제거되었습니다.

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

이전 XML을 보려면 이벤트 세션이 활성 상태인 동안 다음 SELECT 을 실행할 수 있습니다. XML 데이터는 시스템 보기 sys.dm_xe_session_targets에서 검색됩니다.

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
    INNER 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;

행 집합으로 XML을 보려면 XQuery

이전 XML을 관계형 행 집합으로 보려면 다음 T-SQL을 실행하여 이전 SELECT 문에서 계속 진행합니다. 주석이 추가된 줄은 XQuery의 각 사용을 설명합니다.

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 #XmlAsTable
CROSS APPLY
    -- (E)
    TargetDateAsXml.nodes('/RingBufferTarget/event[@name="lock_acquired"]') AS T(ObjectLocks);

이전 SELECT의 XQuery 메모

(A)

• timestamp= 요소의 특성 값 <event> 입니다.
• 이 구문은 '(...)[1]' XML 데이터 형식 변수 및 열의 .value() XQuery 메서드에 필요한 제한 사항과 마찬가지로 반복당 하나의 값만 반환되도록 합니다.

(B)

• <text>요소의 내부 값으로<data>, 요소 내에서 해당 이름= 특성이 같음 mode

(C)

• <value>요소 내의 요소 내부 값으로<data>, 해당 이름= 특성이 .같음 transaction_id

(D)

• <event>에는 <action>가 포함됩니다.
• <action> having name= attribute equal to database_name, and package= attribute equal to sqlserver (not package0), get the inner value of <value> element.

(E)

• CROSS APPLY 는 특성이 같은 모든 개별 <event> 요소 name 에 대해 처리가 반복되도록 lock_acquired합니다.
• 이는 이전 FROM 절에서 반환된 XML에 적용됩니다.

XQuery SELECT의 출력

다음은 XQuery를 포함하는 이전 T-SQL에서 생성된 행 집합입니다.

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

event_stream 대상

대상은 event_stream C#와 같은 언어로 작성된 .NET 프로그램에서만 사용할 수 있습니다. C# 및 기타 .NET 개발자는 네임스페이스의 .NET Framework 클래스를 통해 이벤트 스트림에 Microsoft.SqlServer.XEvents.Linq 액세스할 수 있습니다. 이 대상은 T-SQL에서 사용할 수 없습니다.

오류 25726 The event data stream was disconnected because there were too many outstanding events. To avoid this error either remove events or actions from your session or add a more restrictive predicate filter to your session. 이 발생하면 대상에서 event_stream 읽을 때 클라이언트가 데이터를 사용할 수 있는 것보다 더 빠르게 데이터로 채워진 이벤트 스트림을 의미합니다. 이로 인해 데이터베이스 엔진 데이터베이스 엔진 성능에 영향을 주지 않도록 이벤트 스트림에서 연결을 끊습니다.

XEvent 네임스페이스

• Microsoft.SqlServer.Management.XEvent 네임스페이스
• Microsoft.SqlServer.XEvent.Linq 네임스페이스