Exibir propriedades do guia de plano

  • Artigo

Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstâ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 no 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).