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 権限が必要です。
次のステップ
関連する概念の詳細については、次の記事を参照してください。