SET STATISTICS XML(Transact-SQL)SET STATISTICS XML (Transact-SQL)

이 항목은 다음에 적용됩니다.예SQL Server(2008부터)예Azure SQL Database아니요Azure SQL Data Warehouse 아니요병렬 데이터 웨어하우스 THIS TOPIC APPLIES TO:yesSQL Server (starting with 2008)yesAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse

Microsoft SQL ServerSQL Server에서 Transact-SQLTransact-SQL 문을 실행하고 해당 문이 실행된 방법에 대한 자세한 정보를 잘 정의된 XML 문서 형식으로 생성하도록 합니다.Causes Microsoft SQL ServerSQL Server to execute Transact-SQLTransact-SQL statements and generate detailed information about how the statements were executed in the form of a well-defined XML document.

항목 링크 아이콘 Transact-SQL 구문 규칙Topic link icon Transact-SQL Syntax Conventions

구문Syntax


SET STATISTICS XML { ON | OFF }  

주의Remarks

SET STATISTICS XML 옵션은 실행 시 또는 런타임에 설정되며, 구문 분석 시에는 설정되지 않습니다.The setting of SET STATISTICS XML is set at execute or run time and not at parse time.

SET STATISTICS XML을 ON으로 설정하면 SQL ServerSQL Server는 실행된 각 문에 대한 실행 정보를 반환합니다.When SET STATISTICS XML is ON, SQL ServerSQL Server returns execution information for each statement after executing it. 이 옵션을 ON으로 설정하면 다시 OFF로 설정할 때까지 이후의 모든 Transact-SQLTransact-SQL 문에 대한 정보가 반환됩니다.After this option is set ON, information about all subsequent Transact-SQLTransact-SQL statements is returned until the option is set to OFF. SET STATISTICS XML이 일괄 처리에서 유일한 문일 필요는 없습니다.Note that SET STATISTICS XML need not be the only statement in a batch.

SET STATISTICS XML로 출력을 반환 합니다. nvarchar (max) 응용 프로그램의 경우와 같은 sqlcmd 여기서 XML 출력은 이후에 사용 되는 다른 도구에서 표시 하 고 쿼리 계획을 처리할 유틸리티 정보입니다.SET STATISTICS XML returns output as nvarchar(max) for applications, such as the sqlcmd utility, where the XML output is subsequently used by other tools to display and process the query plan information.

SET STATISTICS XML은 XML 문서 집합으로 정보를 반환합니다.SET STATISTICS XML returns information as a set of XML documents. SET STATISTICS XML ON 문 뒤에 오는 각 문은 단일 문서로 출력에 반영됩니다.Each statement after the SET STATISTICS XML ON statement is reflected in the output by a single document. 각 문서에는 문의 텍스트가 먼저 오고 그 뒤에 실행 단계에 대한 세부 정보가 옵니다.Each document contains the text of the statement, followed by the details of the execution steps. 출력에서는 비용, 액세스한 인덱스, 수행한 연산 유형 같은 런타임 정보, 조인 순서, 물리적 연산이 수행된 횟수, 각 물리 연산자가 생성한 행 수 등을 보여 줍니다.The output shows run-time information such as the costs, accessed indexes, and types of operations performed, join order, the number of times a physical operation is performed, the number of rows each physical operator produced, and more.

SET STATISTICS XML에 의한 XML 출력의 XML 스키마가 포함된 문서는 설치하는 동안 Microsoft SQL ServerSQL Server가 설치되어 있는 컴퓨터의 로컬 디렉터리에 복사됩니다.The document containing the XML schema for the XML output by SET STATISTICS XML is copied during setup to a local directory on the computer on which Microsoft SQL ServerSQL Server is installed. SQL ServerSQL Server 설치 파일이 포함된 다음 드라이브에 있습니다.It can be found on the drive containing the SQL ServerSQL Server installation files, at:

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

실행 계획 스키마에서 찾을 수 또한 이 웹 사이트합니다.The Showplan Schema can also be found at this Web site.

