Exibir propriedades de guia de planoView Plan Guide Properties

Você pode exibir as propriedades dos guias de plano no SQL Server 2016SQL Server 2016 usando o SQL Server Management StudioSQL Server Management Studio ou o Transact-SQLTransact-SQLYou can view the properties of plan guides in SQL Server 2016SQL Server 2016 by using SQL Server Management StudioSQL Server Management Studio or Transact-SQLTransact-SQL

Neste tópicoIn This Topic

Antes de começar Before You Begin

Segurança Security

Permissões Permissions

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.The visibility of the metadata in catalog views is limited to securables that either a user owns or on which the user has been granted some permission.

Usando o SQL Server Management Studio Using SQL Server Management Studio

Para visualizar as propriedades de um guia de planoTo view the properties of a plan guide

  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 .Click the plus sign to expand the database in which you want to view the properties of a plan guide, and then click the plus sign to expand the Programmability folder.

  2. Clique no sinal de adição para expandir a pasta Guias de Plano .Click the plus sign to expand the Plan Guides folder.

  3. Clique com o botão direito do mouse no guia de plano do qual você deseja exibir as propriedades e selecione Propriedades.Right-click the plan guide of which you want to view the properties and select Properties.

    As propriedades a seguir aparecem na caixa de diálogo Propriedades do Guia de Plano .The following properties show in the Plan Guide Properties dialog box.

    DicasHints
    Exibe as dicas de consulta ou plano de consulta a ser aplicado à instrução Transact-SQLTransact-SQL .Displays the query hints or query plan to be applied to the Transact-SQLTransact-SQL statement. Quando um plano de consulta é especificado como uma dica, a saída Plano de Execução XML para o plano é exibida.When a query plan is specified as a hint, the XML Showplan output for the plan is displayed.

    Está desabilitadoIs disabled
    Exibe o status da guia de plano.Displays the status of the plan guide. Os valores possíveis são True e False.Possible values are True and False.

    NomeName
    Exibe o nome do guia de plano.Displays the name of the plan guide.

    ParâmetrosParameters
    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-SQLTransact-SQL .When the scope type is SQL or TEMPLATE, displays the name and data type of all parameters that are embedded in the Transact-SQLTransact-SQL statement.

    Lote de escopoScope batch
    Exibe o texto de lote no qual a instrução Transact-SQLTransact-SQL é exibida.Displays the batch text in which the Transact-SQLTransact-SQL statement appears.

    Nome do objeto de escopoScope object name
    Quando o tipo de escopo é OBJECT, exibi-se o nome do procedimento armazenado Transact-SQLTransact-SQL , da função escalar definida pelo usuário, da função de valor de tabela de várias instruções ou do gatilho DML no qual a instrução Transact-SQLTransact-SQL é exibida.When the scope type is OBJECT, displays the name of the Transact-SQLTransact-SQL stored procedure, user-defined scalar function, multistatement table-valued function, or DML trigger in which the Transact-SQLTransact-SQL statement appears.

    Nome do esquema de escopoScope schema name
    Quando o tipo de escopo é OBJECT, exibe-se o nome do esquema no qual o objeto está contido.When the scope type is OBJECT, displays the name of the schema in which the object is contained.

    Tipo de escopoScope type
    Exibe o tipo de entidade na qual a instrução Transact-SQLTransact-SQL é exibida.Displays the type of entity in which the Transact-SQLTransact-SQL statement appears. Isso especifica o contexto para se fazer a correspondência da instrução Transact-SQLTransact-SQL ao guia de plano.This specifies the context for matching the Transact-SQLTransact-SQL statement to the plan guide. Os valores possíveis são OBJECT, SQLe TEMPLATE.Possible values are OBJECT, SQL, and TEMPLATE.

    InstruçãoStatement
    Exibe a instrução Transact-SQLTransact-SQL na qual a guia de plano é aplicada.Displays the Transact-SQLTransact-SQL statement against which the plan guide is applied.

  4. Clique em OK.Click OK.

Usando Transact-SQL Using Transact-SQL

Para visualizar as propriedades de um guia de planoTo view the properties of a plan guide

  1. No Pesquisador de Objetos, conecte-se a uma instância do Mecanismo de Banco de DadosDatabase Engine.In Object Explorer, connect to an instance of Mecanismo de Banco de DadosDatabase Engine.

  2. Na barra Padrão, clique em Nova Consulta.On the Standard bar, click New Query.

  3. Copie e cole o exemplo a seguir na janela de consulta e clique em Executar.Copy and paste the following example into the query window and click Execute.

    -- If a plan guide named “Guide1” already exists in the AdventureWorks2012 database, delete it.  
    USE AdventureWorks2012;  
    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).For more information, see sys.plan_guides (Transact-SQL).