sys.dm_xe_objects (Transact-SQL)
適用対象: SQL Server Azure SQL Database Azure SQL Managed Instance
イベント パッケージによって公開されるオブジェクトごとに 1 行のデータを返します。 オブジェクトには、次のいずれかを指定できます。
イベント。 イベントは、実行パスに関心のあるポイントを示します。 すべてのイベントには、目的地に関する情報が含まれています。
アクション] を選択します。 アクションは、イベントが発生したときに同期的に実行されます。 アクションは、実行時データをイベントに追加できます。
ターゲット。 ターゲットは、イベントを開始したスレッド上で同期的にまたはシステムによって提供されたスレッド上で非同期的に、イベントを使用します。
述語。 述語ソースは、比較演算で使用する値をイベント ソースから取得します。 述語の比較では、特定のデータ型が比較され、ブール値が返されます。
種類: 型は、データを解釈するために必要なバイト コレクションの長さと特性をカプセル化します。
列名 | データ型 | 説明 |
---|---|---|
name | nvarchar(60) | オブジェクトの名前。 name は、特定のオブジェクト型のパッケージ内で一意です。 NULL 値は許可されません。 |
object_type | nvarchar(60) | オブジェクトの古い型。 object_typeは次のいずれかです。 event action ターゲット pred_source pred_compare type NULL 値は許可されません。 |
package_guid | uniqueidentifier | このアクションを公開するパッケージの GUID。 sys.dm_xe_packages.package_id との間に多対一のリレーションシップがあります。 NULL 値は許可されません。 |
description | nvarchar (256) | アクションの説明。 説明はパッケージ作成者によって設定されます。 NULL 値は許可されません。 |
capabilities | int | オブジェクトの機能を記述するビットマップ。 NULL 値が許可されます。 |
capabilities_desc | nvarchar (256) | オブジェクトのすべての機能を一覧表示します。 NULL 値が許可されます。 すべてのオブジェクトの種類に適用される機能 - Private. 内部的に使用できる唯一のオブジェクトであり、CREATE/ALTER EVENT SESSION DDL ではアクセスできません。 監査イベントとターゲットは、内部的に使用される少数のオブジェクトに加えて、このカテゴリに分類されます。 =============== イベント機能 - No_block。 イベントは、どのような理由でもブロックできない重要なコード パス内にあります。 この機能を持つイベントは、NO_EVENT_LOSSを指定するイベント セッションには追加できません。 =============== すべてのオブジェクトの種類に適用される機能 - Process_whole_buffers。 ターゲットは、イベントごとではなく、イベントのバッファーをまとめて使用します。 - シングルトン。 プロセスにはターゲットのインスタンスが 1 つだけ存在できます。 複数のイベント セッションで同じシングルトン ターゲットを参照できますが、インスタンスは 1 つだけであり、そのインスタンスが一意の各イベントを 1 回だけ認識します。 これは、ターゲットがすべて同じイベントを収集する複数のセッションに追加される場合に重要です。 - Synchronous。 ターゲットは、呼び出し元のコード行に制御が返される前に、イベントを生成しているスレッドで実行されます。 |
type_name | nvarchar(60) | pred_source オブジェクトおよび pred_compare オブジェクトの名前。 NULL 値が許可されます。 |
type_package_guid | uniqueidentifier | このオブジェクトの対象となる型を公開するパッケージの GUID。 NULL 値が許可されます。 |
type_size | int | データ型のサイズ (バイト単位)。 これは、有効なオブジェクト型に対してのみ行われます。 NULL 値が許可されます。 |
アクセス許可
サーバーに対する VIEW SERVER STATE 権限が必要です。
SQL Server 2022 以降でのアクセス許可
サーバーに対する VIEW SERVER PERFORMANCE STATE アクセス許可が必要です。
リレーションシップのカーディナリティ
ソース | ターゲット | 関係 |
---|---|---|
sys.dm_xe_objects.package_guid | sys.dm_xe_packages.guid | 多対一 |
次のステップ
関連する概念の詳細については、次の記事を参照してください。