SET STATISTICS PROFILE과 SET STATISTICS XML은 서로 유사합니다.SET STATISTICS PROFILE and SET STATISTICS XML are counterparts of each other. 전자는 텍스트 출력을 생성하고 후자는 XML 출력을 생성합니다.The former produces textual output; the latter produces XML output. 이후 버전의 SQL ServerSQL Server에서는 새 쿼리 실행 계획 정보가 SET STATISTICS PROFILE 문이 아니라 SET STATISTICS XML 문을 통해서만 표시됩니다.In future versions of SQL ServerSQL Server, new query execution plan information will only be displayed through the SET STATISTICS XML statement, not the SET STATISTICS PROFILE statement.

참고

경우 실제 실행 계획 포함 에서 선택한 SQL Server Management StudioSQL Server Management Studio,이 SET 옵션은 XML 실행 계획 출력을 생성 하지 않습니다.If Include Actual Execution Plan is selected in SQL Server Management StudioSQL Server Management Studio, this SET option does not produce XML Showplan output. 지우기는 실제 실행 계획 포함 단추 전에이 사용 하 여 옵션을 설정 합니다.Clear the Include Actual Execution Plan button before using this SET option.

PermissionsPermissions

SET STATISTICS XML을 사용하여 출력을 보려면 다음 권한이 있어야 합니다.To use SET STATISTICS XML and view the output, users must have the following permissions:

  • Transact-SQLTransact-SQL 문을 실행할 수 있는 적절한 권한Appropriate permissions to execute the Transact-SQLTransact-SQL statements.

  • Transact-SQLTransact-SQL 문이 참조하는 개체가 포함된 모든 데이터베이스에 대한 SHOWPLAN 권한SHOWPLAN permission on all databases containing objects that are referenced by the Transact-SQLTransact-SQL statements.

    STATISTICS XML 결과 집합을 생성하지 않는 Transact-SQLTransact-SQL 문의 경우 Transact-SQLTransact-SQL 문을 실행할 수 있는 적절한 권한만 있으면 됩니다.For Transact-SQLTransact-SQL statements that do not produce STATISTICS XML result sets, only the appropriate permissions to execute the Transact-SQLTransact-SQL statements are required. STATISTICS XML 결과 집합을 생성하는 Transact-SQLTransact-SQL 문의 경우에는 Transact-SQLTransact-SQL 문 실행 권한과 SHOWPLAN 권한이 모두 있어야 합니다. 그렇지 않으면 Transact-SQLTransact-SQL 문 실행이 중단되고 실행 계획 정보도 생성되지 않습니다.For Transact-SQLTransact-SQL statements that do produce STATISTICS XML result sets, checks for both the Transact-SQLTransact-SQL statement execution permission and the SHOWPLAN permission must succeed, or the Transact-SQLTransact-SQL statement execution is aborted and no Showplan information is generated.

Examples

다음 두 문에서는 SET STATISTICS XML 설정을 사용하여 SQL ServerSQL Server가 쿼리에서 인덱스 사용을 분석하고 최적화하는 방법을 보여 줍니다.The two statements that follow use the SET STATISTICS XML settings to show the way SQL ServerSQL Server analyzes and optimizes the use of indexes in queries. 첫 번째 쿼리에서는 인덱싱된 열의 WHERE 절에 Equals(=) 비교 연산자를 사용합니다.The first query uses the Equals (=) comparison operator in the WHERE clause on an indexed column. 두 번째 쿼리에서는 WHERE 절에 LIKE 연산자를 사용합니다.The second query uses the LIKE operator in the WHERE clause. 이렇게 하면 SQL ServerSQL Server가 클러스터형 인덱스 검색을 사용하여 WHERE 절 조건을 충족하는 데이터를 찾을 수 있습니다.This forces SQL ServerSQL Server to use a clustered index scan to find the data that satisfies the WHERE clause condition. 값은 EstimateRowsEstimatedTotalSubtreeCost 특성은 작은 처음 인덱싱된 쿼리의 훨씬 빨리 처리 보다 더 적은 리소스를 사용 하는 인덱싱되지 않은 쿼리에 합니다.The values in the EstimateRows and the EstimatedTotalSubtreeCost attributes are smaller for the first indexed query indicating that it was processed much faster and used fewer resources than the nonindexed query.

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

관련 항목:See Also

SET SHOWPLAN_XML(Transact-SQL) SET SHOWPLAN_XML (Transact-SQL)
sqlcmd 유틸리티sqlcmd Utility