SET SHOWPLAN_ALL (Transact-SQL)

Aplica-se a: SQL Server Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure

Faz com que o Microsoft SQL Server não execute instruções Transact-SQL. Em vez disso, o SQL Server retorna informações detalhadas sobre como as instruções seriam executadas (um plano de consulta) e fornece estimativas dos requisitos de recursos para as instruções e as linhas esperadas (estimativa de cardinalidade).

Convenções de sintaxe de Transact-SQL

Sintaxe

  
SET SHOWPLAN_ALL { ON | OFF }  

Comentários

A configuração de SHOWPLAN_ALL é definida durante a execução ou tempo de execução, e não no momento da análise.

Quando SET SHOWPLAN_ALL for ON, O SQL Server retornará informações de execução para cada instrução, sem executá-las, e as instruções Transact-SQL não serão executadas. 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. Por exemplo, se uma instrução CREATE TABLE for executada enquanto SET SHOWPLAN_ALL estiver definido como ON, o SQL Server retornará uma mensagem de erro de uma instrução SELECT posterior, envolvendo essa mesma tabela, informando os usuários de que a tabela especificada não existe. Portanto, haverá falha nas referências subsequentes para essa tabela. Quando SET SHOWPLAN_ALL for OFF, o SQL Server executará as instruções sem gerar um relatório.

O SET SHOWPLAN_ALL deve ser usado pelos aplicativos escritos para controlar sua saída. Use SET SHOWPLAN_TEXT para retornar uma saída legível para aplicativos de prompt de comando do Microsoft Win32, como o utilitário osql.

SET SHOWPLAN_TEXT e SET SHOWPLAN_ALL não podem ser especificados em um procedimento armazenado; eles devem ser as únicas instruções em um lote.

SET SHOWPLAN_TEXT retorna informações como um conjunto de linhas que formam uma árvore hierárquica que representa as etapas cumpridas pelo processador de consultas do SQL Server, à medida que ele executa cada instrução. Cada instrução refletida na saída contém uma única linha com o texto da instrução, seguida de várias linhas com os detalhes das etapas de execução. A tabela mostra as colunas que a saída contém.

*Unidades de custo se baseiam em uma medida interna de tempo, e não no tempo do relógio. Elas são usadas para determinar o custo relativo de um plano em comparação com outros planos.

Permissões

Para usar SET SHOWPLAN_ALL, é necessário ter permissões suficientes para executar as instruções nas quais SET SHOWPLAN_ALL é executado, e ter a permissão SHOWPLAN para todos os bancos de dados que contenham objetos referenciados.

Para instruções SELECT, INSERT, UPDATE, DELETE, EXEC stored_procedure e EXEC user_defined_function, para produzir um Plano de Execução, o usuário precisa:

• Ter as permissões apropriadas para executar as instruções Transact-SQL.

• Ter permissão SHOWPLAN em todos os bancos de dados que contenham objetos referenciados pelas instruções Transact-SQL, como tabelas, exibições e assim por diante.

Para todas as outras instruções, como DDL, USE database_name, SET, DECLARE, SQL dinâmico, e assim por diante, são necessárias apenas as permissões adequadas para executar as instruções Transact-SQL.

Exemplos

As duas instruções a seguir usam as configurações SET SHOWPLAN_ALL para mostrar o modo pelo qual o SQL Server analisa e otimiza o uso de índices em consultas.

A primeira consulta usa o operador de comparação Igual (=) na cláusula WHERE em uma coluna indexada. Isso resulta no valor Clustered Index Seek na coluna LogicalOp e no nome do índice da coluna Argument.

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. Isso resulta no valor Clustered Index Scan da coluna LogicalOp com o nome do índice na coluna Argument e no valor Filter da coluna LogicalOp com a condição da cláusula WHERE na coluna Argument.

Os valores das colunas EstimateRows e TotalSubtreeCost são inferiores com relação à primeira consulta indexada, indicando que ela é processada muito mais rapidamente e que usa recursos mais ágeis e em menor quantidade do que a coluna não indexada.

USE AdventureWorks2022;  
GO  
SET SHOWPLAN_ALL ON;  
GO  
-- First query.  
SELECT BusinessEntityID   
FROM HumanResources.Employee  
WHERE NationalIDNumber = '509647174';  
GO  
-- Second query.  
SELECT BusinessEntityID, EmergencyContactID   
FROM HumanResources.Employee  
WHERE EmergencyContactID LIKE '1%';  
GO  
SET SHOWPLAN_ALL OFF;  
GO  

Consulte Também

Instruções SET (Transact-SQL)
SET SHOWPLAN_TEXT (Transact-SQL)
SET SHOWPLAN_XML (Transact-SQL)