Anzeigen der Eigenschaften der PlanhinweislisteView Plan Guide Properties

Gilt für: JaSQL Server JaAzure SQL-Datenbank NeinAzure Synapse Analytics (SQL DW) NeinParallel Data Warehouse APPLIES TO: yesSQL Server yesAzure SQL Database noAzure Synapse Analytics (SQL DW) noParallel Data Warehouse

Sie können die Eigenschaften von Planhinweislisten in SQL Server 2019 (15.x)SQL Server 2019 (15.x) mithilfe von SQL Server Management StudioSQL Server Management Studio oder Transact-SQLTransact-SQLYou can view the properties of plan guides in SQL Server 2019 (15.x)SQL Server 2019 (15.x) by using SQL Server Management StudioSQL Server Management Studio or Transact-SQLTransact-SQL

In diesem ThemaIn This Topic

VorbereitungenBefore You Begin

SicherheitSecurity

BerechtigungenPermissions

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.The visibility of the metadata in catalog views is limited to securables that either a user owns or on which the user has been granted some permission.

Verwenden von SQL Server Management StudioUsing SQL Server Management Studio

So zeigen Sie die Eigenschaften einer Planhinweisliste anTo view the properties of a plan guide

  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.Click the plus sign to expand the database in which you want to view the properties of a plan guide, and then click the plus sign to expand the Programmability folder.

  2. Klicken Sie auf das Pluszeichen, um den Ordner Planhinweislisten zu erweitern.Click the plus sign to expand the Plan Guides folder.

  3. Klicken Sie mit der rechten Maustaste auf die Planhinweisliste, deren Eigenschaften Sie anzeigen möchten, und wählen Sie Eigenschaften.Right-click the plan guide of which you want to view the properties and select Properties.

    Die folgenden Eigenschaften werden im Dialogfeld Die Eigenschaften der Planhinweisliste angezeigt.The following properties show in the Plan Guide Properties dialog box.

    HinweiseHints
    Zeigt die Abfragehinweise oder den Abfrageplan zur Anwendung auf die Transact-SQLTransact-SQL -Anweisung an.Displays the query hints or query plan to be applied to the Transact-SQLTransact-SQL statement. Wenn ein Abfrageplan als Hinweis gekennzeichnet ist, wird die XML-Showplanausgabe für den Plan angezeigt.When a query plan is specified as a hint, the XML Showplan output for the plan is displayed.

    Ist deaktiviertIs disabled
    Zeigt den Status der Planhinweisliste an.Displays the status of the plan guide. Mögliche Werte sind True und False.Possible values are True and False.

    NameName
    Zeigt den Namen der Planhinweisliste an.Displays the name of the plan guide.

    ParameterParameters
    Wenn es sich beim Bereichstyp um SQL oder TEMPLATE handelt, wird hiermit der Name und Datentyp aller Parameter angezeigt, die in die Transact-SQLTransact-SQL -Anweisung eingebettet sind.When the scope type is SQL or TEMPLATE, displays the name and data type of all parameters that are embedded in the Transact-SQLTransact-SQL statement.

    BereichsbatchScope batch
    Zeigt den Batchtext an, in dem die Transact-SQLTransact-SQL -Anweisung enthalten ist.Displays the batch text in which the Transact-SQLTransact-SQL statement appears.

    Name von BereichsobjektScope object name
    Wenn es sich beim Bereichstyp um OBJECT handelt, wird hiermit der Name der gespeicherten Transact-SQLTransact-SQL -Prozedur, benutzerdefinierten Skalarfunktion, aus mehreren Anweisungen bestehenden Funktion mit Tabellenrückgabe oder des DML-Triggers angezeigt, die bzw. der die Transact-SQLTransact-SQL -Anweisung enthält.When the scope type is OBJECT, displays the name of the Transact-SQLTransact-SQL stored procedure, user-defined scalar function, multistatement table-valued function, or DML trigger in which the Transact-SQLTransact-SQL statement appears.

    Name von BereichsschemaScope schema name
    Wenn es sich beim Bereichstyp um OBJECT handelt, wird hiermit der Name des Schemas angezeigt, in dem sich das Objekt befindet.When the scope type is OBJECT, displays the name of the schema in which the object is contained.

    BereichstypScope type
    Zeigt den Typ der Entität an, in dem die Transact-SQLTransact-SQL -Anweisung enthalten ist.Displays the type of entity in which the Transact-SQLTransact-SQL statement appears. Dies gibt den Kontext zum Abgleich der Transact-SQLTransact-SQL -Anweisung mit der Planhinweisliste an.This specifies the context for matching the Transact-SQLTransact-SQL statement to the plan guide. Mögliche Werte sind OBJECT, SQLund TEMPLATE.Possible values are OBJECT, SQL, and TEMPLATE.

    StatementStatement
    Zeigt die Transact-SQLTransact-SQL -Anweisung an, auf die die Planhinweisliste angewendet wird.Displays the Transact-SQLTransact-SQL statement against which the plan guide is applied.

  4. Klicken Sie auf OK.Click OK.

Verwenden von Transact-SQLUsing Transact-SQL

So zeigen Sie die Eigenschaften einer Planhinweisliste anTo view the properties of a plan guide

  1. Stellen Sie im Objekt-Explorer eine Verbindung mit einer Datenbank-EngineDatabase Engine-Instanz her.In Object Explorer, connect to an instance of Datenbank-EngineDatabase Engine.

  2. Klicken Sie in der Standardleiste auf Neue Abfrage.On the Standard bar, click New Query.

  3. Kopieren Sie das folgende Beispiel, fügen Sie es in das Abfragefenster ein, und klicken Sie auf Ausführen.Copy and paste the following example into the query window and click Execute.

    -- If a plan guide named "Guide1" already exists in the AdventureWorks2012 database, delete it.  
    USE AdventureWorks2012;  
    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).For more information, see sys.plan_guides (Transact-SQL).