sys.dm_exec_plan_attributes (Transact-SQL)

  • 项目

适用于：SQL Server

针对计划句柄所指定计划的每个计划属性返回一行。 可以使用此表值函数获取有关特定计划的详细信息，例如计划的缓存键值或当前同步执行次数。

注意

通过此函数返回的一些信息映射到 sys.syscacheobjects 向后兼容性视图。

语法

sys.dm_exec_plan_attributes ( plan_handle )

参数

plan_handle
用于唯一标识已执行并且其计划驻留在计划缓存中的批处理的查询计划。 plan_handle 是 varbinary(64)。 可以从sys.dm_exec_cached_plans动态管理视图获取计划句柄。

返回的表

列名称 数据类型 描述
attribute varchar(128) 与此计划关联的属性的名称。 此表紧邻此表列出了可能的属性、其数据类型及其说明。
value sql_variant 与此计划关联的属性的值。
is_cache_key bit 指示此属性是否用作计划的缓存查找密钥的一部分。

在上表中， 属性 可以具有以下值：

Attribute 数据类型 描述
set_options int 指示编译计划所使用的选项值。
objectid int 用于在缓存中查找对象的主键之一。 这是存储在 数据库对象的 sys.objects 中的对象 ID（过程、视图、触发器等）。 对于类型为“即席”或“已准备好”的计划，它是批处理文本的内部哈希。
dbid int 是包含计划引用的实体的数据库 ID。

对于即席计划或已准备好的计划，它是执行批处理的数据库 ID。
dbid_execute int 对于存储在 Resource 数据库中的系统对象，执行缓存计划的数据库 ID。 对于所有其他情况，均为 0。
user_id int 值 -2 指示已提交的批处理不依赖于隐式名称解析并可在不同的用户间共享。 这是首选方法。 任何其他值表示数据库中提交查询的用户的用户 ID。
language_id smallint 创建缓存对象的连接的语言 ID。 有关详细信息，请参阅 sys.syslanguages （Transact-SQL）。
date_format smallint 创建缓存对象的连接的日期格式。 有关详细信息，请参阅 SET DATEFORMAT (Transact-SQL)。
date_first tinyint 第一个日期值。 有关详细信息，请参阅 SET DATEFIRST (Transact-SQL).
compat_level tinyint 表示在编译查询计划的上下文的数据库中设置的兼容性级别。 返回的兼容级别是临时语句的当前数据库上下文的兼容级别，不受查询提示 QUERY_OPTIMIZER_COMPATIBILITY_LEVEL_n影响。 对于存储过程或函数中包含的语句，它对应于在其中创建存储过程或函数的数据库的兼容级别。
status int 缓存查找密钥中的内部状态位。
required_cursor_options int 用户指定的游标选项，例如游标类型。
acceptable_cursor_options int SQL Server 可以隐式转换为的游标选项以支持语句的执行。 例如，用户可能指定一个动态游标，但允许查询优化器将此游标类型转换为静态游标。
merge_action_type smallint 用作 MERGE 语句结果的触发器执行计划的类型。

0 表示非触发器计划，或者不会作为 MERGE 语句结果来执行的触发器计划，或者作为仅指定 DELETE 操作的 MERGE 语句结果执行的触发器计划。

1 表示作为 MERGE 语句结果运行的 INSERT 触发器计划。

2 表示作为 MERGE 语句结果运行的 UPDATE 触发器计划。

3 表示一个作为包含对应的 INSERT 或 UPDATE 操作的 MERGE 语句结果运行的 DELETE 触发器计划。

对于由级联操作运行的嵌套触发器，此值是导致级联的 MERGE 语句的操作。
is_副本 (replica)tion_specific int 表示从中编译此计划的会话是使用未记录的连接属性连接到 SQL Server 实例的会话，该属性允许服务器将会话标识为由副本 (replica)组件创建的会话，以便根据此类副本 (replica)tion 组件的预期更改服务器的某些功能方面的行为。
optional_spid smallint 连接session_id（spid）成为缓存密钥的一部分，以减少重新编译的数量。 这样可以防止重新编译单个会话重新使用涉及非动态绑定临时表的计划。
optional_clr_trigger_dbid int 仅在 CLR DML 触发器的情况下填充。 包含实体的数据库的 ID。

对于任何其他对象类型，返回零。
optional_clr_trigger_objid int 仅在 CLR DML 触发器的情况下填充。 存储在 sys.objects 中的对象 ID。

对于任何其他对象类型，返回零。
parent_plan_handle varbinary(64) 始终为 NULL。
is_azure_user_plan tinyint 1 用于从用户发起的会话在Azure SQL 数据库中执行的查询。

0 用于从最终用户未启动的会话执行的查询，但对于从 Azure 基础结构中运行的应用程序，这些应用程序出于收集遥测或执行管理任务的其他目的发出查询。 对于查询消耗的资源，客户不收取is_azure_user_plan = 0 的费用。

仅Azure SQL 数据库。
inuse_exec_context int 使用查询计划并且当前正在执行的批处理的数目。
free_exec_context int 当前未使用的查询计划的缓存执行上下文数目。
hits_exec_context int 从计划缓存获取执行上下文并重用从而节省 SQL 语句编译开销的次数。 该值是目前所有批处理执行的聚合。
misses_exec_context int 无法在计划缓存中找到执行上下文而导致为批处理执行创建新的执行上下文的次数。
removed_exec_context int 由于缓存计划的内存压力而删除的执行上下文数目。
inuse_cursors int 包含一个或多个使用缓存计划的游标的当前正在执行的批数。
free_cursors int 缓存计划的空闲或可用游标数。
hits_cursors int 从缓存计划获得不活动游标并重用的次数。 该值是目前所有批处理执行的聚合。
misses_cursors int 无法在缓存中找到不活动游标的次数。
removed_cursors int 由于缓存计划的内存压力而删除的游标数。
sql_handle varbinary(64) 批处理的 SQL 句柄。

