sys.server_event_sessions (Transact-SQL)

適用対象: SQL Server Azure SQL Managed Instance

SQL Server または Azure SQL Managed Instance に存在するすべてのサーバー スコープのイベント セッション定義を一覧表示します。

Note

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

列名 データ型 説明
event_session_id int イベント セッションの一意な ID。 NULL 値は許可されません。
name sysname イベント セッションを識別するためのユーザー定義の名前。 name は一意です。 NULL 値は許可されません。
event_retention_mode nchar(1) イベント損失の処理方法を決定します。 既定値は、S です。 NULL 値は許可されません。 値は、次のいずれかです。

S. マップ event_retention_mode_desc = ALLOW_SINGLE_EVENT_LOSS

M. マップ event_retention_mode_desc = ALLOW_MULTIPLE_EVENT_LOSS

N. マップ event_retention_mode_desc = NO_EVENT_LOSS
event_retention_mode_desc sysname イベント損失の処理方法について説明します。 既定値は、ALLOW_SINGLE_EVENT_LOSS です。 NULL 値は許可されません。 値は、次のいずれかです。

ALLOW_SINGLE_EVENT_LOSS. イベントはセッションから失われる可能性があります。 1 つのイベントは、すべてのイベント バッファーがいっぱいの場合にのみ削除されます。 バッファーがいっぱいのときに単一のイベントを失うと、処理されたイベント ストリームの損失を最小限に抑えながら、許容される SQL Server のパフォーマンス特性を実現できます。

ALLOW_MULTIPLE_EVENT_LOSS. セッションから完全なイベント バッファーが失われる可能性があります。 失われるイベントの数は、セッションに割り当てられたメモリ サイズ、メモリのパーティション分割、バッファー内のイベントのサイズによって異なります。 このオプションを選択すると、イベント バッファーがすぐに満杯になったときのサーバーのパフォーマンスへの影響が最小限に抑えられます。 ただし、セッションから大量のイベントが失われる可能性があります。

NO_EVENT_LOSS. イベントの削除は許可されません。 このオプションにより、発生したすべてのイベントが保持されます。 このオプションを使用すると、イベントを発生させるすべてのタスクが、イベント バッファー内の領域が使用可能になるまで待機します。 これにより、イベント セッションがアクティブな間に検出可能なパフォーマンスの低下が発生する可能性があります。
max_dispatch_latency int イベントがセッション ターゲットに提供されるまでのメモリ内のバッファー処理時間 (ミリ秒単位)。 有効な値は、0 から 2,147,483,648、および 0 です。 0の値は、ディスパッチ待機時間が無限であることを示します。 Null 許容。
max_memory int イベント バッファリングのためにセッションに割り当てられたメモリの量。 既定値は 4 MB です。 Null 許容。
max_event_size int イベント セッション バッファーに収まらないイベント用に確保されたメモリの量。 max_event_size計算されたバッファー サイズを超えた場合、max_event_sizeの 2 つの追加バッファーがイベント セッションに割り当てられます。 Null 許容。
memory_partition_mode nchar(1) イベント バッファーが作成されるメモリ内の場所。 既定のパーティション モードは G。 NULL 値は許可されません。 memory_partition_mode は次のいずれかです。

G - NONE
C - PER_CPU
N - PER_NODE
memory_partition_mode_desc sysname 既定値は、NONE です。 NULL 値は許可されません。 値は、次のいずれかです。

NONE. 1 つのバッファー セットが SQL Server インスタンス内で作成されます。

PER_CPU. CPU ごとにバッファーのセットが作成されます。

PER_NODE. 一連のバッファーは、一様でないメモリ アクセス (NUMA) ノードごとに作成されます。
track_causality bit 因果関係の追跡を有効または無効にします。 1 (ON) に設定すると、追跡が有効になり、さまざまなサーバー接続の関連イベントを関連付けることができます。 既定の設定は 0 (OFF) です。 NULL 値は許可されません。
startup_state bit 値は、サーバーの起動時にセッションが自動的に開始されるかどうかを決定します。 既定値は、0 です。 NULL 値は許可されません。 次のいずれかになります。

0 (OFF)。 サーバーの起動時にセッションが開始されません。

1 (ON)。 サーバーの起動時にイベント セッションが開始されます。

アクセス許可

SQL Server 2019 (15.x) 以前のバージョンでは、サーバーに対する VIEW SERVER STATE アクセス許可が必要です。

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