sys.dm_exec_cached_plans (Transact-SQL)

發行項
12/19/2023

適用於：SQL Server Azure SQL Database Azure SQL 受控執行個體 Azure Synapse Analytics Analytics Platform System (PDW)

針對 SQL Server 快取的每個查詢計劃，傳回一個資料列，以加快查詢執行速度。您可以使用此動態管理檢視來尋找快取的查詢計劃、快取的查詢文字、快取計畫所擷取的記憶體數量，以及快取計畫的重複使用計數。

在 Azure SQL Database 中，動態管理檢視不可以公開可能會影響資料庫內含項目的資訊，或公開有關使用者可存取之其他資料庫的資訊。為了避免公開這項資訊，會篩選出包含不屬於已連線租使用者之資料的每個資料列。此外，會篩選資料行memory_object_address 和 pool_id 中的 值;資料行值會設定為 Null。

注意

若要從 Azure Synapse Analytics 或 Analytics Platform System （PDW）呼叫此專案，請使用名稱 sys.dm_pdw_nodes_exec_cached_plans 。 Azure Synapse Analytics 的無伺服器 SQL 集區不支援此語法。

資料行名稱	資料類型	描述
bucketid	int	快取專案所在的雜湊值區識別碼。值表示範圍從 0 到快取類型的雜湊表大小。針對 SQL 方案和物件計畫快取，雜湊表大小在 32 位系統上最多可達 10007,64 位系統上最多可有 40009 個。對於系結樹狀結構快取，雜湊表大小在 32 位系統上最多可達 1009，而 64 位系統上最多可有 4001 個。針對擴充預存程式快取，雜湊表大小在 32 位和 64 位系統上最多可達 127。
refcounts	int	參考此快取物件的快取物件數目。在快取中，必須至少有 1 個專案的 Refcount 。
usecounts	int	快取物件的查閱次數。參數化查詢在快取中尋找計畫時，不會遞增。使用 showplan 時，可以遞增多次。
size_in_bytes	int	快取物件所耗用的位元組數目。
memory_object_address	Varbinary（8）	快取專案的記憶體位址。這個值可以與 sys.dm_os_memory_objects 搭配使用，以取得快取計畫的記憶體明細，以及搭配 sys.dm_os_memory_cache_entries _entries 以取得快取專案的成本。
cacheobjtype	Nvarchar（34）	快取中的物件類型。此值可以是下列其中一項：已編譯的計畫已編譯的計畫存根剖析樹狀結構擴充程式 CLR 編譯的 Func CLR 編譯的 Proc
objtype	Nvarchar（16）	物件的類型。以下是可能的值及其對應的描述。 Proc：預存程式已備妥：備妥的語句 Adhoc：臨機操作查詢。是指使用 osql 或 sqlcmd 提交為語言事件的 Transact-SQL，而不是做為遠端程序呼叫。 ReplProc：Replication-filter-procedure 觸發程式：觸發程式檢視：檢視預設值：預設值 UsrTab：使用者資料表 SysTab：系統資料表檢查：CHECK 條件約束規則：規則
plan_handle	varbinary(64)	記憶體中計畫的識別碼。這個識別碼是暫時性的，只有當計畫留在快取時才會保留。此值可與下列動態管理功能搭配使用： sys.dm_exec_sql_text sys.dm_exec_query_plan sys.dm_exec_plan_attributes
pool_id	int	為此計畫記憶體使用量所考慮的資源集區識別碼。
pdw_node_id	int	適用於：Azure Synapse Analytics、Analytics Platform System (PDW) 此散發節點的識別碼。

權限

在 SQL Server 和 SQL 受控執行個體上，需要 VIEW SERVER STATE 權限。

在SQL 資料庫基本、S0 和 S1 服務目標上，以及彈性集 區中的 資料庫，需要伺服器管理員帳戶、 Microsoft Entra 系統管理員帳戶或伺服器角色的成員 ##MS_ServerStateReader## 資格。在所有其他 SQL Database 服務目標上，需要資料庫的 VIEW DATABASE STATE 權限或 ##MS_ServerStateReader## 伺服器角色的成員資格。

SQL Server 2022 及更新版本的權限

需要伺服器上的 VIEW SERVER PERFORMANCE STATE 權限。

範例

A. 傳回重複使用之快取專案的批次文字

下列範例會傳回已多次使用之所有快取專案的 SQL 文字。

SELECT usecounts, cacheobjtype, objtype, text   
FROM sys.dm_exec_cached_plans   
CROSS APPLY sys.dm_exec_sql_text(plan_handle)   
WHERE usecounts > 1   
ORDER BY usecounts DESC;  
GO

B. 傳回所有快取觸發程式的查詢計劃

下列範例會傳回所有快取觸發程式的查詢計劃。

SELECT plan_handle, query_plan, objtype   
FROM sys.dm_exec_cached_plans   
CROSS APPLY sys.dm_exec_query_plan(plan_handle)   
WHERE objtype ='Trigger';  
GO

C. 傳回編譯計畫的 SET 選項

下列範例會傳回編譯計畫的 SET 選項。 sql_handle也會傳回計畫的。 PIVOT 運算子是用來將和 sql_handle 屬性輸出 set_options 為數據行，而不是資料列。如需中 set_options 傳回之值的詳細資訊，請參閱 sys.dm_exec_plan_attributes （Transact-SQL）。

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

D. 傳回所有快取編譯計畫的記憶體分解

下列範例會傳回快取中所有已編譯計畫所使用的記憶體明細。

SELECT plan_handle, ecp.memory_object_address AS CompiledPlan_MemoryObject,   
    omo.memory_object_address, type, page_size_in_bytes   
FROM sys.dm_exec_cached_plans AS ecp   
JOIN sys.dm_os_memory_objects AS omo   
    ON ecp.memory_object_address = omo.memory_object_address   
    OR ecp.memory_object_address = omo.parent_address  
WHERE cacheobjtype = 'Compiled Plan';  
GO

另請參閱

動態管理檢視和函數 (Transact-SQL)
執行相關的動態管理檢視和函數 (Transact-SQL)
sys.dm_exec_query_plan （Transact-SQL）
sys.dm_exec_plan_attributes （Transact-SQL）
sys.dm_exec_sql_text (Transact-SQL)
sys.dm_os_memory_objects （Transact-SQL）
sys.dm_os_memory_cache_entries （Transact-SQL）
FROM (Transact-SQL)