sys.dm_xe_objects (Transact-SQL)

適用対象: はいSQL Server (サポートされているすべてのバージョン)

イベント パッケージによって公開されるオブジェクトごとに 1 行のデータを返します。 オブジェクトには、次のいずれかを指定できます。

  • イベント。 イベントは、実行パス内の関心のあるポイントを示します。 すべてのイベントには、関心のあるポイントに関する情報が含まれています。

  • アクション。 アクションは、イベントが発生したときに同期的に実行されます。 アクションは、実行時データをイベントに追加できます。

  • ターゲット. ターゲットは、イベントを開始したスレッド上で同期的にまたはシステムによって提供されたスレッド上で非同期的に、イベントを使用します。

  • 述部. 述語ソースは、比較演算で使用する値をイベント ソースから取得します。 述語の比較では、特定のデータ型が比較され、ブール値が返されます。

  • 種類: 型は、バイトコレクションの長さと特性をカプセル化します。これは、データを解釈するために必要です。

列名 データ型 説明
name nvarchar(60) オブジェクトの名前。 名前は、特定の種類のオブジェクトのパッケージ内で一意です。 NULL 値は許可されません。
object_type nvarchar(60) オブジェクトの型。 object_type は次のいずれかです。

イベント

action

ターゲット (target)

pred_source

pred_compare

type

NULL 値は許可されません。
package_guid uniqueidentifier このアクションを公開するパッケージの GUID。 sys.dm_xe_packages.package_id との間に多対一のリレーションシップがあります。 NULL 値は許可されません。
説明 nvarchar (256) アクションの説明。 説明はパッケージの作成者によって設定されます。 NULL 値は許可されません。
capabilities int オブジェクトの機能を説明するビットマップ。 NULL 値が許可されます。
capabilities_desc nvarchar (256) オブジェクトのすべての機能を一覧表示します。 NULL 値が許可されます。

すべてのオブジェクトの種類に適用される機能

-
プライベート。 内部的に使用できる唯一のオブジェクトであり、CREATE/ALTER EVENT SESSION DDL ではアクセスできません。 監査イベントとターゲットは、内部的に使用される少数のオブジェクトに加えて、このカテゴリに分類されます。

===============

イベントの機能

-
No_block。 イベントは、どのような理由でもブロックできない重要なコード パス内にあります。 この機能を持つイベントは、NO_EVENT_LOSS を指定するイベントセッションに追加することはできません。

===============

すべてのオブジェクトの種類に適用される機能

-
Process_whole_buffers。 ターゲットは、イベントごとではなく、イベントのバッファーをまとめて使用します。

-
シングルトン。 プロセスにはターゲットのインスタンスが 1 つだけ存在できます。 複数のイベント セッションで同じシングルトン ターゲットを参照できますが、インスタンスは 1 つだけであり、そのインスタンスが一意の各イベントを 1 回だけ認識します。 これは、すべてが同じイベントを収集する複数のセッションにターゲットが追加される場合に重要です。

-
同期。 ターゲットは、呼び出し元のコード行に制御が返される前に、イベントを生成しているスレッドで実行されます。
type_name nvarchar(60) pred_source オブジェクトおよび pred_compare オブジェクトの名前。 NULL 値が許可されます。
type_package_guid uniqueidentifier このオブジェクトの対象となる型を公開するパッケージの GUID。 NULL 値が許可されます。
type_size int データ型のサイズ (バイト単位)。 これは、有効なオブジェクトの種類に対してのみ使用されます。 NULL 値が許可されます。

アクセス許可

サーバーに対する VIEW SERVER STATE 権限が必要です。

リレーションシップ基数

ソース 終了 リレーションシップ
sys.dm_xe_objects.package_guid sys.dm_xe_packages.guid 多対一

参照

動的管理ビューと動的管理関数 (Transact-SQL)