sys.dm_xe_sessions (Transact-SQL)sys.dm_xe_sessions (Transact-SQL)

適用対象:○SQL Server (2008 以降)×Azure SQL Database×Azure SQL Data Warehouse ×Parallel Data Warehouse THIS TOPIC APPLIES TO:yesSQL Server (starting with 2008)noAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse

アクティブな拡張イベント セッションに関する情報を返します。Returns information about an active extended events session. このセッションは、イベント、アクション、およびターゲットのコレクションです。This session is a collection of events, actions, and targets.

列名Column name データ型Data type DescriptionDescription
addressaddress varbinary(8)varbinary(8) セッションのメモリ アドレス。The memory address of the session. アドレスは、ローカル システム全体で一意です。address is unique across the local system. NULL 値は許可されません。Is not nullable.
namename nvarchar (256)nvarchar(256) セッションの名前。The name of the session. 名前は、ローカル システム全体で一意です。name is unique across the local system. NULL 値は許可されません。Is not nullable.
pending_bufferspending_buffers intint いっぱいになって処理が保留されているバッファーの数。The number of full buffers that are pending processing. NULL 値は許可されません。Is not nullable.
total_regular_bufferstotal_regular_buffers intint セッションに関連付けられている標準バッファーの総数。The total number of regular buffers that are associated with the session. NULL 値は許可されません。Is not nullable.

注: 標準バッファーはほとんどの場合に使用されます。Note: Regular buffers are used most of the time. 標準バッファーには、多数のイベントを保持できるだけの十分なサイズがあります。These buffers are of sufficient size to hold many events. 通常は、各セッションに 3 つ以上のバッファーがあります。Typically, there will be three or more buffers per session. 標準バッファーの数は、MEMORY_PARTITION_MODE オプションによって設定されるメモリのパーティション分割に基づいて、サーバーで自動的に決定されます。The number of regular buffers is automatically determined by the server, based on the memory partitioning that is set through the MEMORY_PARTITION_MODE option. 標準バッファーのサイズは、MAX_MEMORY オプションの値 (既定では 4 MB) をバッファーの数で割った値になります。The size of the regular buffers is equal to the value of the MAX_MEMORY option (default of 4 MB), divided by the number of buffers. MEMORY_PARTITION_MODE オプションと MAX_MEMORY オプションの詳細については、次を参照してください。 CREATE EVENT SESSION (TRANSACT-SQL)です。For more information about the MEMORY_PARTITION_MODE and the MAX_MEMORY options, see CREATE EVENT SESSION (Transact-SQL).
regular_buffer_sizeregular_buffer_size bigintbigint 標準バッファーのサイズ (バイト単位)。The regular buffer size, in bytes. NULL 値は許可されません。Is not nullable.
total_large_bufferstotal_large_buffers intint ラージ バッファーの総数。The total number of large buffers. NULL 値は許可されません。Is not nullable.

注: ラージ バッファーは、イベントが標準バッファーより大きい場合に使用されます。Note: Large buffers are used when an event is larger than a regular buffer. この目的のために明示的に確保されています。They are set aside explicitly for this purpose. ラージ バッファーは、イベント セッションが開始されるときに割り当てられ、サイズは MAX_EVENT_SIZE オプションによって決まります。Large buffers are allocated when the event session starts, and are sized according to the MAX_EVENT_SIZE option. MAX_EVENT_SIZE オプションの詳細については、次を参照してください。 CREATE EVENT SESSION (TRANSACT-SQL)です。For more information about the MAX_EVENT_SIZE option, see CREATE EVENT SESSION (Transact-SQL).
large_buffer_sizelarge_buffer_size bigintbigint ラージ バッファーのサイズ (バイト単位)。The large buffer size, in bytes. NULL 値は許可されません。Is not nullable.
total_buffer_sizetotal_buffer_size bigintbigint セッションのイベントを格納するためのメモリ バッファーの合計サイズ (バイト単位)。The total size of the memory buffer that is used to store events for the session, in bytes. NULL 値は許可されません。Is not nullable.
buffer_policy_flagsbuffer_policy_flags intint すべてのバッファーがいっぱいになっているときに新しいイベントが発生した場合のセッション イベント バッファーの動作を示すビットマップ。A bitmap that indicates how session event buffers behave when all the buffers are full and a new event is fired. NULL 値は許可されません。Is not nullable.
buffer_policy_descbuffer_policy_desc nvarchar (256)nvarchar(256) すべてのバッファーがいっぱいになっているときに新しいイベントが発生した場合のセッション イベント バッファーの動作を示す説明。A description that indicates how session event buffers behave when all the buffers are full and a new event is fired. NULL 値は許可されません。Is not nullable. buffer_policy_desc は、次のいずれかになります。buffer_policy_desc can be one of the following:

