Afficher les propriétés du repère de plan

  • Article

S’applique à : SQL Server base de données Azure SQL Azure SQL Managed Instance

Vous pouvez afficher les propriétés pour des repères de plan dans SQL Server à l’aide de SQL Server Management Studio ou de Transact-SQL.

Dans cette rubrique

Avant de commencer

Sécurité

autorisations

La visibilité des métadonnées dans les affichages catalogue est limitée aux éléments sécurisables qu'un utilisateur détient ou pour lesquels des autorisations lui ont été accordées.

Utilisation de SQL Server Management Studio

Pour afficher les propriétés d'un repère de plan

  1. Cliquez sur le signe plus (+) pour développer la base de données dans laquelle vous souhaitez afficher les propriétés d'un repère de plan, puis cliquez sur le signe plus (+) pour développer le dossier Programmabilité .

  2. Cliquez sur le signe plus (+) pour développer le dossier Repères de plan .

  3. Cliquez avec le bouton droit sur le repère de plan dont vous voulez afficher les propriétés, puis sélectionnez Propriétés.

    Les propriétés suivantes s'affichent dans la boîte de dialogue Propriétés du repère de plan .

    Indicateurs
    Affiche les indicateurs de requête ou le plan de requête à appliquer à l’instruction Transact-SQL. Lorsqu'un plan de requête est spécifié en tant qu'indicateur, la sortie du plan d'exécution XML s'affiche.

    Est désactivé
    Affiche l'état du repère de plan. Les valeurs possibles sont True et False.

    Nom
    Affiche le nom du repère de plan.

    Paramètres
    Lorsque le type de portée est SQL ou TEMPLATE, affiche le nom et le type de données de tous les paramètres incorporés dans l’instruction Transact-SQL.

    Lot de la portée
    Affiche le texte du lot dans lequel l’instruction Transact-SQL apparaît.

    Nom d'objet de la portée
    Lorsque le type de portée est OBJECT, affiche le nom de la procédure stockée Transact-SQL, la fonction scalaire définie par l’utilisateur, la fonction table à instructions multiples ou le déclencheur DML dans lequel l’instruction Transact-SQL apparaît.

    Nom de schéma de la portée
    Lorsque le type de portée est OBJECT, affiche le nom du schéma dans lequel l'objet est contenu.

    Type d'étendue
    Affiche le type de l’entité dans laquelle l’instruction Transact-SQL apparaît. Ce type spécifie le contexte pour la mise en correspondance de l’instruction Transact-SQL avec le repère de plan. Les valeurs possibles sont OBJECT, SQLet TEMPLATE.

    Instruction
    Affiche l’instruction Transact-SQL par rapport à laquelle le repère de plan est appliqué.

  4. Cliquez sur OK.

Utilisation de Transact-SQL

Pour afficher les propriétés d'un repère de plan

  1. Dans l' Explorateur d'objets, connectez-vous à une instance du Moteur de base de données.

  2. Dans la barre d'outils standard, cliquez sur Nouvelle requête.

  3. Copiez et collez l'exemple suivant dans la fenêtre de requête, puis cliquez sur Exécuter.

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

Pour plus d’informations, consultez sys.plan_guides (Transact-SQL).