Ver propiedades de la guía de plan

  • Artículo

Se aplica a:SQL ServerAzure SQL DatabaseAzure SQL Managed Instance

Obtenga información sobre cómo ver las propiedades de las guías de plan en SQL Server mediante SQL Server Management Studio o Transact-SQL

En este tema

Antes de empezar

Seguridad

Permisos

La visibilidad de los metadatos en las vistas de catálogo se limita a los elementos protegibles y que son propiedad de un usuario o para los que el usuario tiene algún permiso.

Uso de SQL Server Management Studio

Para ver las propiedades de una guía de plan

  1. Haga clic en el signo más para expandir la base de datos en la que desea ver las propiedades de una guía de plan y haga clic en el signo más para expandir la carpeta Programación .

  2. Haga clic en el signo más para expandir la carpeta Guías de plan .

  3. Haga clic con el botón derecho en la guía de plan cuyas propiedades quiere ver y seleccione Propiedades.

    Las propiedades siguientes se muestran en el cuadro de diálogo Propiedades de la guía de plan .

    Sugerencias
    Muestra las sugerencias de consulta o el plan de consulta que se va a aplicar a la instrucción Transact-SQL. Cuando un plan de consulta se especifica como una sugerencia, se mostrará la salida del Plan de presentación XML.

    Está deshabilitado
    Muestra el estado de la guía de plan. Los valores posibles son True o False.

    Nombre
    Muestra el nombre de la guía de plan.

    Parámetros
    Cuando el tipo de ámbito es SQL o TEMPLATE, muestra el nombre y el tipo de dato de todos los parámetros incorporados en la instrucción Transact-SQL.

    Lote del ámbito
    Muestra el texto del lote en el que aparece la instrucción Transact-SQL.

    Nombre de objeto del ámbito
    Si el tipo de ámbito es OBJECT, muestra el nombre del procedimiento almacenado de Transact-SQL, función escalar definida por el usuario, función con valores de tabla de múltiples instrucciones o desencadenador DML en que aparece la instrucción de Transact-SQL.

    Nombre de esquema del ámbito
    Si el tipo de ámbito es OBJECT, muestra el nombre del esquema en el que está contenido el objeto.

    Tipo de ámbito
    Muestra el tipo de entidad en la que aparece la instrucción de Transact-SQL. Esto especifica el contexto para hacer coincidir la instrucción Transact-SQL con la guía de plan. Los valores posibles son OBJECT, SQLy TEMPLATE.

    Instrucción
    Muestra la instrucción Transact-SQL frente a la que se aplicará la guía de plan.

  4. Haga clic en Aceptar.

Usar Transact-SQL

Para ver las propiedades de una guía de plan

  1. En el Explorador de objetos, conéctese a una instancia del Motor de base de datos.

  2. En la barra de Estándar, haga clic en Nueva consulta.

  3. Copie y pegue el siguiente ejemplo en la ventana de consulta y haga clic en Ejecutar.

    -- If a plan guide named "Guide1" already exists in the AdventureWorks2022 database, delete it.  
USE AdventureWorks2022;  
GO  
IF OBJECT_ID(N'Guide1') IS NOT NULL  
   EXEC sp_control_plan_guide N'DROP', N'Guide1';  
GO  
-- creates a plan guide named Guide1 based on a SQL statement  
EXEC sp_create_plan_guide   
    @name = N'Guide1',   
    @stmt = N'SELECT TOP 1 *   
              FROM Sales.SalesOrderHeader   
              ORDER BY OrderDate DESC',   
    @type = N'SQL',  
    @module_or_batch = NULL,   
    @params = NULL,   
    @hints = N'OPTION (MAXDOP 1)';  
GO  
-- Gets the name, created date, and all other relevant property information on the plan guide created above.   
SELECT name AS plan_guide_name,  
   create_date,  
   query_text,  
   scope_type_desc,  
   OBJECT_NAME(scope_object_id) AS scope_object_name,  
   scope_batch,  
   parameters,  
   hints,  
   is_disabled  
FROM sys.plan_guides  
WHERE name = N'Guide1';  
GO

Para obtener más información, vea sys.plan_guides (Transact-SQL).