使 Microsoft® SQL Server™ 不执行 Transact-SQL 语句。相反,SQL Server 返回有关如何执行语句的详细信息。
SET SHOWPLAN_TEXT { ON | OFF }
SET SHOWPLAN_TEXT 的设置是在执行或运行时设置,而不是在分析时设置。
当 SET SHOWPLAN_TEXT 为 ON 时,SQL Server 返回各个 Transact-SQL 语句的执行信息但不执行语句。将该选项设置为 ON 后,将返回有关所有后续 Transact-SQL 语句的信息,直到将该选项设置为 OFF 为止。例如,如果在 SET SHOWPLAN_TEXT 为 ON 时执行 CREATE TABLE 语句,SQL Server 将从涉及同一个表的后续 SELECT 语句返回错误信息;指定的表不存在。因此,对该表的后续引用将失败。当 SET SHOWPLAN_TEXT 为 OFF 时,SQL Server 执行语句但不生成报表。
SET SHOWPLAN_TEXT 用于返回可由 Microsoft MS-DOS® 应用程序(如 osql 实用工具)读取的输出。SET SHOWPLAN_ALL 返回更详细的输出供处理输出的程序使用。
在存储过程内不能指定 SET SHOWPLAN_TEXT 和 SET SHOWPLAN_ALL,它们必须是批处理中的语句。
SET SHOWPLAN_TEXT 将信息作为行集返回,行集形成一个层次结构树,用以表示 SQL Server 查询处理器在执行各语句时所采取的步骤。输出中反映的每个语句都包含一个含有语句文本的行,后面跟有几个含有执行步骤详细信息的行。下表显示输出中包含的列。
列名 | 描述 |
---|---|
StmtText | 对于不是 PLAN_ROW 类型的行,该列包含 Transact-SQL 语句的文本。对于 PLAN_ROW 类型的行,该列包含对操作的描述。该列包含物理运算符,也可以选择包含逻辑运算符。该列的后面还可以跟有由物理运算符决定的描述。有关物理运算符的更多信息,请参见 SET SHOWPLAN_ALL 中的 Argument 列。 |
有关可以在显示计划输出中看到的物理和逻辑运算符的更多信息,请参见逻辑运算符和物理运算符。
SET SHOWPLAN_TEXT 权限默认授予所有用户。
下例显示 SQL Server 在处理语句时如何使用索引。
下面是使用索引的查询:
SET SHOWPLAN_TEXT ON
GO
USE pubs
SELECT *
FROM roysched
WHERE title_id = 'PS1372'
GO
SET SHOWPLAN_TEXT OFF
GO
下面是结果集:
StmtText
------------------------------------------------------
USE pubs
SELECT *
FROM roysched
WHERE title_id = 'PS1372'
(2 row(s) affected)
StmtText
------------------------------------------------------------------------
|--Bookmark Lookup(BOOKMARK:([Bmk1000]), OBJECT:([pubs].[dbo].[roysched]))
|--Index Seek(OBJECT:([pubs].[dbo].[roysched].[titleidind]), SEEK:([roysched].[title_id]='PS1372') ORDERED)
(2 row(s) affected)
下面是不使用索引的查询:
SET SHOWPLAN_TEXT ON
GO
USE pubs
SELECT *
FROM roysched
WHERE lorange < 5000
GO
SET SHOWPLAN_TEXT OFF
GO
下面是结果集:
StmtText
-------------------------------------------------
USE pubs
SELECT *
FROM roysched
WHERE lorange < 5000
(2 row(s) affected)
StmtText
------------------------------------------------------------------------
|--Table Scan(OBJECT:([pubs].[dbo].[roysched]), WHERE:([roysched].[lorange]<5000))
(1 row(s) affected)