SET SHOWPLAN_ALL (Transact-SQL)

Aplica-se a:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceBase de dados SQL no Microsoft Fabric

Faz com que o Microsoft SQL Server não execute Transact-SQL instruções. Em vez disso, o SQL Server devolve 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 linhas esperadas (estimativa de cardinalidade).

Transact-SQL convenções de sintaxe

Sintaxe

  
SET SHOWPLAN_ALL { ON | OFF }  

Observações

A definição do SET SHOWPLAN_ALL é definida em tempo de execução ou execução e não em tempo de análise sintética.

Quando SET SHOWPLAN_ALL está LIGADO, o SQL Server devolve a informação de execução de cada instrução sem a executar, e Transact-SQL instruções não são executadas. Depois de esta opção ser ativada, a informação sobre todas as instruções Transact-SQL subsequentes é devolvida até que a opção seja desativada. Por exemplo, se uma instrução CREATE TABLE for executada enquanto SET SHOWPLAN_ALL está ON, o SQL Server devolve uma mensagem de erro de uma instrução SELECT subsequente envolvendo essa mesma tabela, informando os utilizadores de que a tabela especificada não existe. Portanto, as referências subsequentes a esta tabela falham. Quando o SET SHOWPLAN_ALL está DESLIGADO, o SQL Server executa as instruções sem gerar um relatório.

SET SHOWPLAN_ALL destina-se a ser usado por aplicações escritas para gerir a sua saída. Use o SHOWPLAN_TEXT SET para devolver uma saída legível para aplicações do prompt de comandos Microsoft Win32, como a utilidade osql .

SET SHOWPLAN_TEXT e SET SHOWPLAN_ALL não podem ser especificados dentro de um procedimento armazenado; Devem ser as únicas declarações num lote.

O SET SHOWPLAN_ALL devolve informação como um conjunto de linhas que formam uma árvore hierárquica que representa os passos dados pelo processador de consultas SQL Server à medida que executa cada instrução. Cada instrução refletida na saída contém uma única linha com o texto da declaração, seguida de várias linhas com os detalhes dos passos de execução. A tabela mostra as colunas que a saída contém.

*As unidades de custo baseiam-se numa medição interna do tempo, não no relógio de parede. São usados para determinar o custo relativo de um plano em comparação com outros planos.

Permissions

Para usar o SET SHOWPLAN_ALL, deve ter permissões suficientes para executar as instruções sobre as quais o SET SHOWPLAN_ALL é executado, e deve ter permissão SHOWPLAN para todas as bases de dados que contenham objetos referenciados.

Para as instruções SELECT, INSERT, UPDATE, DELETE , EXEC stored_procedure e EXEC user_defined_function , para produzir um Showplan, o utilizador deve:

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

• Tenha 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, entre outras, são necessárias apenas as permissões apropriadas para executar as instruções Transact-SQL.

Examples

As duas instruções que se seguem utilizam as definições SET SHOWPLAN_ALL para mostrar a forma como o SQL Server analisa e otimiza o uso de índices nas consultas.

A primeira consulta utiliza o operador de comparação Equals (=) na cláusula ONDE numa coluna indexada. Isto resulta no valor de Pesquisa de Índice Agrupado na coluna LogicalOp e no nome do índice na coluna Argumento .

A segunda consulta usa o operador LIKE na cláusula WHERE. Isto obriga o SQL Server a usar uma varridura de índice clusterizada e encontrar os dados que satisfazem a condição da cláusula WHERE. Isto resulta no valor Clustered Index Scan na coluna LogicalOp com o nome do índice na coluna Argumento , e no valor Filter na coluna LogicalOp com a condição da cláusula WHERE na coluna Argumento .

Os valores nas colunas EstimateRows e TotalSubtreeCost são menores para a primeira consulta indexada, indicando que esta é processada muito mais rapidamente e consome menos recursos do que a consulta 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  

Ver também

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