Visualizzare le proprietà delle guide di piano

  • Articolo

Si applica a: SQL Server, Database SQL di Azure e Istanza gestita di SQL di Azure

È possibile visualizzare le proprietà delle guide di piano in SQL Server usando SQL Server Management Studio o Transact-SQL

Contenuto dell'articolo

Prima di iniziare

Sicurezza

Autorizzazioni

La visibilità dei metadati nelle viste del catalogo è limitata alle entità a protezione diretta di cui un utente è proprietario o per le quali dispone di autorizzazioni.

Utilizzo di SQL Server Management Studio

Per visualizzare le proprietà di una guida di piano

  1. Fare clic sul segno più per espandere il database in cui si desidera visualizzare le proprietà di una guida di piano, quindi fare clic sul segno più per espandere la cartella Programmabilità .

  2. Fare clic sul segno più per espandere la cartella Guide di piano .

  3. Fare clic con il pulsante destro del mouse sulla guida di piano di cui visualizzare le proprietà e selezionare Proprietà.

    Le seguenti proprietà vengono visualizzate nella finestra di dialogo Proprietà guida di piano .

    Hint
    Vengono visualizzati gli hint per la query o il piano di query da applicare all'istruzione Transact-SQL. Quando un piano di query viene specificato come un hint, viene visualizzato l'output di Showplan XML per il piano.

    Disabilitato
    Visualizza lo stato della guida di piano. I valori possibili sono True e False.

    Nome
    Visualizza il nome della guida di piano.

    Parametri
    Quando il tipo di ambito è SQL o TEMPLATE, vengono visualizzati il nome e il tipo di dati di tutti i parametri incorporati nell'istruzione Transact-SQL.

    Batch ambito
    Visualizza il testo del batch nel quale viene visualizzata l'istruzione Transact-SQL.

    Nome oggetto dell'ambito
    Quando il tipo di ambito è OBJECT, viene visualizzato il nome della stored procedure Transact-SQL, della funzione scalare definita dall'utente o del trigger DML in cui viene visualizzata l'istruzione Transact-SQL.

    Nome schema ambito
    Quando il tipo di ambito è OBJECT, viene visualizzato il nome dello schema che contiene l'oggetto.

    Tipo di ambito
    Visualizza il tipo di entità nel quale viene visualizzata l'istruzione Transact-SQL. Viene specificato il contesto per adeguare l'istruzione Transact-SQL alla guida di piano. I valori possibili sono OBJECT, SQLe TEMPLATE.

    Istruzione
    Viene visualizzata l'istruzione Transact-SQL sulla quale deve essere applicata la guida di piano.

  4. Fare clic su OK.

Utilizzo di Transact-SQL

Per visualizzare le proprietà di una guida di piano

  1. In Esplora oggetti connettersi a un'istanza del motore di database.

  2. Sulla barra Standard fare clic su Nuova query.

  3. Copiare e incollare l'esempio seguente nella finestra Query, quindi fare clic su Esegui.

    -- 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

Per altre informazioni, vedere sys.plan_guides (Transact-SQL).