Compartilhar via


Exibir propriedades do guia de plano

Aplica-se a: SQL Server Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure

Você pode exibir as propriedades dos guias de plano no SQL Server usando o SQL Server Management Studio ou o Transact-SQL

Neste tópico

Antes de começar

Segurança

Permissões

A visibilidade dos metadados em exibições do catálogo está limitada aos protegíveis que pertencem a um usuário ou para os quais o usuário recebeu permissão.

Como usar o SQL Server Management Studio.

Para visualizar as propriedades de um guia de plano

  1. Clique no sinal de adição para expandir o banco de dados no qual você deseja exibir as propriedades de um guia de plano e clique no sinal de adição para expandir a pasta Programação .

  2. Clique no sinal de adição para expandir a pasta Guias de Plano .

  3. Clique com o botão direito do mouse no guia de plano do qual você deseja exibir as propriedades e selecione Propriedades.

    As propriedades a seguir aparecem na caixa de diálogo Propriedades do Guia de Plano .

    Dicas
    Exibe as dicas de consulta ou plano de consulta a ser aplicado à instrução Transact-SQL. Quando um plano de consulta é especificado como uma dica, a saída Plano de Execução XML para o plano é exibida.

    Está desabilitado
    Exibe o status da guia de plano. Os valores possíveis são True e False.

    Nome
    Exibe o nome do guia de plano.

    Parâmetros
    Quando o tipo de escopo é SQL ou TEMPLATE, são exibidos o nome e os tipos de dados de todos os parâmetros inseridos na instrução Transact-SQL.

    Lote de escopo
    Exibe o texto de lote no qual a instrução Transact-SQL é exibida.

    Nome do objeto de escopo
    Quando o tipo de escopo é OBJECT, são exibidos o nome do procedimento armazenado no Transact-SQL, da função escalar definida pelo usuário, da função com valor de tabela de várias instruções ou do gatilho DML no qual a instrução Transact-SQL é exibida.

    Nome do esquema de escopo
    Quando o tipo de escopo é OBJECT, exibe-se o nome do esquema no qual o objeto está contido.

    Tipo de escopo
    Exibe o tipo de entidade na qual a instrução Transact-SQL é exibida. Isso especifica o contexto para se fazer a correspondência da instrução Transact-SQL com o guia de plano. Os valores possíveis são OBJECT, SQLe TEMPLATE.

    Instrução
    Exibe a instrução Transact-SQL na qual o guia de plano é aplicado.

  4. Clique em OK.

Usando o Transact-SQL

Para visualizar as propriedades de um guia de plano

  1. No Pesquisador de Objetos, conecte-se a uma instância do Mecanismo de Banco de Dados.

  2. Na barra Padrão, clique em Nova Consulta.

  3. Copie e cole o exemplo a seguir na janela de consulta e clique em Executar.

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

Para obter mais informações, veja sys.plan_guides (Transact-SQL).