sys.dm_exec_plan_attributes

更新 : 2006 年 12 月 12 日

プラン ハンドルで指定したプランのプラン属性ごとに 1 行のデータを返します。このテーブル値関数を使用すると、キャッシュ キーの値やプランの同時実行数など、特定のプランに関する詳細情報を取得できます。

メモ :
この関数によって返される情報には、旧バージョンと互換性のある sys.syscacheobjects ビューにマップされるものもあります。

構文

sys.dm_exec_plan_attributes (plan_handle)

引数

• plan_handle
  既に実行されていて、そのプランがプラン キャッシュに格納されているバッチのクエリ プランを一意に識別します。plan_handle のデータ型は varbinary(64) です。プラン ハンドルは、sys.dm_exec_cached_plans 動的管理ビューから取得できます。

返されるテーブル

列名

データ型

説明

attribute

varchar(128)

このプランに関連付けられている属性の名前。次のいずれかです。

属性

データ型

説明

set_optionsintプランをコンパイルしたオプションの値を示します。

objectidintキャッシュ内のオブジェクトを検索するために使用される主キーの 1 つです。プロシージャ、ビュー、トリガなどのデータベース オブジェクトの sys.objects に格納されたオブジェクト ID です。"アドホック プラン" または "準備されたプラン" では、バッチ テキストの内部ハッシュです。

dbidint所有するプランの対象となるエンティティが格納されているデータベースの ID です。アドホック プランまたは準備されたプランでは、バッチの実行元となるデータベース ID です。

dbid_executeintResource データベースに格納されているシステム オブジェクトの場合、キャッシュされたプランの実行元となるデータベース ID です。その他の場合は 0 になります。

user_idintオブジェクトが含まれているスキーマの ID です。値 -2 は、送られたバッチが暗黙的な名前解決に依存せず、複数ユーザー間での共有が可能であることを示します。この値は優先されます。

language_idsmallintキャッシュ オブジェクトを作成した接続の言語の ID です。詳細については、「sys.syslanguages (Transact-SQL)」を参照してください。

date_formatsmallintキャッシュ オブジェクトを作成した接続の日付形式です。詳細については、「SET DATEFORMAT (Transact-SQL)」を参照してください。

date_firsttinyint日付の最初の値です。詳細については、「SET DATEFIRST (Transact-SQL)」を参照してください。

statusintキャッシュ参照キーの一部である内部ステータス ビットです。

required_cursor_optionsintカーソルの種類など、ユーザーによって指定されたカーソル オプションです。

acceptable_cursor_optionsintSQL Server がステートメントの実行をサポートするために暗黙的に変換できるカーソル オプションです。たとえば、ユーザーは動的カーソルを指定することがありますが、クエリ オプティマイザでは、このカーソルの種類を静的カーソルに変換することが許可されています。詳細については、「暗黙のカーソル変換の使用」を参照してください。

inuse_exec_contextintクエリ プランを使用している現在実行中のバッチの数です。 実行コンテキストおよびクエリ プランの詳細については、「実行プランのキャッシュと再利用」を参照してください。

free_exec_contextintクエリ プランのキャッシュされた実行コンテキストのうち、現在使用されていない実行コンテキストの数です。

hits_exec_contextint実行コンテキストがプラン キャッシュから取得され再利用された回数です。これにより、SQL ステートメントを再コンパイルする際のオーバーヘッドが少なくなります。この値は、これまでのすべてのバッチ実行の集計です。

misses_exec_contextint実行コンテンツがプラン キャッシュに見つからなかった回数です。これにより、バッチ実行に対して新しい実行コンテンツが作成されます。

removed_exec_contextintキャッシュされたプランのメモリの負荷により削除された実行コンテンツの数です。

inuse_cursorsintキャッシュされたプランを使用しているカーソルを 1 つ以上含む、現在実行中のバッチの数です。

free_cursorsintキャッシュされたプランのアイドル状態または解放されたカーソルの数です。

hits_cursorsintキャッシュされたプランから非アクティブなカーソルが取得され、再利用された回数です。この値は、これまでのすべてのバッチ実行の集計です。

misses_cursorsint非アクティブなカーソルがキャッシュに見つからなかった回数です。

removed_cursorsintキャッシュされたプランのメモリの負荷により削除されたカーソルの数です。

