sys.dm_xe_sessions (Transact-SQL)

適用対象: SQL Server Azure SQL Managed Instance

サーバー スコープのアクティブな拡張イベント セッションに関する情報を返します。 セッションは、イベント、アクション、およびターゲットのコレクションです。

Azure SQL Database では、データベース スコープのセッションのみがサポートされています。 「 sys.dm_xe_database_sessions」を参照してください。

列名 データ型 説明
address varbinary(8) セッションのメモリ アドレス。 address はローカル システム全体で一意です。 NULL 値は許可されません。
name nvarchar (256) セッションの名前。 name はローカル システム全体で一意です。 NULL 値は許可されません。
pending_buffers int 処理中のバッファー全体の数。 NULL 値は許可されません。
total_regular_buffers int セッションに関連付けられている通常のバッファーの合計数。 NULL 値は許可されません。

注: 通常のバッファーは、ほとんどの場合使用されます。 これらのバッファーは、多くのイベントを保持するのに十分なサイズです。 通常、セッションごとに 3 つ以上のバッファーがあります。 標準バッファーの数は、MEMORY_PARTITION_MODE オプションによって設定されるメモリのパーティション分割に基づいて、サーバーで自動的に決定されます。 標準バッファーのサイズは、MAX_MEMORY オプションの値 (既定では 4 MB) をバッファーの数で割った値になります。 MEMORY_PARTITION_MODEとMAX_MEMORYオプションの詳細については、「 CREATE EVENT SESSION (Transact-SQL)」を参照してください。
regular_buffer_size bigint 通常のバッファー サイズ (バイト単位)。 NULL 値は許可されません。
total_large_buffers int 大きなバッファーの合計数。 NULL 値は許可されません。

注: イベントが通常のバッファーより大きい場合は、大きなバッファーが使用されます。 この目的のために明示的に確保されています。 ラージ バッファーは、イベント セッションが開始されるときに割り当てられ、サイズは MAX_EVENT_SIZE オプションによって決まります。 MAX_EVENT_SIZE オプションの詳細については、「 CREATE EVENT SESSION (Transact-SQL)」を参照してください。
large_buffer_size bigint ラージ バッファーのサイズ (バイト単位)。 NULL 値は許可されません。
total_buffer_size bigint セッションのイベントを格納するためのメモリ バッファーの合計サイズ (バイト単位)。 NULL 値は許可されません。
buffer_policy_flags int すべてのバッファーがいっぱいで、新しいイベントが発生した場合のセッション イベント バッファーの動作を示すビットマップ。 NULL 値は許可されません。
buffer_policy_desc nvarchar (256) すべてのバッファーがいっぱいになっているときに新しいイベントが発生した場合のセッション イベント バッファーの動作を示す説明。 NULL 値は許可されません。 buffer_policy_desc には、次のいずれかの値を指定できます。

- Drop イベント
- イベントを削除しない
- 完全なバッファーを削除する
- 新しいバッファーを割り当てる
flags int セッションに設定されているフラグを示すビットマップ。 NULL 値は許可されません。
flag_desc nvarchar (256) セッションに設定されているフラグの説明。 NULL 値は許可されません。 flag_desc には、次の値の任意の組み合わせを指定できます。

- クローズ時にバッファーをフラッシュする
- 専用ディスパッチャー
- 再帰イベントを許可する
dropped_event_count int バッファーがいっぱいになったときに破棄されたイベントの数。 この値は、buffer_policy_descが "Drop full buffer" または "Don't drop events" の場合に0されます。 NULL 値は許可されません。
dropped_buffer_count int バッファーがいっぱいのときに削除されたバッファーの数。 この値は、buffer_policy_descが "Drop event" または "Don't drop events" に設定されている場合に0されます。 NULL 値は許可されません。 バッファーがセッション レベルで削除されない場合でも、個々のターゲットがターゲット固有の理由でバッファーの処理に失敗する可能性があります。
blocked_event_fire_time int バッファーがいっぱいになったときにイベントの発生がブロックされた時間の長さ。 この値は、buffer_policy_descが "Drop full buffer" または "Drop event" の場合に0されます。 NULL 値は許可されません。
create_time datetime セッションが作成された (開始された) 時刻。 NULL 値は許可されません。
largest_event_dropped_size int セッション バッファーに収まらない最大イベントのサイズ。 NULL 値は許可されません。
session_source nvarchar (256) セッションのスコープ。 NULL 値は許可されません。 session_source には、次のいずれかの値を指定できます。

- server = ユーザー セッションを含む、サーバーにスコープが設定されたセッション。
- internal = 特定の内部セッション ( sp_server_diagnostics セッションなど)。
buffer_processed_count bigint 適用対象: SQL Server 2017 (14.x) 以降のバージョン。

セッションによって処理され、セッションの開始時から累積されるバッファーの合計数。 NULL 値は許可されません。
buffer_full_count bigint 適用対象: SQL Server 2017 (14.x) 以降のバージョン。

処理されたバッファーがいっぱいになり、セッションの開始時から蓄積されたバッファーの数。 NULL 値は許可されません。
total_bytes_generated bigint 適用対象: SQL Server 2017 (14.x) 以降のバージョン。

拡張イベント セッションによって生成された実際のバイト数。 この情報は、セッションがバッファーを処理しているときに収集され、ファイル ターゲットにのみ適用されます。 他のターゲットの追跡はありません。
total_target_memory bigint 適用対象: SQL Server 2019 (15.x) 以降のバージョン。

リング バッファー ターゲットに情報を格納するセッションのターゲット メモリの合計 (バイト単位)。 NULL 値は許可されません。

アクセス許可

SQL Server 2019 (15.x) 以前のバージョンでは、サーバーに対する VIEW SERVER STATE 権限が必要です。

SQL Server 2022 (16.x) 以降のバージョンでは、サーバーに対する VIEW SERVER PERFORMANCE STATE 権限が必要です。

次のステップ

関連する概念の詳細については、次の記事を参照してください。