Anzeigen der Eigenschaften der Planhinweisliste

Gilt für:SQL ServerAzure SQL-DatenbankVerwaltete Azure SQL-InstanzSQL-Datenbank in Microsoft Fabric

Erfahren Sie, wie Sie mithilfe von SQL Server Management Studio oder Transact-SQL die Eigenschaften einer Planhinweisliste in SQL Server anzeigen.

Berechtigungen

Die Sichtbarkeit der Metadaten in Katalogansichten ist auf sicherbare Objekte beschränkt, die entweder einem Benutzer gehören oder für die dem Benutzer mindestens eine Berechtigung erteilt wurde.

Verwendung von SQL Server Management Studio

So zeigen Sie die Eigenschaften einer Planhinweisliste an

  1. Klicken Sie auf das Pluszeichen, um die Datenbank zu erweitern, in der Sie die Eigenschaften einer Planhinweisliste anzeigen möchten, und klicken Sie dann auf das Pluszeichen, um den Ordner Programmierbarkeit zu erweitern.

  2. Klicken Sie auf das Pluszeichen, um den Ordner Planhinweislisten zu erweitern.

  3. Klicken Sie mit der rechten Maustaste auf die Planhinweisliste, deren Eigenschaften Sie anzeigen möchten, und wählen Sie Eigenschaften.

    Die folgenden Eigenschaften werden im Dialogfeld Planhinweis-Eigenschaften angezeigt.

    Hinweise
    Zeigt die Abfragehinweise oder den Abfrageplan zur Anwendung auf die Transact-SQL-Anweisung an. Wenn ein Abfrageplan als Hinweis gekennzeichnet ist, wird die XML-Showplanausgabe für den Plan angezeigt.

    Ist deaktiviert
    Zeigt den Status des Planleitfadens an. Mögliche Werte sind True und False.

    Name
    Zeigt den Namen des Planhinweises an.

    Parameter
    Wenn es sich beim Bereichstyp um SQL oder TEMPLATE handelt, wird hiermit der Name und Datentyp aller Parameter angezeigt, die in die Transact-SQL-Anweisung eingebettet sind.

    Bereichsbatch
    Zeigt den Batchtext an, in dem die Transact-SQL-Anweisung enthalten ist.

    Name von Bereichsobjekt
    Wenn der Bereichstyp OBJECT ist, wird der Name der gespeicherten Prozedur in Transact-SQL, der benutzerdefinierten Skalarfunktion, der mehranweisungsfähigen Tabellenwertfunktion oder des DML-Triggers angezeigt, in der bzw. dem die Transact-SQL-Anweisung vorkommt.

    Name von Bereichsschema
    Wenn es sich beim Bereichstyp um OBJECT handelt, wird hiermit der Name des Schemas angezeigt, in dem sich das Objekt befindet.

    Bereichstyp
    Zeigt den Typ der Entität an, in dem die Transact-SQL-Anweisung enthalten ist. Hiermit wird der Kontext für den Abgleich der Transact-SQL-Anweisung mit dem Plan Guide angegeben. Mögliche Werte sind OBJECT, SQLund TEMPLATE.

    Anweisung
    Zeigt die Transact-SQL-Anweisung an, auf die der Planhinweis angewendet wird.

  4. Klicken Sie auf OK.

Verwenden von Transact-SQL

So zeigen Sie die Eigenschaften einer Planhinweisliste an

  1. Stellen Sie im Objekt-Explorer eine Verbindung mit einer Datenbank-Engine-Instanz her.

  2. Klicken Sie in der Standardleiste auf Neue Abfrage.

  3. Kopieren Sie das folgende Beispiel, fügen Sie es in das Abfragefenster ein, und klicken Sie auf Ausführen.

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

Weitere Informationen finden Sie unter sys.plan_guides (Transact-SQL).