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

Permissões

A visibilidade dos metadados nos modos de exibição do catálogo é limitada aos objetos protegidos que um usuário possui ou para os quais foi concedida alguma permissão ao usuário.

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, em seguida, clique no sinal de adição para expandir a pasta Programabilidade.

2. Clique no sinal de mais 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 o plano de consulta a serem aplicados à instrução Transact-SQL. Quando um plano de consulta é especificado como hint, a saída XML do Showplan para esse 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 escopos
   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 usado para associar a instrução Transact-SQL ao guia de plano. Os valores possíveis são OBJECT, SQLe TEMPLATE.

   Declaração
   Exibe a instrução Transact-SQL à qual o guia de plano se aplica.

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