Plan Guide Unsuccessful 事件類別
適用於：
SQL Server
計劃指南不成功事件類別指出 SQL Server 無法針對包含計劃指南的查詢或批次產生執行計劃。 相反地，計劃是在不使用計劃指南的情況下編譯的。 當下列條件成立時，就會引發此事件：
計劃指南定義中的批次/模組符合正在執行的批次。
計劃指南定義中的查詢符合正在執行的查詢。
計劃指南定義中的提示，包括
USE PLAN提示，未成功套用至查詢或批次。 也就是說，編譯的查詢計劃無法接受指定的提示，而且計劃是在不使用計劃指南的情況下編譯的。
無效的計劃指南可能會導致此事件引發。 使用 sys.fn_validate_plan_guide 函式來驗證查詢或批次所使用的計劃指南，並更正此函式所報告的錯誤。
此事件包含在 SQL Server Profiler Tuning 範本中。
注意
Azure SQL 資料庫 中無法使用此事件類別。
計劃指南不成功事件類別數據行
| 數據行名稱 | 資料類型 | 描述 | 資料行識別碼 | 可篩選 |
|---|---|---|---|---|
| ApplicationName | nvarchar | 建立 SQL Server 實例之連線的用戶端應用程式名稱。 此資料行會填入應用程式所傳遞的值，而不是程序顯示的名稱。 | 10 | Yes |
| ClientProcessID | int | 主計算機指派給執行用戶端應用程式的進程標識碼。 如果用戶端提供客戶端進程識別碼，就會填入此資料行。 | 9 | Yes |
| DatabaseID | int | 如果指定的實例未發出USE database語句，則為USE database語句或預設資料庫所指定的資料庫標識碼。 如果在追蹤中擷取到 ServerName 資料行且伺服器可用，SQL Server Profiler 便會顯示資料庫的名稱。 請使用 DB_ID 函數判斷資料庫的值。 | 3 | Yes |
| DatabaseName | nvarchar | 使用者語句執行所在的資料庫名稱。 | 35 | Yes |
| EventClass | int | 事件類型 = 218。 | 27 | No |
| EventSequence | int | 要求內特定事件的順序。 | 51 | No |
| HostName | nvarchar | 用戶端執行所在的計算機名稱。 如果用戶端提供主機名，則會填入此數據行。 若要判斷主機名稱，請使用 HOST_NAME 函數。 | 8 | Yes |
| IsSystem | int | 指出事件發生在系統進程或用戶進程上：1 = 系統，0 = 使用者。 | 60 | Yes |
| LoginName | nvarchar | 使用者登入的名稱（SQL Server 安全性登入或以 DOMAIN\username 形式Microsoft Windows 登入認證）。 | 11 | Yes |
| LoginSid | image | 已登入使用者的安全性識別碼（SID）。 您可以在 sys.server_principals 或 sys.sql_logins 目錄檢視中找到此資訊。 每一個 SID 對於伺服器中的每個登入而言都是唯一的。 | 41 | Yes |
| NTDomainName | nvarchar | 用戶所屬的 Windows 網域。 | 7 | Yes |
| NTUserName | nvarchar | Windows 用戶名稱。 | 6 | Yes |
| ObjectID | int | 套用計劃指南時所編譯之模組的物件標識符。 如果計劃指南未套用至模組，此數據行會設定為 NULL。 | 22 | Yes |
| 要求識別碼 | int | 包含語句的要求標識碼。 | 49 | Yes |
| ServerName | nvarchar | 正在追蹤之 SQL Server 實例的名稱。 | 26 | No |
| SessionLoginName | nvarchar | 產生工作階段之使用者的登入名稱。 例如，如果您使用Login1連接到SQL Server，並以Login2的形式執行語句，SessionLoginName 會顯示Login1，而LoginName 會顯示Login2。 此數據行會顯示 SQL Server 和 Windows 登入。 | 64 | Yes |
| SPID | int | 事件發生所在之工作階段的識別碼。 | 12 | Yes |
| StartTime | datetime | 如果有的話，事件開始的時間。 | 14 | Yes |
| TextData | ntext | 計劃指南的名稱。 | 1 | Yes |
| TransactionID | bigint | 交易的系統指派標識碼。 | 4 | Yes |
| XactSequence | bigint | 描述目前交易的令牌。 | 50 | Yes |
另請參閱
計劃指南成功事件類別
擴充事件
sp_trace_setevent (Transact-SQL)
sys.fn_validate_plan_guide (Transact-SQL)
sp_create_plan_guide (Transact-SQL)
sp_create_plan_guide_from_handle (Transact-SQL)