SET SHOWPLAN_ALL (Transact-SQL)
Приводит к тому, что Microsoft SQL Server не выполняет инструкции языка Transact-SQL. Вместо этого SQL Server возвращает подробные сведения о выполнении инструкций и предоставляет оценку требований к ресурсам для выполнения этих инструкций.
.gif "Значок ссылки на раздел")
Соглашения о синтаксисе в 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 совершает для выполнения каждой инструкции. Каждой инструкции, отраженной в выходных данных, соответствует одна строка с текстом инструкции, за которой следуют несколько строк с подробными описаниями шагов выполнения. В таблице ниже приведены столбцы, содержащиеся в выводе.
| Имя столбца | Описание |
|---|---|
StmtText |
В строках, не относящихся к типу PLAN_ROW, этот столбец содержит текст инструкции Transact-SQL. В строках типа PLAN_ROW этот столбец содержит описание операции. Этот столбец содержит физический оператор и может также, при необходимости, содержать логический оператор. За этим столбцом может идти описание, зависящее от физического оператора. Дополнительные сведения см. в разделе Справочник по логическим и физическим операторам. |
StmtId |
Номер инструкции в текущем пакете. |
NodeId |
Идентификатор узла в текущем запросе. |
Parent |
Идентификатор узла родительского шага. |
PhysicalOp |
Физическая реализация алгоритма для узла. Только для строк типа PLAN_ROWS. |
LogicalOp |
Оператор реляционной алгебры, которому соответствует данный узел. Только для строк типа PLAN_ROWS. |
Argument |
Предоставляет дополнительные сведения о выполняемой операции. Содержимое этого столбца зависит от физического оператора. |
DefinedValues |
Содержит разделенный запятыми список значений, вводимых данным оператором. Эти значения могут представлять собой вычисляемые выражения, присутствующие в текущем запросе (например, в списке SELECT или предложении WHERE), или внутренние значения, введенные обработчиком запросов для выполнения данного запроса. Затем на эти определенные значения можно ссылаться из других частей запроса. Только для строк типа PLAN_ROWS. |
EstimateRows |
Предполагаемое количество строк вывода от данного оператора. Только для строк типа PLAN_ROWS. |
EstimateIO |
Предполагаемый объем операций ввода-вывода для данного оператора. Только для строк типа PLAN_ROWS. |
EstimateCPU |
Предполагаемая загрузка ЦП для данного оператора. Только для строк типа PLAN_ROWS. |
AvgRowSize |
Предполагаемый средний размер строк (в байтах), передаваемых через данный оператор. |
TotalSubtreeCost |
Предполагаемая (совокупная) стоимость данной операции и всех дочерних операций. |
OutputList |
Содержит разделенный запятыми список столбцов, проецируемых текущей операцией. |
Warnings |
Содержит разделенный запятыми список предупреждений, относящихся к текущей операции. Предупреждения могут содержать строку «NO STATS:()» со списком столбцов. Это означает, что оптимизатор запросов попытался принять решение на основе статистики для данного столбца, но она отсутствовала. Поэтому оптимизатору пришлось принимать решение самостоятельно, что могло привести к выбору неэффективного плана запроса. Дополнительные сведения о создании или обновлении статистик столбцов (которые помогают оптимизатору запросов выбирать более эффективный план запроса) см. в разделе UPDATE STATISTICS. В этом столбце также может содержаться строка «MISSING JOIN PREDICATE», означающая, что производится соединение (с использованием таблиц) без предиката соединения. Случайное удаление предиката соединения может привести к созданию запроса, чье выполнение займет значительно больше времени, чем предполагалось, и вернет большой результирующий набор. При появлении этого предупреждения убедитесь, что предикат соединения не был удален случайно. |
Type |
Тип узла. Для родительского узла каждого запроса это тип инструкции Transact-SQL (например, SELECT, INSERT, EXECUTE и т. д.). Для дочерних узлов, соответствующих планам выполнения, это тип PLAN_ROW. |
Parallel |
0 = Оператор выполняется не в параллельном режиме. 1 = Оператор выполняется в параллельном режиме. |
EstimateExecutions |
Предполагаемое количество вызовов данного оператора при выполнении текущего запроса. |
Разрешения
Чтобы использовать инструкцию SET SHOWPLAN_ALL, должны быть необходимые разрешения на выполнение инструкций, для которых запускается инструкция SET SHOWPLAN_ALL, и разрешение SHOWPLAN на доступ ко всем базам данных, содержащим используемые в запросах объекты.
Чтобы создать план визуализации для хранимых процедур (stored_procedure), использующих инструкции SELECT, INSERT, UPDATE, DELETE, EXEC, и пользовательских функций (user_defined_function), использующих инструкцию EXEC, необходимо:
- Обладать необходимыми разрешениями для выполнения инструкций языка 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 — имя индекса.
Второй запрос использует оператор LIKE в предложении WHERE. Это приводит к использованию SQL Server просмотра кластеризованного индекса и поиску данных, удовлетворяющих условию в предложении WHERE. В столбец LogicalOp записывается значение «Просмотр кластеризованного индекса», имя индекса появляется в столбце Argument, также в столбец LogicalOp записывается значение «Фильтр», а в соответствующем столбце Argument появляется условие предложения WHERE.
Значения в столбцах EstimateRows и TotalSubtreeCost меньше для первого запроса с использованием индекса. Это означает, что он обрабатывается гораздо быстрее и требует меньших ресурсов, чем запрос без использования индекса.
USE AdventureWorks;
GO
SET SHOWPLAN_ALL ON;
GO
-- First query.
SELECT EmployeeID
FROM HumanResources.Employee
WHERE NationalIDNumber = '509647174';
GO
-- Second query.
SELECT EmployeeID, EmergencyContactID
FROM HumanResources.Employee
WHERE EmergencyContactID LIKE '1%';
GO
SET SHOWPLAN_ALL OFF;
GO
См. также
Справочник
SET (Transact-SQL)
SET SHOWPLAN_TEXT (Transact-SQL)
SET SHOWPLAN_XML (Transact-SQL)
Другие ресурсы
Анализ запроса
Инструкции Transact-SQL, создающие инструкции Showplan
Отображение планов выполнения с помощью параметров Showplan инструкции SET (Transact-SQL)