Eigenschappen van planhandleiding weergeven

van toepassing op:SQL ServerAzure SQL DatabaseAzure SQL Managed Instance

U kunt de eigenschappen van planhandleidingen in SQL Server bekijken met behulp van SQL Server Management Studio of Transact-SQL

In Dit Onderwerp

• Voordat u begint:

  Beveiliging

• De eigenschappen van planhandleidingen weergeven met behulp van:

  SQL Server Management Studio-

  Transact-SQL

Voordat u begint

Veiligheid

Machtigingen

De zichtbaarheid van de metagegevens in catalogusweergaven is beperkt tot beveiligbare items waarvan een gebruiker eigenaar is of waarvoor de gebruiker een bepaalde machtiging heeft gekregen.

SQL Server Management Studio gebruiken

De eigenschappen van een planhandleiding weergeven

1. Klik op het plusteken om de database uit te vouwen waarin u de eigenschappen van een planhandleiding wilt weergeven en klik vervolgens op het plusteken om de map Programmeerbaarheid uit te vouwen.

2. Klik op het plusteken om de map Plan Guides uit te vouwen.

3. Klik met de rechtermuisknop op de planhandleiding waarvan u de eigenschappen wilt bekijken en selecteer Eigenschappen.

   De volgende eigenschappen worden weergegeven in het dialoogvenster Planhandleidingseigenschappen.

   hints
   Geeft de query-hints of het queryplan weer die moeten worden toegepast op de Transact-SQL-instructie. Wanneer een queryplan is opgegeven als hint, wordt de XML Showplan-uitvoer voor het plan weergegeven.

   is uitgeschakeld
   Geeft de status van de planhandleiding weer. Mogelijke waarden zijn Waar en Onwaar.

   Naam
   Geeft de naam van de planhandleiding weer.

   Parameters
   Wanneer het bereiktype SQL of SJABLOON is, geeft u de naam en het gegevenstype weer van alle parameters die zijn ingesloten in de instructie Transact-SQL.

   Scope batch
   Geeft de batchtekst weer waarin de Transact-SQL-instructie verschijnt.

   Scope-objectnaam
   Wanneer het bereiktype OBJECT is, geeft u de naam weer van de Transact-SQL opgeslagen procedure, door de gebruiker gedefinieerde scalaire functie, de tabelwaardefunctie voor meerdere staten of de DML-trigger waarin de Transact-SQL-instructie wordt weergegeven.

   Bereik schemanaam
   Wanneer het bereiktype OBJECT is, wordt de naam weergegeven van het schema waarin het object zich bevindt.

   bereiktype
   Geeft het type entiteit weer waarin de Transact-SQL verklaring voorkomt. Hiermee geeft u de context op voor het koppelen van de Transact-SQL instructie aan de planhandleiding. Mogelijke waarden zijn OBJECT, SQLen TEMPLATE.

   verklaring
   Geeft de Transact-SQL verklaring weer waarop de plangids wordt toegepast.

4. Klik op OK-.

Transact-SQL gebruiken

De eigenschappen van een planhandleiding weergeven

1. Maak in Objectverkennerverbinding met een exemplaar van de Database Engine.

2. Klik op de standaardbalk op Nieuwe query.

3. Kopieer en plak het volgende voorbeeld in het queryvenster en klik op uitvoeren.

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

Zie sys.plan_guides (Transact-SQL)voor meer informatie.