Plan Guide Unsuccessful 事件类

  • 项目

适用于：SQL Server

Plan Guide Unsuccessful 事件类指示 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。 SQL Server Profiler 如果在跟踪中捕获 ServerName 数据列而且服务器可用，则将显示数据库名。 可使用 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安全登录名或 MICROSOFT Windows 登录凭据，其格式为 DOMAIN\username) 。 11 是
LoginSid 图像 登录用户的安全标识号 (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)