权限

在 SQL Server 上，需要 VIEW SERVER STATE 权限。

在Azure SQL 数据库基本、S0 和 S1 服务目标以及弹性池中的数据库，需要服务器管理员帐户或 Microsoft Entra 管理员帐户。 在所有其他SQL 数据库服务目标上，VIEW DATABASE STATE数据库中需要权限。

SQL Server 2022 及更高版本的权限

要求对服务器具有 VIEW SERVER PERFORMANCE STATE 权限。

注解

Set 选项

同一已编译计划的副本可能只因set_options列中的值而异。 这说明不同的连接为相同的查询使用不同的 SET 选项集。 通常不希望使用不同的选项集，因为这可能导致额外的编译工作、减少计划重用并由于缓存中的多个计划副本而导致计划缓存膨胀。

计算 Set 选项

若要将set_options中返回的值转换为编译计划的选项，请从set_options值中减去值，从最大可能值开始，直到达到 0。 所减去的每个值对应于查询计划中所用的一个选项。 例如，如果set_options中的值为 251，则计划编译的选项为ANSI_NULL_DFLT_ON（128）、QUOTED_IDENTIFIER（64）、ANSI_NULLS（32）、ANSI_WARNINGS（16）、CONCAT_NULL_YIELDS_NULL（8）、并行计划（2）和ANSI_PADDING（1）。

选项 值
ANSI_PADDING 1
ParallelPlan

指示计划并行度选项已更改。		 2
FORCEPLAN 4
CONCAT_NULL_YIELDS_NULL 8
ANSI_WARNINGS 16
ANSI_NULLS 32
QUOTED_IDENTIFIER 64
ANSI_NULL_DFLT_ON 128
ANSI_NULL_DFLT_OFF 256
NoBrowseTable

指示计划不使用工作表实现 FOR BROWSE 操作。		 512
TriggerOneRow

指示计划包含针对 AFTER 触发器 delta 表的单行优化。		 1024
ResyncQuery

指示查询由内部系统存储过程提交。		 2048
ARITH_ABORT 4096
NUMERIC_ROUNDABORT 8192
DATEFIRST 16384
DATEFORMAT 32768
LanguageID 65536
UPON

指示编译计划时数据库选项 PARAMETERIZATION 设置为 FORCED。		 131072
ROWCOUNT 适用于： SQL Server 2012 （11.x） 及更高版本

262144

游标

不活动游标缓存在编译的计划中，以便游标的并发用户可以重用存储游标所使用的内存。 例如，假设某批处理声明并使用了一个游标，但未释放该游标。 如果有两个用户执行同一个批处理，将有两个活动游标。 游标释放（可能在不同批处理中）后，用于存储该游标的内存就会缓存但不释放。 此不活动游标列表保存在编译的计划中。 下次用户执行该批处理时，缓存的游标内存将重用并相应地初始化为活动游标。

计算游标选项

若要将required_cursor_options中返回的值转换为编译计划的选项 acceptable_cursor_options，请从列值中减去值，从可能的值开始，直到达到 0。 所减去的每个值对应于查询计划中所用的一个游标选项。

选项 值
无 0
INSENSITIVE 1
SCROLL 2
READ ONLY 4
FOR UPDATE 8
本地 16
GLOBAL 32
FORWARD_ONLY 64
KEYSET 128
DYNAMIC 256
SCROLL_LOCKS 512
OPTIMISTIC 1024
STATIC 2048
FAST_FORWARD 4096
IN PLACE 8192
FOR select_statement 16384

示例

A. 返回特定计划的属性

下例将返回指定计划的所有计划属性。 将首先查询 sys.dm_exec_cached_plans 动态管理视图以获得指定计划的计划句柄。 在第二次查询中，用第一次查询中的计划句柄值替换 <plan_handle>。

SELECT plan_handle, refcounts, usecounts, size_in_bytes, cacheobjtype, objtype   
FROM sys.dm_exec_cached_plans;  
GO  
SELECT attribute, [value], is_cache_key  
FROM sys.dm_exec_plan_attributes(<plan_handle>);  
GO

B. 返回编译计划的 SET 选项和缓存计划的 SQL 句柄

下例将返回代表编译每个计划时所用选项的值。 此外，还将返回所有缓存计划的 SQL 句柄。

SELECT plan_handle, pvt.set_options, pvt.sql_handle  
FROM (  
    SELECT plan_handle, epa.attribute, epa.value   
    FROM sys.dm_exec_cached_plans   
        OUTER APPLY sys.dm_exec_plan_attributes(plan_handle) AS epa  
    WHERE cacheobjtype = 'Compiled Plan') AS ecpa   
PIVOT (MAX(ecpa.value) FOR ecpa.attribute IN ("set_options", "sql_handle")) AS pvt;  
GO

另请参阅

动态管理视图和函数 (Transact-SQL)
与执行有关的动态管理视图和函数 (Transact-SQL)
sys.dm_exec_cached_plans (Transact-SQL)
sys.databases (Transact-SQL)
sys.objects (Transact-SQL)