sys.dm_xe_objects (Transact-SQL)

  • [アーティクル]

適用対象:SQL ServerAzure SQL DatabaseAzure SQL Managed Instance

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

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

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

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

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

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

列名 データ型 説明
name nvarchar(60) オブジェクトの名前。 name は、特定のオブジェクト型のパッケージ内で一意です。 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 値は許可されません。
description nvarchar (256) アクションの説明。 description はパッケージ作成者によって設定されます。 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 回だけ認識します。 これは、ターゲットが、すべて同じイベントを収集する複数のセッションに追加される場合に重要です。

-
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 多対一

次のステップ

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