Anzeigen der Eigenschaften der Planhinweisliste

  • Artikel

Gilt für:SQL ServerAzure SQL-DatenbankAzure SQL Managed Instance

Sie können die Eigenschaften von Planhandbüchern in SQL Server anzeigen, indem Sie SQL Server Management Studio oder Transact-SQL verwenden.

In diesem Thema

Vorbereitungen

Sicherheit

Berechtigungen

Die Sichtbarkeit der Metadaten in Katalogsichten ist auf sicherungsfähige Elemente beschränkt, bei denen der Benutzer entweder der Besitzer ist oder für die dem Benutzer 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 Die Eigenschaften der Planhinweisliste angezeigt.

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

    Ist deaktiviert
    Zeigt den Status der Planhinweisliste an. Mögliche Werte sind True und False.

    Name
    Zeigt den Namen der Planhinweisliste an.

    Parameter
    Wenn der Bereichstyp SQL oder TEMPLATE ist, werden der Name und der Datentyp aller Parameter angezeigt, die in die Transact-SQL-Anweisung eingebettet sind.

    Bereichsbatch
    Zeigt den Batchtext an, in dem die Transact-SQL-Anweisung angezeigt wird.

    Name von Bereichsobjekt
    Wenn der Bereichstyp OBJECT ist, wird der Name der gespeicherten Transact-SQL-Prozedur, der benutzerdefinierten Skalarfunktion, der mehrwertigen Funktion oder des DML-Triggers angezeigt, in dem die Transact-SQL-Anweisung angezeigt wird.

    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 der die Transact-SQL-Anweisung angezeigt wird. Dadurch wird der Kontext für den Abgleich der Transact-SQL-Anweisung mit dem Planleitfaden angegeben. Mögliche Werte sind OBJECT, SQLund TEMPLATE.

    Anweisung
    Zeigt die Transact-SQL-Anweisung an, auf die die Plananleitung 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).