Plan Guide Unsuccessful 事件类
适用于：
SQL Server
Plan Guide 失败事件类指示 SQL Server 无法为包含计划指南的查询或批处理生成执行计划。 相反，计划将在不使用计划指南的情况下进行编译。 当满足下列条件时，事件将激发：
计划指南定义中的批处理/模块与正在执行的批处理相匹配。
计划指南定义中的查询与正在执行的查询相匹配。
计划指南定义中的提示（包括
USE PLAN提示）未成功应用于查询或批处理。 也就是说，编译的查询计划无法遵守指定的提示，并且该计划将在不使用计划指南的情况下进行编译。
无效的计划指南可能导致此事件激发。 请使用 sys.fn_validate_plan_guide 函数来验证查询或批处理所使用的计划指南，然后更正此函数报告的错误。
此事件包含在 SQL Server Profiler 优化模板中。
注意
此事件类在Azure SQL 数据库中不可用。
Plan Guide Unsuccessful 事件类的数据列
| 数据列名称 | 数据类型 | 说明 | 列 ID | 可筛选 |
|---|---|---|---|---|
| ApplicationName | nvarchar | 创建到 SQL Server 实例连接的客户端应用程序的名称。 此列由应用程序传递的值填充，而不是由所显示的程序名称填充。 | 10 | 是 |
| ClientProcessID | int | 主机为运行该客户端应用程序的进程分配的 ID。 如果客户端提供了客户端进程 ID，则填充此数据列。 | 9 | 是 |
| DatabaseID | int | 由 USE database 语句指定的数据库的 ID；如果未对指定实例发出 USE database 语句，则为默认数据库的 ID。 如果在跟踪中捕获 ServerName 数据列且服务器可用，SQL Server Profiler 将显示数据库名称。 可使用 DB_ID 函数来确定数据库的值。 | 3 | 是 |
| DatabaseName | nvarchar | 正在其中运行用户语句的数据库的名称。 | 35 | 是 |
| EventClass | int | 事件类型 = 218。 | 27 | 否 |
| EventSequence | int | 特定事件在请求中的顺序。 | 51 | 否 |
| HostName | nvarchar | 正在运行客户端的计算机的名称。 如果客户端提供了主机名，则填充此数据列。 若要确定主机名，请使用 HOST_NAME 函数。 | 8 | 是 |
| IsSystem | int | 指示事件是发生在系统进程还是发生在用户进程：1 = 系统，0 = 用户。 | 60 | 是 |
| LoginName | nvarchar | 用户的登录名（SQL Server 安全登录名或以 DOMAIN\username 形式Microsoft Windows 登录凭据）。 | 11 | 是 |
| LoginSid | image | 登录用户的安全标识号 (SID)。 你可以在 sys.server_principals 或 sys.sql_logins 目录视图中找到此信息。 服务器中的每个登录名都具有唯一的 SID。 | 41 | 是 |
| NTDomainName | nvarchar | 用户所属的 Windows 域。 | 7 | 是 |
| NTUserName | nvarchar | Windows 用户名。 | 6 | 是 |
| ObjectID | int | 应用计划指南时正在编译的模块的对象 ID。 如果计划指南未应用到模块，则此列将设置为 NULL。 | 22 | 是 |
| RequestID | int | 包含该语句的请求的 ID。 | 49 | 是 |
| ServerName | nvarchar | 正在跟踪的 SQL Server 实例的名称。 | 26 | 否 |
| SessionLoginName | nvarchar | 发起会话的用户的登录名。 例如，如果使用 Login1 连接到 SQL Server，并将语句作为 Login2 执行，SessionLoginName 将显示 Login1，LoginName 显示 Login2。 此列同时显示 SQL Server 和 Windows 登录名。 | 64 | 是 |
| SPID | int | 发生该事件的会话的 ID。 | 12 | 是 |
| StartTime | datetime | 该事件（如果存在）的启动时间。 | 14 | 是 |
| TextData | ntext | 计划指南的名称。 | 1 | 是 |
| TransactionID | bigint | 系统分配的事务 ID。 | 4 | 是 |
| XactSequence | bigint | 用于说明当前事务的标记。 | 50 | 是 |
另请参阅
Plan Guide Successful 事件类
扩展事件
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)