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 | 指示此属性是否用作计划的缓存查找密钥的一部分。 |
在上表中， 属性 可以具有以下值：
| 属性 | 数据类型 | 描述 |
|---|---|---|
| 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_replication_specific | int | 表示从中编译此计划的会话是使用未记录的连接属性连接到 SQL Server 实例的会话，该属性允许服务器将会话标识为由复制组件创建的会话，以便根据此类复制组件的预期更改服务器某些功能方面的行为。 |
| 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)