通过

  • 项目

SET SHOWPLAN_XML (Transact-SQL)

使 SQL Server 不执行 Transact-SQL 语句。SQL Server 返回有关如何以定义好的 XML 文档格式执行上述语句的详细信息。

主题链接图标Transact-SQL 语法约定

语法

SET SHOWPLAN_XML { ON | OFF }

注释

SET SHOWPLAN_XML 的设置是在执行或运行时设置的，而不是在分析时设置的。

如果 SET SHOWPLAN_XML 为 ON，则 SQL Server 将在不执行语句的情况下返回每个语句的执行计划信息。不会执行 Transact-SQL 语句。将该选项设置为 ON 以后，将返回有关所有后续 Transact-SQL 语句的执行计划信息，直到将该选项设置为 OFF 为止。例如，如果在 SET SHOWPLAN_XML 为 ON 时执行 CREATE TABLE 语句，则 SQL Server 将从涉及同一个表的后续 SELECT 语句返回错误信息：指定的表不存在。因此，对此表的后续引用将失败。如果 SET SHOWPLAN_XML 为 OFF，则 SQL Server 将执行语句，但不生成报表。

SET SHOWPLAN_XML 可以为应用程序（如sqlcmd 实用工具）返回 nvarchar(max) 类型的输出，其中的 XML 输出随后将由其他工具用来显示和处理查询计划信息。

注意注意

动态管理视图 sys.dm_exec_query_plan 将使用 xml 数据类型返回与 SET SHOWPLAN XML 相同的信息。该信息是从 sys.dm_exec_query_plan 的 query_plan 列返回的。有关详细信息，请参阅 sys.dm_exec_query_plan。

不能在存储过程内部指定 SET SHOWPLAN_XML。该语句必须是批处理中的唯一语句。

SET SHOWPLAN_XML 将返回一组 XML 文档信息。SET SHOWPLAN_XML ON 语句之后的每个批处理都将在单个文档输出中得到反映。每个文档都包含批处理中语句的文本，后跟执行步骤的详细信息。该文档可以显示估计的开销、行数、访问的索引数、执行的运算符的类型、联接次序以及有关执行计划的详细信息。

在安装了 Microsoft SQL Server 的计算机的本地目录上安装，将复制包含 XML 架构的文档（该架构用于来自 SET SHOWPLAN_XML 的 XML 输出）。它可以在包含 SQL Server 安装文件的驱动器上找到，具体位置如下：

\Microsoft SQL Server\90\Tools\Binn\schemas\sqlserver\2004\07\showplan\showplanxml.xsd

显示计划架构也可从此网站中找到。

注意注意

如果在 SQL Server Management Studio 中选定了“包括实际的执行计划”，则该 SET 选项不会生成 XML 显示计划输出。请在使用该 SET 选项之前清除“包括实际的执行计划”按钮。

权限

必须对执行 SET SHOWPLAN_XML 的语句具有足够的执行权限，必须对包含被引用对象的所有数据库具有 SHOWPLAN 权限。

对于 SELECT、INSERT、UPDATE、DELETE、EXEC stored_procedure 和 EXEC user_defined_function 语句，若要生成显示计划，用户必须：

  • 具有执行 Transact-SQL 语句的相应权限。

  • 对于包含 Transact-SQL 语句引用的对象（如表、视图等）的所有数据库，具有 SHOWPLAN 权限。

对于所有其他语句，如 DDL、USE database_name、SET、DECLARE、动态 SQL 等，只需要具有执行 Transact-SQL 语句的相应权限。

有关详细信息，请参阅显示计划安全性和 SHOWPLAN 权限和 Transact-SQL 批处理。

示例

下面两个语句使用了 SET SHOWPLAN_XML 设置，以显示 SQL Server 在查询中分析和优化索引的方法。

第一个查询在 WHERE 子句中使用针对索引列的等于比较运算符 (=)。第二个查询在 WHERE 子句中使用 LIKE 运算符。这将强制 SQL Server 使用聚集索引扫描并查找满足 WHERE 子句条件的数据。第一个索引查询的 EstimateRows 和 EstimatedTotalSubtreeCost 属性中的值较小，这表示与非索引查询相比，该查询的处理速度快得多且使用更少的资源。

USE AdventureWorks;
GO
SET SHOWPLAN_XML ON;
GO
-- First query.
SELECT EmployeeID 
FROM HumanResources.Employee
WHERE NationalIDNumber = '509647174';
GO
-- Second query.
SELECT EmployeeID, ContactID 
FROM HumanResources.Employee
WHERE Title LIKE 'Production%';
GO
SET SHOWPLAN_XML OFF;