Leistungsprofilerstellung des ODBC-Treibers

Gilt für: SQL Server Azure SQL-Datenbank Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)

Der SQL Server Native Client ODBC-Treiber kann zwei Arten von Leistungsdaten profilen:

• Abfragen mit langer Ausführungszeit

  Der Treiber kann jede Abfrage in eine Protokolldatei schreiben, die innerhalb eines angegebenen Zeitraums keine Antwort vom Server erhält. Anwendungsprogrammierer und Datenbankadministratoren können dann die protokollierten SQL-Anweisungen untersuchen, um zu ermitteln, wie sie die Leistung verbessern können.

• Treiberleistungsdaten

  Der Treiber kann Leistungsstatistiken aufzeichnen und entweder in eine Datei schreiben oder über eine treiberspezifische Datenstruktur namens SQLPERF einer Anwendung verfügbar machen. Die Datei mit den Leistungsstatistiken ist eine durch Tabstopps getrennte Datei, die mit jeder Tabellenkalkulationsanwendung, die durch Tabstopps getrennte Dateien unterstützt (beispielsweise Microsoft Excel), problemlos analysiert werden kann.

Beide Typen der Profilerstellung werden wie folgt aktiviert:

• Durch Herstellen einer Verbindung zu einer Datenquelle, die die Protokollierung angibt

• Aufrufen von SQLSetConnectAttr zum Festlegen treiberspezifischer Attribute, die die Profilerstellung steuern.

Jeder Anwendungsprozess erhält eine eigene Kopie des SQL Server Native Client ODBC-Treibers und die Profilerstellung ist global für die Kombination einer Treiberkopie und eines Anwendungsprozesses. Wenn die Profilerstellung in der Anwendung aktiviert wird, zeichnet die Profilerstellung Informationen über alle im Treiber dieser Anwendung aktiven Verbindungen auf. Das betrifft auch die Verbindungen, die die Profilerstellung nicht ausdrücklich angefordert haben.

Nachdem der Treiber ein Profilerstellungsprotokoll geöffnet hat (entweder das Protokoll für Leistungsdaten oder für eine Abfrage mit längerer Ausführungszeit), schließt er es erst wieder, wenn der Treiber vom ODBC-Treiber-Manager entladen wird, weil eine Anwendung alle Umgebungshandles freigibt, die sie im Treiber geöffnet hatte. Wenn die Anwendung ein neues Umgebungshandle öffnet, wird eine neue Kopie des Treibers geladen. Wenn die Anwendung dann entweder die Verbindung zu einer Datenquelle herstellt, die dieselbe Protokolldatei angibt, oder die treiberspezifischen Attribute auf die Protokollierung in derselben Datei festlegt, überschreibt der Treiber das alte Protokoll.

Wenn eine Anwendung mit der Profilerstellung in einer Protokolldatei beginnt und eine zweite Anwendung versucht, die Profilerstellung in derselben Protokolldatei zu beginnen, kann die zweite Anwendung keine Profildaten protokollieren. Wenn die zweite Anwendung mit der Profilerstellung beginnt, nachdem die erste Anwendung ihren Treiber entladen hat, überschreibt die zweite Anwendung die Protokolldatei der ersten Anwendung.

Wenn eine Anwendung eine Verbindung mit einer Datenquelle herstellt, die Profilerstellung aktiviert hat, gibt der Treiber SQL_ERROR zurück, wenn die Anwendung SQLSetConnectOption aufruft, um die Protokollierung zu starten. Ein Aufruf von SQLGetDiagRec gibt dann Folgendes zurück:

SQLState: 01000, pfNative = 0  
ErrorMsg: [Microsoft][SQL Server Native Client]  
   An error has occurred during the attempt to access  
   the log file, logging disabled.  

Der Treiber hört auf, Leistungsdaten zu erfassen, wenn ein Umgebungshandle geschlossen wird. Wenn eine SQL Server Native Client-Anwendung über mehrere Verbindungen verfügt, jedes mit einem eigenen Umgebungshandle, beendet der Treiber das Sammeln von Leistungsdaten, wenn eine der zugehörigen Umgebungshandles geschlossen wird.

Die Leistungsdaten des Treibers können entweder in der SQLPERF-Datenstruktur gespeichert oder in einer durch Tabstopps getrennten Datei protokolliert werden. Die Daten umfassen die folgenden Statistikkategorien:

• Anwendungsprofil

• Verbindung

• Network

• Zeit

In der folgenden Tabelle gelten die Beschreibungen der Felder in der SQLPERF-Datenstruktur auch für die in der Leistungsprotokolldatei erfassten Statistiken.

Anwendungsprofilstatistiken

Zeitstatistiken

Weitere Informationen

SQL Server Native Client (ODBC)
Themen zur Vorgehensweise zur Profilerstellung für die Treiberleistung (ODBC)