sql_handlevarbinary(64)バッチの SQL ハンドルです。

value

sql_variant

プランに関連付けられている属性の値。

is_cache_key

bit

属性が、プランに対するキャッシュ参照キーの一部として使用されているかどうかを示します。

解説

SET オプション

同一のコンパイル済みプランのコピーでは、set_options 列の値のみが異なる場合があります。これは、異なる接続では、同じクエリに対して異なる SET オプション セットが使用されていることを示します。通常、異なるオプション セットを使用することは望ましくありません。異なるオプション セットを使用すると、余分なコンパイルが発生し、プランの再利用が減少して、キャッシュ内にプランの複数のコピーが存在することが原因でプラン キャッシュが増加します。詳細については、「クエリ チューニングに関する推奨設定」を参照してください。

SET オプションの評価

set_options に返された値を、プランをコンパイルしたオプションに変換するには、最も大きいと考えられる値から順に 0 に到達するまで、set_options の値からその値を減算します。減算する各値は、クエリ プランに使用されたオプションに対応しています。たとえば、set_options の値が 251 の場合、プランをコンパイルしたオプションは、ANSI_NULL_DFLT_ON (128)、QUOTED_IDENTIFIER (64)、ANSI_NULLS(32)、ANSI_WARNINGS (16)、CONCAT_NULL_YIELDS_NULL (8)、Parallel Plan(2)、および ANSI_PADDING (1) になります。

カーソル

非アクティブなカーソルは、カーソルの格納に使用されたメモリをカーソルの同時ユーザーが再利用できるように、コンパイル済みプランにキャッシュされます。たとえば、カーソルの割り当てを解除せずに、バッチでそのカーソルを宣言して使用するとします。2 人のユーザーが同じバッチを実行している場合、アクティブなカーソルが 2 つになります。(場合によっては別のバッチで) カーソルの割り当てが解除されると、カーソルの格納に使用されたメモリはキャッシュされ、解放されません。この非アクティブなカーソルの一覧は、コンパイル済みプランに保持されます。次にユーザーがバッチを実行するときに、キャッシュされたカーソルのメモリが再利用され、アクティブなカーソルとして適切に初期化されます。

カーソル オプションの評価

required_cursor_options および acceptable_cursor_options に返された値を、プランをコンパイルしたオプションに変換するには、最も大きいと考えられる値から順に 0 に到達するまで、列の値からその値を減算します。減算する各値は、クエリ プランに使用されたカーソル オプションに対応しています。

権限

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

例

A. 特定のプランの属性を返す

次の例では、指定したプランのすべてのプラン属性を返します。最初に、sys.dm_exec_cached_plans 動的管理ビューに対してクエリを実行し、指定したプランのプラン ハンドルを取得します。2 番目のクエリでは、<plan_handle> を最初のクエリで取得したプラン ハンドルの値に置き換えます。

SELECT plan_handle, refcounts, usecounts, size_in_bytes, cacheobjtype, objtype 
FROM sys.dm_exec_cached_plans;
GO
SELECT attribute, value, is_cache_key
FROM sys.dm_exec_plan_attributes(<plan_handle>);
GO

B. コンパイル済みプランの SET オプションとキャッシュされたプランの SQL ハンドルを返す

次の例では、各プランをコンパイルしたオプションを示す値を返します。さらに、SQL テキストと SQL ハンドルも返しています。

SELECT plan_handle, pvt.set_options, pvt.sql_handle, text
FROM (
    SELECT plan_handle, epa.attribute, epa.value, st.text 
    FROM sys.dm_exec_cached_plans 
        OUTER APPLY sys.dm_exec_plan_attributes(plan_handle) AS epa
        CROSS APPLY sys.dm_exec_sql_text(plan_handle) AS st
    WHERE cacheobjtype = 'Compiled Plan') AS ecpa 
PIVOT (MAX(ecpa.value) FOR ecpa.attribute IN ("set_options", "sql_handle")) AS pvt;
GO

参照

関連項目

動的管理ビューと動的管理関数
実行関連の動的管理ビューおよび関数
sys.dm_exec_cached_plans
sys.databases (Transact-SQL)
sys.objects (Transact-SQL)

ヘルプおよび情報

SQL Server 2005 の参考資料の入手

変更履歴