Compartilhar via


Exibir propriedades do guia de plano

Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do AzureBanco de dados SQL no Microsoft Fabric

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