SET SHOWPLAN_ALL (Transact-SQL)

Sintaxis

SET SHOWPLAN_ALL { ON | OFF }

Notas

La opción SET SHOWPLAN_ALL se establece en tiempo de ejecución, no en tiempo de análisis.

Cuando SET SHOWPLAN_ALL está establecida en ON, SQL Server devuelve información acerca de la ejecución de cada instrucción sin ejecutarla y no se ejecutan las instrucciones Transact-SQL. Cuando esta opción está establecida en ON, se devuelve información acerca de todas las instrucciones Transact-SQL siguientes hasta que se vuelve a establecer en OFF. Por ejemplo, si se ejecuta una instrucción CREATE TABLE cuando SET SHOWPLAN_ALL es ON y después se ejecuta una instrucción SELECT en la que se especifica la tabla creada, SQL Server devuelve un mensaje de error en el que se indica que la tabla no existe. Por ello, las referencias posteriores que se hagan a la tabla generarán un error. Cuando SET SHOWPLAN_ALL está establecida en OFF, SQL Server ejecuta las instrucciones sin generar ningún informe.

Sólo deben utilizar SET SHOWPLAN_ALL las aplicaciones escritas para controlar su salida. Puede usar SET SHOWPLAN_TEXT para obtener una salida legible para las aplicaciones Microsoft Win32 del símbolo del sistema, como la utilidad osql.

No es posible especificar SET SHOWPLAN_TEXT y SET SHOWPLAN_ALL en un procedimiento almacenado; deben ser las únicas instrucciones en un lote.

SET SHOWPLAN_ALL devuelve la información como un conjunto de filas en forma de árbol jerárquico que representa los pasos que sigue el procesador de consultas de SQL Server al ejecutar cada instrucción. Cada instrucción reflejada en la salida contiene una fila con el texto de la instrucción, seguida de varias filas con los detalles de los pasos de su ejecución. La tabla muestra las columnas que contiene la salida.

*Las unidades de coste están basadas en una medición interna de tiempo, no en tiempo de reloj. Se usan para determinar el coste relativo de un plan en comparación con otros planes.

Permisos

Para utilizar SET SHOWPLAN_ALL, debe disponer de permisos suficientes para ejecutar las instrucciones en las que se ejecuta SET SHOWPLAN_ALL, y debe tener el permiso SHOWPLAN para todas las bases de datos que contengan objetos a los que se hace referencia.

En el caso de las instrucciones SELECT, INSERT, UPDATE, DELETE, EXEC stored_procedure y EXEC user_defined_function, para producir un plan de presentación, el usuario debe:

• Tener los permisos correspondientes para ejecutar las instrucciones Transact-SQL.

• Tener el permiso SHOWPLAN en todas las bases de datos que contengan objetos a los que hacen referencia las instrucciones Transact-SQL, como tablas, vistas, etc.

Para las demás instrucciones, como DDL, USE database_name, SET, DECLARE, SQL dinámico, etc., sólo son necesarios los permisos apropiados para ejecutar las instrucciones Transact-SQL.

Para obtener más información, vea Seguridad del plan de presentación y Permiso SHOWPLAN y lotes Transact-SQL.

Ejemplos

Las dos instrucciones siguientes utilizan la opción SET SHOWPLAN_ALL para mostrar la forma en que SQL Server analiza y optimiza el uso de índices en las consultas.

La primera consulta utiliza el operador de comparación Es igual a (=) en la cláusula WHERE de una columna indizada. Esto da lugar al valor Clustered Index Seek en la columna LogicalOp y al nombre del índice en la columna Argument.

La segunda consulta utiliza el operador LIKE en la cláusula WHERE. De este modo, SQL Server debe utilizar un recorrido de índice no clúster para encontrar los datos que satisfacen la condición de la cláusula WHERE. Esto da lugar al valor Clustered Index Scan en la columna LogicalOp con el nombre del índice en la columna Argument y el valor Filter en la columna LogicalOp con la condición de la cláusula WHERE en la columna Argument.

Los valores de las columnas EstimateRows y TotalSubtreeCost son inferiores en la primera consulta indizada, lo que indica que se procesa mucho más rápidamente y que utiliza menos recursos que la no indizada.

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

Vea también

Referencia

Conceptos

Otros recursos