SET SHOWPLAN_ALL (Transact-SQL)

Синтаксис

SET SHOWPLAN_ALL { ON | OFF }

Замечания

Задание параметра инструкции SET SHOWPLAN_ALL происходит во время выполнения или запуска инструкций, а не во время синтаксического анализа.

Если выполнена команда SET SHOWPLAN_ALL ON, SQL Server возвращает сведения о выполнении каждой инструкции Transact-SQL, не выполняя их на самом деле. Если параметр принял значение ON, данные обо всех последующих инструкциях Transact-SQL возвращаются до тех пор, пока параметру не будет присвоено значение OFF. Например, если инструкция CREATE TABLE была выполнена при выполненной команде SET SHOWPLAN_ALL ON, SQL Server будет возвращать сообщение об ошибке для всех последующих инструкций SELECT, в которых используется данная таблица, уведомляя пользователей о том, что она не существует. Следовательно, последующие ссылки на эту таблицу не действуют. Когда этому параметру присвоено значение OFF, SQL Server выполняет инструкции, не формируя отчеты.

Инструкция SET SHOWPLAN_ALL предназначена для использования приложениями, которые могут обрабатывать ее вывод. Для получения удобочитаемого вывода в приложениях Microsoft Win32, запускаемых из командной строки, таких как программа osql, используйте инструкцию SET SHOWPLAN_TEXT.

Инструкции SET SHOWPLAN_TEXT и SET SHOWPLAN_ALL не могут использоваться внутри хранимой процедуры; они должны быть единственными инструкциями в пакете.

Инструкция SET SHOWPLAN_ALL возвращает информацию в виде набора строк, формирующих дерево шагов, которые обработчик запросов SQL Server совершает для выполнения каждой инструкции. Каждой инструкции, отраженной в выходных данных, соответствует одна строка с текстом инструкции, за которой следуют несколько строк с подробными описаниями шагов выполнения. В таблице ниже приведены столбцы, содержащиеся в выводе.

*Значения показателей основаны на внутреннем измерении времени, а не на показаниях настенных часов. Они используются для определения относительной стоимости плана в сравнении с другими планами.

Разрешения

Чтобы использовать инструкцию SET SHOWPLAN_ALL, должны быть необходимые разрешения на выполнение инструкций, для которых запускается инструкция SET SHOWPLAN_ALL, и разрешение SHOWPLAN на доступ ко всем базам данных, содержащим используемые в запросах объекты.

Чтобы инструкции SELECT, INSERT, UPDATE, DELETE, EXEC stored_procedure и EXEC user_defined_function создавали планы Showplan, пользователь должен:

• обладать необходимыми разрешениями на выполнение инструкций Transact-SQL;

• обладать разрешением SHOWPLAN для всех баз данных, содержащих объекты (такие как таблицы, представления и т. д.), на которые ссылаются инструкции Transact-SQL.

Для всех остальных инструкций (например DDL, USE database_name, SET, DECLARE, динамического SQL и т. д.) требуются лишь соответствующие разрешения на выполнение инструкций Transact-SQL.

Дополнительные сведения см. в разделах Безопасность инструкции Showplan и Разрешение SHOWPLAN и пакеты Transact-SQL.

Примеры

Следующие две инструкции используют настройки SET SHOWPLAN_ALL для иллюстрации того, как SQL Server анализирует и оптимизирует использование индексов в запросах.

В предложении WHERE первого запроса оператор сравнения «равно» (=) применяется к индексированному столбцу. При этом в столбец LogicalOp записывается значение «Поиск в кластеризованном индексе», а в столбец Argument — имя индекса.

Во втором запросе в предложении WHERE используется оператор LIKE. Это приводит к использованию SQL Server просмотра кластеризованного индекса и поиску данных, удовлетворяющих условию в предложении WHERE. В столбец LogicalOp записывается значение «Просмотр кластеризованного индекса», имя индекса появляется в столбце Argument, также в столбец LogicalOp записывается значение «Фильтр», а в соответствующем столбце Argument появляется условие предложения WHERE.

Значения в столбцах EstimateRows и TotalSubtreeCost меньше для первого запроса с использованием индекса. Это означает, что он обрабатывается гораздо быстрее и требует меньших ресурсов, чем запрос без использования индекса.

USE AdventureWorks2008R2;
GO
SET SHOWPLAN_ALL ON;
GO
-- First query.
SELECT BusinessEntityID 
FROM HumanResources.Employee
WHERE NationalIDNumber = '509647174';
GO
-- Second query.
SELECT BusinessEntityID, EmergencyContactID 
FROM HumanResources.Employee
WHERE EmergencyContactID LIKE '1%';
GO
SET SHOWPLAN_ALL OFF;
GO

См. также

Справочник

Основные понятия

Другие ресурсы