Freigeben über

Verwenden von SQL Server Profiler zum Erstellen und Testen von Planhinweislisten

  • Artikel

Gilt für: SQL Server Azure SQL-Datenbank

Wenn Sie eine Planhinweisliste erstellen, können Sie durch Verwenden von SQL Server Profiler den genauen Abfragetext aufzeichnen, um diesen im statement_text-Argument der gespeicherten Prozedur sp_create_plan_guide zu verwenden. Damit kann sichergestellt werden, dass die Planhinweisliste zum Zeitpunkt der Kompilierung mit der Abfrage in Übereinstimmung gebracht wird. Nach dem Erstellen der Planhinweisliste kann SQL Server Profiler auch verwendet werden, um zu testen, ob die Planhinweisliste tatsächlich in Übereinstimmung mit der Abfrage gebracht wird. Im Allgemeinen sollten Sie Planhinweislisten mithilfe von SQL Server Profiler testen, um zu überprüfen, dass Ihre Abfrage mit Ihrer Planhinweisliste übereinstimmt.

Aufzeichnen von Abfragetext mithilfe von SQL Server Profiler

Wenn Sie eine Abfrage ausführen und den Text mithilfe von SQL Server Profiler genau so aufzeichnen, wie er an SQL Server übermittelt wurde, können Sie eine Planhinweisliste des Typs SQL oder TEMPLATE erstellen, die genau mit dem Abfragetext übereinstimmt. Damit wird sichergestellt, dass die Planhinweisliste vom Abfrageoptimierer verwendet wird.

Angenommen, die folgende Abfrage wird durch eine Anwendung als eigenständiger Batch übermittelt:

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';

Nehmen wir jetzt an, Sie möchten diese Abfrage mithilfe eines Vorgangs zur Zusammenführungsjoins ausführen, von SHOWPLAN wird jedoch angezeigt, dass die Abfrage keine Zusammenführungsjoin verwendet. Es ist nicht möglich, die Abfrage direkt in der Anwendung zu ändern. Also erstellen Sie stattdessen eine Planhinweisliste, um anzugeben, dass der MERGE JOIN-Abfragehinweis zum Kompilierzeitpunkt an die Abfrage angehängt wird.

Um den Text genau so aufzuzeichnen, wie er von SQL Server empfangen wird, gehen Sie folgendermaßen vor:

  1. Starten Sie eine SQL Server Profiler-Ablaufverfolgung, und stellen Sie dabei sicher, dass derSQL:BatchStarting-Ereignistyp ausgewählt ist.

  2. Führen Sie Abfrage mithilfe der Anwendung aus.

  3. Anhalten der Ablaufverfolgung (SQL Server Profiler)

  4. Klicken Sie auf das SQL:BatchStarting -Ereignis, das der Abfrage entspricht.

  5. Klicken Sie mit der rechten Maustaste auf dieses Ereignis, und wählen Sie Ereignisdaten extrahierenaus.

    Wichtig

    Versuchen Sie nicht, den Batchtext zu kopieren, indem Sie ihn im unteren Bereich des Profiler-Ablaufverfolgungsfensters markieren. Das kann dazu führen, dass die von Ihnen erstellte Planhinweisliste nicht mit dem ursprünglichen Batch übereinstimmt.

  6. Speichern Sie die Ereignisdaten in einer Datei. Das ist der Batchtext.

  7. Öffnen Sie die Batchtextdatei in Editor, und kopieren Sie den Text in die Zwischenablage.

  8. Erstellen Sie die Planhinweisliste, und fügen Sie den kopierten Text zwischen die Anführungszeichen ('') ein, die für das @stmt -Argument angegeben sind. Sie müssen alle einfachen Anführungszeichen im @stmt -Argument abgrenzen, indem Sie ihnen ein weiteres einfaches Anführungszeichen voranstellen. Achten Sie darauf, beim Einfügen dieser einfachen Anführungszeichen keine weiteren Zeichen hinzuzufügen oder zu entfernen. So muss z. B. das Datumsliteral '20000101' als ''20000101''abgegrenzt werden.

Die Planhinweisliste sieht dann folgendermaßen aus:

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)';

Testen von Planhinweislisten mithilfe von SQL Server Profiler

Um zu überprüfen, ob eine Planhinweisliste mit einer Abfrage in Übereinstimmung gebracht wird, gehen Sie folgendermaßen vor:

  1. Starten Sie eine SQL Server Profiler-Ablaufverfolgung, und stellen Sie dabei sicher, dass der Showplan XML-Ereignistyp ausgewählt ist (dieser befindet sich unter dem Knoten Leistung).

  2. Führen Sie Abfrage mithilfe der Anwendung aus.

  3. Anhalten der Ablaufverfolgung (SQL Server Profiler)

  4. Suchen Sie das Showplan XML -Ereignis für die betroffene Abfrage.

    Hinweis

    Das Ereignis Showplan XML for Query Compile kann nicht verwendet werden. PlanGuideDB ist in diesem Ereignis nicht vorhanden.

  5. Wenn die Planhinweisliste vom Typ OBJECT oder SQL ist, überprüfen Sie, ob das Showplan XML -Ereignis die Attribute PlanGuideDB und PlanGuideName für die Planhinweisliste enthält, die mit der Abfrage übereinstimmen soll. Handelt es sich um eine Planhinweisliste vom Typ TEMPLATE, überprüfen Sie, ob das Showplan XML -Ereignis die Attribute TemplatePlanGuideDB und TemplatePlanGuideName für die erwartete Planhinweisliste enthält. Damit wird die Funktionsfähigkeit der Planhinweisliste überprüft. Diese Attribute sind im <StmtSimple>-Element der Planhinweisliste enthalten.

Weitere Informationen

sp_create_plan_guide (Transact-SQL)