Drop eventDrop event

Do not drop eventsDo not drop events

Drop full bufferDrop full buffer

Allocate new bufferAllocate new buffer
flagsflags intint セッションに設定されているフラグを示すビットマップ。A bitmap that indicates the flags that have been set on the session. NULL 値は許可されません。Is not nullable.
flag_descflag_desc nvarchar (256)nvarchar(256) セッションに設定されているフラグの説明。A description of the flags set on the session. NULL 値は許可されません。Is not nullable. flag_desc は、次の任意の組み合わせを指定できます。flag_desc can be any combination of the following:

Flush buffers on closeFlush buffers on close

Dedicated dispatcherDedicated dispatcher

Allow recursive eventsAllow recursive events
dropped_event_countdropped_event_count intint バッファーがいっぱいのときに削除されたイベントの数。The number of events that were dropped when the buffers were full. この値は0かどうか、バッファー ポリシーが Drop full buffer"または"Do not drop events"です。This value is 0 if the buffer policy is "Drop full buffer" or "Do not drop events". NULL 値は許可されません。Is not nullable.
dropped_buffer_countdropped_buffer_count intint バッファーがいっぱいのときに削除されたバッファーの数。The number of buffers that were dropped when the buffers were full. この値は0バッファー ポリシーが Drop event"または"Do not drop events"に設定されているかどうか。This value is 0 if the buffer policy is set to "Drop event" or "Do not drop events". NULL 値は許可されません。Is not nullable.
blocked_event_fire_timeblocked_event_fire_time intint バッファーがいっぱいのときにイベントの発生がブロックされていた時間。The length of time that event firings were blocked when buffers were full. この値は0バッファー ポリシーが [Drop full buffer] または [Drop event] かどうか。This value is 0 if the buffer policy is "Drop full buffer" or "Drop event". NULL 値は許可されません。Is not nullable.
create_timecreate_time datetimedatetime セッションが作成された時刻。The time that the session was created. NULL 値は許可されません。Is not nullable.
largest_event_dropped_sizelargest_event_dropped_size intint セッション バッファーに収まらなかった最大のイベントのサイズ。The size of the largest event that did not fit into the session buffer. NULL 値は許可されません。Is not nullable.

権限Permissions

サーバーに対する VIEW SERVER STATE 権限が必要です。Requires VIEW SERVER STATE permission on the server.

変更履歴Change History

変更内容Updated content
name 列と blocked_event_fire_time 列のデータ型を修正しました。Corrected the data type for the name and the blocked_event_fire_time columns.
buffer_size 列と total_buffers 列を削除しました。Removed the buffer_size and total_buffers columns.
Total_regular_buffers、regular_buffer_size、total_large_buffers、追加しましたおよび total_buffer_size の各列を追加します。Added the total_regular_buffers,regular_buffer_size, total_large_buffers, large_buffer_size and total_buffer_size columns.

参照See Also

動的管理ビューおよび関数 (Transact-SQL)Dynamic Management Views and Functions (Transact-SQL)