sys.dm_exec_plan_attributes
更新： 2006 年 12 月 12 日
針對計劃控制代碼所指定計劃的每個計劃屬性，各傳回一個資料列。您可以使用這個資料表值函數取得特定計劃的詳細資料，例如快取索引鍵值或目前同時執行計劃數目。
.gif "ms189472.note(zh-tw,SQL.90).gif") 附註： |
|---|
| 透過這個函數傳回的部分資訊會對應至 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用來查閱快取中物件的主要索引鍵之一。這是資料庫物件 (程序、檢視、觸發程序等) 儲存在 sys.objects 中的物件識別碼。若計劃屬於「特定」或「準備」類型，這是批次文字的內部雜湊。
dbidint這是資料庫的識別碼，即計劃的實體所在位置。若為特定或準備計劃，這是執行批次的來源資料庫識別碼。
dbid_executeint對於儲存在**「資源」**資料庫中的系統物件，這是執行快取計劃的來源資料庫識別碼。其他則為 0。
user_idint包含物件的結構描述識別碼。-2 值表示提交的批次不會隨著隱含的名稱解析而不同，不同的使用者可以共用這些批次。這是慣用的方法。
language_idsmallint建立快取物件之連接的語言識別碼。如需詳細資訊，請參閱＜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目前執行的批次數目，這些批次包含一或多個使用快取計劃的資料指標。
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 中傳回的值轉譯為編譯計劃所用的選項，請從 set_options 值減去這些值，從最大的可能值開始，一直減到 0 為止。每個減掉的值即為查詢計劃中使用的選項。例如，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)。
| 選項 | 值 |
|---|---|
ANSI_PADDING |
1 |
Parallel Plan |
2 |
FORCEPLAN |
4 |
CONCAT_NULL_YIELDS_NULL |
8 |
ANSI_WARNINGS |
16 |
ANSI_NULLS |
32 |
QUOTED_IDENTIFIER |
64 |
ANSI_NULL_DFLT_ON |
128 |
ANSI_NULL_DFLT_OFF |
256 |
NoBrowseTable 表示計劃不使用工作資料表來實作 FOR BROWSE 作業。 |
512 |
TriggerOneRow 表示計劃包含單一資料列最佳化，以供 AFTER 和 INSTEAD OF 觸發程序使用。也就是，如果 inserted 或 deleted 資料表中只有一個資料列受到影響，就會設定此選項。適用於執行同處理序資料存取的 Transact-SQL 觸發程序和 CLR 觸發程序。 |
1024 |
ResyncQuery 表示查詢是由內部系統預存程序提交。 |
2048 |
ARITH_ABORT |
4096 |
NUMERIC_ROUNDABORT |
8192 |
DATEFIRST |
16384 |
DATEFORMAT |
32768 |
LanguageID |
65536 |
UPON 表示當編譯計劃時，PARAMETERIZATION 資料庫選項設為 FORCED。 |
131072 |
資料指標
非使用中的資料指標會快取在編譯的計劃中，讓用來儲存資料指標的記憶體可供資料指標的並行使用者重複使用。例如，假設有個批次宣告並使用資料指標，但沒有取消配置。如果有兩個使用者執行相同的批次，會有兩個使用中的資料指標。一旦資料指標取消配置 (可能在不同的批次中)，用來儲存資料指標的記憶體就會快取，而不會釋出。非使用中資料指標的清單會保留在編譯的計劃中。等到下次使用者執行批次時，會重複使用快取的資料指標記憶體，並適當地初始化為使用中資料指標。
評估資料指標選項
若要將 required_cursor_options 和 acceptable_cursor_options 中傳回的值轉譯為編譯計劃所用的選項，請從資料行的值減去這些值，從最大的可能值開始，一直減到 0 為止。每個減掉的值即為查詢計劃中使用的資料指標選項。
| 選項 | 值 |
|---|---|
無 |
0 |
INSENSITIVE |
1 |
SCROLL |
2 |
READ ONLY |
4 |
FOR UPDATE |
8 |
LOCAL |
16 |
GLOBAL |
32 |
FORWARD_ONLY |
64 |
KEYSET |
128 |
DYNAMIC |
256 |
SCROLL_LOCKS |
512 |
OPTIMISTIC |
1024 |
STATIC |
2048 |
FAST_FORWARD |
4096 |
IN PLACE |
8192 |
FOR select_statement |
16384 |
權限
需要伺服器的 VIEW SERVER STATE 權限。
範例
A. 傳回特定計劃的屬性
下列範例會傳回指定計劃的所有計劃屬性。首先會查詢 sys.dm_exec_cached_plans 動態管理檢視，取得指定計劃的計劃控制代碼。在第二個查詢中，再用第一個查詢的計劃控制代碼值取代 <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)
說明及資訊
變更歷程記錄
| 版本 | 歷程記錄 |
|---|---|
2006 年 12 月 12 日 |
|