Usar o SQL Server Profiler para criar e testar guias de plano

  • Artigo

Aplica-se a:SQL ServerBanco de Dados SQL do Azure

Ao criar um guia de plano, você pode usar SQL Server Profiler para capturar o texto exato da consulta para uso no argumento statement_text do procedimento armazenado sp_create_plan_guide. Isto ajuda a certificar que o guia de plano será correspondido à consulta no tempo de compilação. Depois que o guia de plano é criado, SQL Server Profiler também pode ser usado para testar se o guia de plano está, de fato, sendo correspondido à consulta. Em geral, você deve testar guias de plano usando SQL Server Profiler para verificar se a consulta está sendo correspondida ao guia de plano.

Como capturar texto de consulta usando o SQL Server Profiler

Se você executar uma consulta e capturar o texto exatamente como ele foi enviado para SQL Server usando SQL Server Profiler, você poderá criar um guia de plano do tipo SQL ou TEMPLATE que corresponderá exatamente ao texto da consulta. Isto certifica que o guia de plano seja usado pelo otimizador de consulta.

Considere a seguinte consulta, que é submetida por um aplicativo como um lote autônomo:

SELECT COUNT(*) AS c  
FROM Sales.SalesOrderHeader AS h  
INNER JOIN Sales.SalesOrderDetail AS d  
  ON h.SalesOrderID = d.SalesOrderID  
WHERE h.OrderDate BETWEEN '20000101' and '20050101';

Suponha que você queira que essa consulta execute uma operação de mescla de junção, mas SHOWPLAN indica que a consulta não está usando uma mescla de junção. Você não pode alterar a consulta diretamente no aplicativo, então, em vez disso, cria um guia de plano para especificar que a dica de consulta MERGE JOIN seja acrescentada à consulta no tempo de compilação.

Para capturar o texto da consulta exatamente como SQL Server a recebe, siga estas etapas:

  1. Inicie um rastreamento SQL Server Profiler, certificando-se de que o tipo de evento SQL:BatchStarting esteja selecionado.

  2. Faça com que o aplicativo execute a consulta.

  3. Pause o rastreamento de SQL Server Profiler.

  4. Clique no evento SQL:BatchStarting que corresponde à consulta.

  5. Clique com o botão direito do mouse e selecione Extrair Dados de Eventos.

    Importante

    Não tente copiar o texto em lote selecionando-o no painel inferior da janela de rastreamento do Profiler. Isto pode fazer com que o guia de plano que você criou não corresponda ao lote original.

  6. Salve os dados de evento em um arquivo. Este é o texto em lote.

  7. Abra o arquivo de texto em lote no Bloco de Notas e copie o texto no buffer copiar e colar.

  8. Crie o guia de plano e cole o texto copiado dentro das aspas ('') especificadas para o argumento @stmt . Você deve escapar as aspas simples no argumento @stmt precedendo-as com outra aspa simples. Tenha cuidado para não adicionar ou remover nenhum outro caractere quando você inserir essas aspas individuais. Por exemplo, o literal de data '20000101' deve ser delimitado como ''20000101''.

Aqui está o guia de plano:

EXEC sp_create_plan_guide   
    @name = N'MyGuide1',  
    @stmt = N'<paste the text copied from the batch text file here>',  
    @type = N'SQL',  
    @module_or_batch = NULL,  
    @params = NULL,  
    @hints = N'OPTION (MERGE JOIN)';

Como testar guias de plano usando o SQL Server Profiler

Para verificar se um guia de plano está sendo correspondido a uma consulta, execute as seguintes etapas:

  1. Inicie um rastreamento SQL Server Profiler, garantindo que o tipo de evento Showplan XML esteja selecionado (localizado no nó Desempenho).

  2. Faça com que o aplicativo execute a consulta.

  3. Pause o rastreamento de SQL Server Profiler.

  4. Localize o evento Plano de Execução XML para a consulta afetada.

    Observação

    O evento Showplan XML for Query Compile não pode ser usado. PlanGuideDB não existe nesse evento.

  5. Se o guia de plano for do tipo OBJECT ou SQL, verifique se o evento Plano de Execução XML contém os atributos PlanGuideDB e PlanGuideName para o guia de plano que você espera que corresponda à consulta. Ou, no caso de um guia de plano de TEMPLATE, verifique se o evento Plano de Execução XML contém os atributos TemplatePlanGuideDB e TemplatePlanGuideName para o guia de plano esperada. Isto verifica se o guia de plano está funcionando. Esses atributos estão contidos no <elemento StmtSimple> do plano.

Consulte Também

sp_create_plan_guide (Transact-SQL)