Exibindo planos de execução usando Opções SET de plano de execução (Transact-SQL)

Opções da instrução SET de plano de execução

Transact-SQL fornece as seguintes opções para sua instrução SET que permite a exibição de um plano de execução de consulta:

Observação
As opções SHOWPLAN_XML, SHOWPLAN_ALL e SHOWPLAN_TEXT SET produzem um conjunto de linhas para cada lote. As opções STATISTICS XML e STATISTICS PROFILE SET produzem um conjunto de linhas para cada consulta em um lote.

• SET SHOWPLAN_XML ON

  Esta instrução faz com que o SQL Server não execute instruções Transact-SQL. Em vez disso, o Microsoft SQL Server retorna informações de plano de execução sobre como as instruções são executadas em um documento XML bem formado. Para obter mais informações, consulte SET SHOWPLAN_XML (Transact-SQL).

• SET SHOWPLAN_TEXT ON

  Depois que esta instrução SET é executada, o SQL Server retorna as informações de plano de execução de cada consulta em texto. As instruções ou os lotesTransact-SQL não são executados. Para obter mais informações, consulte SET SHOWPLAN_TEXT (Transact-SQL).

• SET SHOWPLAN_ALL ON

  Esta instrução é semelhante a SET SHOWPLAN_TEXT, exceto que a saída ocorre em um formato mais detalhado que o SHOWPLAN_TEXT. Para obter mais informações, consulte SET SHOWPLAN_ALL (Transact-SQL).

• SET STATISTICS XML ON

  Retorna informações de execução de cada instrução depois que a instrução é executada, além do conjunto de resultados normal retornado pela instrução. A saída é um conjunto de documentos XML bem formados. SET STATISTICS XML ON produz um documento de saída XML para cada instrução executada. A diferença entre SET SHOWPLAN_XML ON e SET STATISTICS XML ON é que a segunda opção SET executa a instrução ou o lote Transact-SQL. A saída SET STATISTICS XML ON também inclui informações sobre o número real de linhas processadas por vários operadores e o número real de execuções dos operadores. Para obter mais informações, consulte SET STATISTICS XML (Transact-SQL).

• SET STATISTICS PROFILE ON

  Retorna informações de execução de cada instrução depois que a instrução é executada, além do conjunto de resultados normal retornado pela instrução. Ambas as opções da instrução SET proporcionam saída em texto. A diferença entre SET SHOWPLAN_ALL ON e SET STATISTICS PROFILE ON é que a segunda opção SET executa a instrução ou o lote Transact-SQL. A saída SET STATISTICS PROFILE ON também inclui informações sobre o número real de linhas processadas por diversos operadores e o número real de execuções dos operadores. Para obter mais informações, consulte SET STATISTICS PROFILE (Transact-SQL).

• SET STATISTICS IO ON

  Exibe informações sobre o volume de atividade em disco que é gerado pelas instruções Transact-SQL depois que as instruções são executadas. Esta opção SET produz saída de texto. Para obter mais informações, consulte SET STATISTICS IO (Transact-SQL).

• SET STATISTICS TIME ON

  Exibe o número de milissegundos necessários para analisar, compilar e executar cada instrução Transact-SQL depois que as instruções são executadas. Esta opção SET produz saída de texto. Para obter mais informações, consulte SET STATISTICS TIME (Transact-SQL).

Considerações por usar opções da instrução SET de plano de execução

Quando você exibe um plano de execução usando as opções SHOWPLAN SET, as instruções enviadas ao servidor não são executadas. Em vez disso, o SQL Server analisa a consulta e exibe, em uma série de operadores, como as instruções deveriam ter sido executadas.

Observação

Como não são executadas instruções quando o plano de execução é exibido, as operações Transact-SQL não são de fato executadas. Por exemplo, se uma instrução CREATE TABLE fizer parte de um plano de execução, quaisquer operações posteriores que envolvam a tabela "criada" retornarão erros, porque a tabela não existe. Porém, essa regra tem duas exceções: as tabelas temporárias são criadas quando você usa as opções SHOWPLAN SET, e as instruções USE db_name são executadas e tentam alterar o contexto do banco de dados para o db_name especificado quando você usa as opções SET de plano de execução.

Quando você exibe um plano de execução usando as opções STATISTICS SET, as instruções Transact-SQL enviadas ao servidor são executadas.

Observação
As opções SET de plano de execução não exibem nenhuma informação sobre gatilhos ou procedimentos armazenados criptografados.

Opções SET programadas para reprovação em versões futuras do plano de execução

Em uma versão futura do SQL Server, as opções SET de plano de execução a seguir serão preteridas. Recomendamos que os usuários mudem para os modos mais recentes o mais rápido possível. A tabela a seguir lista as opções SET de plano de execução que estão programadas para reprovação com as novas opções SET que os usuários devem começar a usar.

Consulte também

Conceitos