イベント ペアリング ターゲット

イベント ペアリング ターゲットは、各イベントに存在する単一列または複数列のデータを使って 2 つのイベントを照合します。 ロックの取得とロックの解放など、対で発生するイベントが数多く存在します。 イベント シーケンスが対で発生した後は、両方のイベントが破棄されます。 一対のイベントを破棄することによって、取得されたまま解放されていないロックを容易に検出できます。

イベント レベルのフィルターを使用すると、設定済みの条件に合致しないイベントだけを、ペアリング ターゲットを使ってキャプチャできます。

イベント ペアリング ターゲットを使用する場合は、照合に使用する列のシーケンスのほか、照合する 2 つのイベントを選択できます。 このシーケンス内のすべての列は、同じ型であることが必要です。

次の表では、イベント ペアリングの構成に使用できるオプションについて説明します。

イベントに関連付けられているすべてのデータはキャプチャされて、その後のペアリングに備えて保存されます。 また、アクションによって追加されたデータも収集されます。 収集されたイベント データはメモリに格納されるため、格納できるサイズには上限があります。 この制限は、システムの容量とアクティビティに依存します。 使用メモリ量は利用可能なシステム リソースに基づくため、使用可能な最大メモリ量をパラメーターとして指定することはありません。 システム リソースが不足した場合、それまで保持されていた、対になっていないイベントは破棄されます。 イベントが対になっておらず破棄された場合、照合イベントは、対になっていないイベントとして発生します。

対になっていないイベントは、ペアリング ターゲットによって XML 形式にシリアル化されます。 この形式は、いずれのスキーマにも準拠しません。 この形式に含まれる要素は 2 種類だけです。 ルートは <unpaired> 要素で、その後に、 対になっていないイベント (現在追跡中のイベント) ごとに 1 つの <event> 要素が存在します。 <event> 要素には、対になっていないイベントの名前を保持する属性が 1 つ存在します。

セッションへのターゲットの追加

ペア照合ターゲットを拡張イベント セッションに追加するには、イベント セッションの作成時または変更時に次のステートメントを含める必要があります。

ADD TARGET package0.pair_matching 

この後に、最初と最後のイベント、および照合するアクションまたは列を定義する SET ステートメントを続けます。 次の例には、sqlserver.lock_acquired イベントと sqlserver.lock_released イベントのペアの照合を行うサンプル構文を示しています。

   ( SET begin_event = 'sqlserver.lock_acquired',
      begin_matching_columns = 'database_id, resource_0, resource_1, resource_2, transaction_id, mode',
      end_event = 'sqlserver.lock_released',
      end_matching_columns = 'database_id, resource_0, resource_1, resource_2, transaction_id, mode',
   respond_to_memory_pressure = 1)

詳細については、「ロックを保持しているクエリの特定」を参照してください。

ターゲット出力の確認

ペア照合ターゲットの出力を確認するには、次のクエリを使用します。session_name をイベント セッションの名前に置き換えてください。

SELECT name, target_name, CAST(xet.target_data AS xml)
FROM sys.dm_xe_session_targets AS xet
JOIN sys.dm_xe_sessions AS xe
   ON (xe.address = xet.event_session_address)
WHERE xe.name = 'session_name'

次の例は、ペアリング ターゲットの出力形式を示しています。

<unpaired truncated = "0" matchedCount = "[matched count]" memoryPressureDroppedCount = " [lost count]">
    <event name  = "[event name]" package = "[package]" id= "[event ID value]" version = "[event version]">
    <data name = "[column name]"> 
    <type name = "[column type]" package = "[type package]" /> 
    <value>[column value]</value>
    <text value>[text value]</text>>
        </data>
    </event>
</unpaired>

関連項目

参照

sys.dm_xe_session_targets (Transact-SQL)

CREATE EVENT SESSION (Transact-SQL)

ALTER EVENT SESSION (Transact-SQL)

概念

SQL Server 拡張イベント ターゲット