分享方式:


sys.fn_validate_plan_guide (Transact-SQL)

適用於:SQL Server Azure SQL 受控執行個體

驗證指定計劃指南的有效性。 函 sys.fn_validate_plan_guide 式會傳回當計劃指南套用至其查詢時遇到的第一個錯誤訊息。 當計劃指南有效時,會傳回空的數據列集。 在對資料庫的實體設計進行變更之後,計劃指南可能會變成無效。 例如,如果計劃指南指定特定索引,且該索引後續卸除,查詢將無法再使用計劃指南。

藉由驗證計劃指南,您可以判斷優化工具是否可以在不修改的情況下使用指南。 根據函式的結果,您可以決定卸除計劃指南,然後重新調整查詢或修改資料庫設計,例如,重新建立計劃指南中指定的索引。

Transact-SQL 語法慣例

語法

sys.fn_validate_plan_guide ( plan_guide_id )  

引數

plan_guide_id
這是如sys.plan_guides目錄檢視中所報告的計劃指南標識碼。 plan_guide_id為 int,沒有預設值。

傳回的資料表

資料行名稱 資料類型 描述
msgnum int 錯誤訊息的識別碼。
severity tinyint 訊息的嚴重性層級,介於 1 到 25 之間。
state smallint 錯誤的狀態編號,指出發生錯誤之程式代碼中的點。
message nvarchar(2048) 錯誤的訊息正文。

權限

物件範圍計劃指南需要參考物件的 VIEW DEFINITION 或 ALTER 許可權,以及編譯計劃指南中提供的查詢或批次的許可權。 例如,如果批次包含 SELECT 語句,則需要參考物件的 SELECT 許可權。

SQL 或 TEMPLATE 範圍計劃指南需要資料庫的 ALTER 許可權,以及編譯計劃指南中提供的查詢或批次的許可權。 例如,如果批次包含 SELECT 語句,則需要參考物件的 SELECT 許可權。

備註

Azure SQL 資料庫 中無法使用函sys.fn_validate_plan_guide式。

範例

A. 驗證資料庫中的所有計劃指南

下列範例會檢查目前資料庫中所有計劃指南的有效性。 如果傳回空的結果集,則所有計劃指南都是有效的。

USE AdventureWorks2022;  
GO  
SELECT plan_guide_id, msgnum, severity, state, message  
FROM sys.plan_guides  
CROSS APPLY fn_validate_plan_guide(plan_guide_id);  
GO  

B. 在實作資料庫的變更之前,先測試計劃指南驗證

下列範例會使用明確的交易來卸除索引。 函 sys.fn_validate_plan_guide 式會執行,以判斷此動作是否會使資料庫中的任何計劃指南失效。 根據函式的結果, DROP INDEX 語句會認可或回復交易,而且不會卸除索引。

USE AdventureWorks2022;  
GO  
BEGIN TRANSACTION;  
DROP INDEX IX_SalesOrderHeader_CustomerID ON Sales.SalesOrderHeader;  
-- Check for invalid plan guides.  
IF EXISTS (SELECT plan_guide_id, msgnum, severity, state, message  
           FROM sys.plan_guides  
           CROSS APPLY sys.fn_validate_plan_guide(plan_guide_id))  
    ROLLBACK TRANSACTION;  
ELSE  
    COMMIT TRANSACTION;  
GO  

另請參閱

計畫指南
sp_create_plan_guide (Transact-SQL)
sp_create_plan_guide_from_handle (Transact-SQL)