SET STATISTICS XML (Transact-SQL)

Изменения: 5 декабря 2005 г.

При установке этого параметра Microsoft SQL Server выполняет инструкции Transact-SQL и формирует подробные сведения о выполнении инструкций в форме четко определенного XML-документа.

Соглашения о синтаксисе в Transact-SQL

Синтаксис

SET STATISTICS XML { ON | OFF }

Замечания

Настройка инструкции SET STATISTICS XML устанавливается во время выполнения или запуска, а не во время синтаксического анализа.

Если выполнена инструкция SET STATISTICS XML ON, SQL Server возвращает сведения о выполнении каждого оператора после его выполнения. После присвоения этому параметру значения ON сведения обо всех последующих инструкциях Transact-SQL возвращаются до тех пор, пока параметру не будет присвоено значение OFF. Учтите, что SET STATISTICS XML может быть не единственной инструкцией в пакете.

Инструкция SET STATISTICS XML возвращает результаты в формате nvarchar(max) для приложений, например программы sqlcmd, а вывод в формате XML используется далее другими средствами для отображения и обработки сведений о плане запроса.

SET STATISTICS XML возвращает данные в виде набора документов XML. Каждой инструкции после выполнения SET STATISTICS XML ON соответствует один документ на выходе. Каждый документ содержит текст инструкции, за которым следуют подробности об этапах выполнения команды. Вывод отображает данные времени выполнения, такие как стоимость, индексы, к которым производился доступ, тип выполненных операций, порядок соединения, количество выполнения физических операций, количество строк, созданных каждым физическим оператором и т.д.

Документ, содержащий XML-схему для вывода XML-данных, формируемых инструкцией SET STATISTICS XML, копируется во время установки в локальный каталог на компьютере, на котором установлен Microsoft SQL Server 2005. Ее можно найти на диске, содержащем файлы установки SQL Server:

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

Схему для инструкции SET SHOWPLAN также можно найти на следующем веб-узле.

Инструкции SET STATISTICS PROFILE и SET STATISTICS XML являются дубликатами друг друга. Первая выводит данные в текстовом формате, а вторая выводит данные в формате XML. В будущих версиях SQL Server сведения о плане выполнения новых запросов будут доступны лишь посредством инструкции SET STATISTICS XML, но не посредством инструкции SET STATISTICS PROFILE.

Примечание.
Если в среде SQL Server Management Studio установлен параметр Включить действительный план выполнения, то инструкция SET STATISTICS XML не будет порождать XML-данных в выводе, обеспечиваемом инструкцией SET SHOWPLAN. Снимите флажок Включить действительный план выполнения перед использованием инструкции SET STATISTICS XML.

Разрешения

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

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

Для инструкций Transact-SQL, не производящих результирующие наборы STATISTICS XML, требуются только соответствующие разрешения на выполнение инструкций Transact-SQL. Для инструкций Transact-SQL, не создающих результирующие наборы STATISTICS XML, должны успешно завершиться как проверки разрешений на выполнение инструкции Transact-SQL, так и проверки разрешений SHOWPLAN, иначе выполнение инструкции Transact-SQL прерывается, и сведения о разрешении SHOWPLAN не формируются.

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

Примеры

Две последующие инструкции используют настройки инструкции SET STATISTICS XML, чтобы продемонстрировать анализ и оптимизацию использования индексов в запросах в SQL Server. В первом запросе используется оператор сравнения (=) в предложении WHERE для индексируемого столбца. Во втором запросе в предложении WHERE используется оператор LIKE. При этом SQL Server принудительно использует просмотр кластеризованного индекса, чтобы найти данные, соответствующие условию в предложении WHERE. Значения атрибутов EstimateRows и EstimatedTotalSubtreeCost меньше у первого, индексируемого запроса, из чего следует, что первый запрос выполнился намного быстрее и потребовал меньше ресурсов, чем неиндексируемый запрос.

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

См. также

Справочник

SET SHOWPLAN_XML (Transact-SQL)

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

Программа sqlcmd
Анализ запроса
Инструкции Transact-SQL, создающие инструкции Showplan
Отображение планов выполнения с помощью параметров Showplan инструкции SET (Transact-SQL)

Справка и поддержка

Получение помощи по SQL Server 2005

Журнал изменений

Версия	Журнал
5 декабря 2005 г.	Измененное содержимое: Изменено расположение установки XML-схемы инструкции Showplan.