Ver las propiedades de la guía del plan

Se aplica a:SQL ServerAzure SQL DatabaseInstancia administrada de Azure SQLBase de datos SQL en Microsoft Fabric

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

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 de ejecución y, a continuación, haga clic en el signo más para expandir la carpeta Capacidad de programación.

2. Haga clic en el signo de suma para desplegar 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 siguientes propiedades 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 se especifica un plan de consulta como sugerencia, se muestra la salida Showplan XML del plan.

   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 del 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 de alcance
   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.

   Sentencia
   Muestra la instrucción Transact-SQL a la que se aplica la guía de plan.

4. Haga clic en OK.

Uso de 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).