sys.database_event_sessions (Azure SQL Database と Azure SQL Managed Instance)

適用対象: Azure SQL Database Azure SQL Managed Instance

現在のデータベースに存在するすべてのデータベース スコープのイベント セッション定義を一覧表示します。 アクティブデータベース スコープのイベント セッションについては、sys.dm_xe_database_sessionsを参照してください。

Azure SQL Database では、 database スコープのセッションのみがサポート。 Azure SQL Managed Instance では、データベース スコープセッションと サーバー スコープ セッションの両方がサポートされます。 マネージド インスタンスには、サーバー スコープのセッションをお勧めします。詳細については、 CREATE EVENT SESSIONを参照してください。

列名 データ型 説明
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 にマップ

北 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。 イベントの削除は許可されません。 このオプションにより、発生したすべてのイベントが保持されます。 このオプションを使用すると、イベントを発生させるすべてのタスクが、イベント バッファー内の領域が使用可能になるまで待機します。 これにより、イベント セッションがアクティブな間に検出可能なパフォーマンスの低下が発生する可能性があります。 Azure SQL Database のイベント ファイル ターゲットの場合、ALLOW_SINGLE_EVENT_LOSSと同じように動作します。 詳細については、「 EVENT_RETENTION_MODE」を参照してください。
max_dispatch_latency int イベントがセッション ターゲットに提供されるまでのメモリ内のバッファー処理時間 (ミリ秒単位)。 有効な値は 1 から 2147483648、-1 です。 値 -1 は、ディスパッチ待機時間が無限であることを示します。 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 (オン)。 サーバーの起動時にイベント セッションが開始されます。

アクセス許可

VIEW DATABASE STATE 権限が必要です。

次のステップ

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