SET SHOWPLAN_ALL (Transact-SQL)
Faz com que o Microsoft SQL Server não execute as instruções Transact-SQL. Em vez disso, o SQL Server retorna informações detalhada sobre como as instruções são executadas e fornece estimativas dos requisitos de recurso para as instruções.
.gif "Ícone de vínculo de tópico")
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 que enquanto SET SHOWPLAN_ALL estiver definido como ON, o SQL Server retornará uma mensagem de erro de uma instrução SELECT subsequente, 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.
SET SHOWPLAN_ALL deve ser usado pelos aplicativos gravados 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_ALL 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.
Nome da coluna |
Descrição |
|---|---|
StmtText |
Para linhas que não são do tipo PLAN_ROW, essa coluna contém o texto da instrução Transact-SQL. Para linhas do tipo PLAN_ROW, essa coluna contém uma descrição da operação. Essa coluna contém o operador físico e pode também conter, opcionalmente, o operador lógico. Essa coluna também pode ser seguida de uma descrição determinada pelo operador físico. Para obter mais informações, consulte Referência de operadores lógicos e físicos. |
StmtId |
Número da instrução no lote atual. |
NodeId |
ID do nó da consulta atual. |
Parent |
ID do nó da etapa pai. |
PhysicalOp |
Algoritmo de implementação física para o nó. Somente para linhas do tipo PLAN_ROWS. |
LogicalOp |
Operador algébrico relacional que esse nó representa. Somente para linhas do tipo PLAN_ROWS. |
Argument |
Fornece informações complementares sobre a operação em execução. O conteúdo dessa coluna depende do operador físico. |
DefinedValues |
Contém uma lista de itens separados por vírgula, com os valores introduzidos por esse operador. Esses valores podem ser expressões computadas que presentes na consulta atual (por exemplo, na lista SELECT ou na cláusula WHERE), ou valores internos introduzidos pelo processador de consultas para processar essa consulta. Esses valores definidos podem ser referenciados em outro lugar nessa consulta. Somente para linhas do tipo PLAN_ROWS. |
EstimateRows |
Número estimado de linhas de saída produzida por esse operador. Somente para linhas do tipo PLAN_ROWS. |
EstimateIO |
Custo* estimado de E/S para esse operador. Somente para linhas do tipo PLAN_ROWS. |
EstimateCPU |
Custo* estimado de CPU para esse operador. Somente para linhas do tipo PLAN_ROWS. |
AvgRowSize |
Tamanho médio estimado (em bytes) da linha da linha que está sendo passada por esse operador. |
TotalSubtreeCost |
Custo* estimado (cumulativo) dessa operação e de todas as operações filho. |
OutputList |
Contém uma lista separada por vírgulas de colunas que estão sendo projetadas pela operação atual. |
Warnings |
Contém uma lista separada por vírgulas de mensagens de aviso relativas à operação atual. As mensagens de aviso podem incluir a cadeia de caracteres "NO STATS:()" com uma lista de colunas. Essa mensagem de aviso significa que o otimizador de consulta tentou tomar uma decisão com base nas estatísticas dessa coluna, mas não havia nenhuma disponível. Por conseguinte, o otimizador de consulta precisou fazer uma suposição, que pode ter resultado na seleção de um plano de consulta ineficaz. Para obter mais informações sobre a criação ou atualização de estatísticas de coluna (que ajudam o otimizador de consulta a selecionar um plano de consulta mais eficaz), consulte UPDATE STATISTICS. Essa coluna pode incluir, opcionalmente, a cadeia de caracteres "MISSING JOIN PREDICATE", que significa que uma junção (envolvendo tabelas) está ocorrendo sem um predicado de junção. Descartar acidentalmente um predicado de junção pode resultar em uma consulta que leva mais tempo de execução que o esperado, e que retorna um grande conjunto de resultados. Se esse aviso estiver presente, verifique se a ausência do predicado de junção é intencional. |
Type |
Tipo de nó. Para o nó pai de cada consulta, esse é o tipo de instrução Transact-SQL (por exemplo, SELECT, INSERT, EXECUTE entre outras). Para os subnós que representam planos de execução, o tipo é PLAN_ROW. |
Parallel |
0 = O operador não está sendo executado em paralelo. 1 = O operador está sendo executado em paralelo. |
EstimateExecutions |
Número estimado de vezes que esse operador será executado durante a execução da consulta atual. |
*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.
Com relação às instruções SELECT, INSERT, UPDATE, DELETE, EXEC stored_procedure, e EXEC user_defined_function, para produzir um plano de execução, o usuário deve:
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, entre outras, são necessárias apenas as permissões adequadas para executar as instruções Transact-SQL.
Para obter mais informações, consulte Segurança de plano de execução e Permissão SHOWPLAN e lotes 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 que a coluna não indexada.
USE AdventureWorks2008R2;
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