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_principalssys.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)