SET SET STATISTICS XML (Transact-SQL)

Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do AzureBanco de dados SQL no Microsoft Fabric

Faz com que o Microsoft SQL Server execute instruções Transact-SQL e gere informações detalhadas sobre como as instruções foram executadas na forma de um documento XML bem-definido.

Convenções de sintaxe de Transact-SQL

Sintaxe

  
SET STATISTICS XML { ON | OFF }  

Comentários

A configuração de SETSET STATISTICS XML é definida em tempo de execução ou execução e não em tempo de análise sintática.

Quando SETSET STATISTICS XML está LIGADO, o SQL Server retorna informações de execução para cada instrução após sua execução. Depois que essa opção estiver definida como ON, as informações sobre todas as instruções Transact-SQL subsequentes serão retornadas até que a opção seja definida como OFF. Note que SETSET STATISTICS XML não precisa ser a única afirmação em um lote.

SET SET STATISTICS XML retorna a saída como nvarchar(max) para aplicações, como a utilidade SQLCMD , onde a saída XML é posteriormente usada por outras ferramentas para exibir e processar as informações do plano de consulta.

SET SET STATISTICS XML retorna informações como um conjunto de documentos XML. Cada instrução após a SETSET STATISTICS XML instrução ON é refletida na saída por um único documento. Cada documento conterá o texto das instruções, seguido dos detalhes das etapas da execução. A saída mostra informações de tempo de execução como os custos, índices acessados e tipos de operações executadas, ordem de junção, o número de horas de execução de uma operação física, o número de linhas que cada operador físico produziu, e mais.

O documento contendo o esquema XML para a saída XML por SETSET STATISTICS XML é copiado durante a configuração para um diretório local no computador onde o Microsoft SQL Server está instalado. Ele pode ser encontrado na unidade que contém os arquivos de instalação do SQL Server, em:

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

O esquema do plano de execução também pode ser encontrado neste site.

SET SET STATISTICS PROFILE e SETSET STATISTICS XML são contrapartes um do outro. O primeiro produz saída textual; o último produz saída XML. Em versões futuras do SQL Server, novas informações do plano de execução da consulta serão exibidas apenas através da SETSET STATISTICS XML instrução, não da instruçãoSETSET STATISTICS PROFILE.

Permissões

Para usar SETSET STATISTICS XML e visualizar a saída, os usuários devem ter as seguintes permissões:

• Permissões adequadas para executar as instruções Transact-SQL.

• A permissão de SHOWPLAN em todos os bancos de dados que são referenciados pelas instruções Transact-SQL.

Para Transact-SQL instruções que não produzem STATISTICS XML conjuntos de resultados, apenas as permissões apropriadas para executar as Transact-SQL são necessárias. Para Transact-SQL instruções que produzem STATISTICS XML conjuntos de resultados, verificações tanto para a permissão de execução da Transact-SQL instrução quanto para a permissão SHOWPLAN devem ter sucesso, ou a execução da Transact-SQL é abortada e nenhuma informação do Showplan é gerada.

Exemplos

As duas instruções que seguem usam as SETSET STATISTICS XML configurações para mostrar como o SQL Server analisa e otimiza o uso de índices nas consultas. A primeira consulta usa o operador de comparação Igual a (=), na cláusula WHERE, em uma coluna indexada. A segunda consulta usa o operador LIKE na cláusula WHERE. Isto força o SQL Server a usar uma verificação de índice clusterizado e a localizar os dados que atendem à condição da cláusula WHERE. Os valores nos atributos EstimateRows e EstimatedTotalSubtreeCost são menores para a primeira consulta indexada, indicando que ela foi processada com maior rapidez e usou menos recursos que a consulta não indexada.

USE AdventureWorks2022;  
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  

Consulte Também

SET SHOWPLAN_XML (Transact-SQL)
Utilitário sqlcmd