SQL Server 拡張イベントの使用

SQL Server 拡張イベントには、拡張イベントセッションを作成したり変更したりするためのデータ定義言語 (DDL) ステートメントが用意されています。また、セッションデータやメタデータを取得する際に使用できる動的管理ビューおよびカタログビューも存在します。

Transact-SQL ステートメントを使ってビューを実行することにより、作成したあらゆる拡張イベントセッションから必要な情報を取得できます。

SQL Server Management Studio を使用すると、付属のコードサンプルを作成して実行することができます。詳細については、「オブジェクトエクスプローラの使用」を参照してください。

DDL ステートメント

拡張イベントセッションを作成、変更、および削除するには、次の表の DDL ステートメントを使用します。

名前	説明
CREATE EVENT SESSION (Transact-SQL)	イベントのソース、イベントセッションターゲット、およびイベントセッションパラメータを識別する拡張イベントセッションオブジェクトを作成します。
ALTER EVENT SESSION (Transact-SQL)	イベントセッションを開始または停止したり、イベントセッションの構成を変更したりします。
DROP EVENT SESSION (Transact-SQL)	イベントセッションを削除します。

イベントセッションの作成時に作成されたメタデータを取得するには、次の表に示すカタログビューを使用します。

名前	説明
sys.server_event_sessions (Transact-SQL)	すべてのイベントセッションの定義を一覧表示します。
sys.server_event_session_actions (Transact-SQL)	イベントセッションの各イベントのアクションごとに 1 行のデータを返します。
sys.server_event_session_events (Transact-SQL)	イベントセッションのイベントごとに 1 行のデータを返します。
sys.server_event_session_fields (Transact-SQL)	イベントおよびターゲットに明示的に設定されたカスタマイズ可能な列ごとに 1 行のデータを返します。
sys.server_event_session_targets (Transact-SQL)	イベントセッションのイベントターゲットごとに 1 行のデータを返します。

セッションメタデータおよびセッションデータを取得するには、次の表に示す動的管理ビューを使用します。メタデータはカタログビューから取得され、セッションデータはイベントセッションの開始時と実行時に作成されます。

注意
これらのビューには、セッションが開始されるまでセッションデータは格納されません。

名前	説明
sys.dm_os_dispatcher_pools (Transact-SQL)	セッションディスパッチャプールに関する情報を返します。
sys.dm_xe_objects (Transact-SQL)	イベントパッケージによって公開されるオブジェクトごとに 1 行のデータを返します。
sys.dm_xe_object_columns (Transact-SQL)	すべてのオブジェクトのスキーマ情報を返します。
sys.dm_xe_packages (Transact-SQL)	拡張イベントエンジンに登録されているすべてのパッケージを一覧表示します。
sys.dm_xe_sessions (Transact-SQL)	アクティブな拡張イベントセッションに関する情報を返します。
sys.dm_xe_session_targets (Transact-SQL)	セッションターゲットに関する情報を返します。
sys.dm_xe_session_events (Transact-SQL)	セッションイベントに関する情報を返します。
sys.dm_xe_session_event_actions (Transact-SQL)	イベントセッションアクションに関する情報を返します。
sys.dm_xe_map_values (Transact-SQL)	内部数値キーをユーザーが判読できるテキストにマッピングします。
sys.dm_xe_session_object_columns (Transact-SQL)	セッションにバインドされたオブジェクトの構成値を表示します。