Создание профилей производительности драйвера ODBC
Применимо: 
SQL Server База данных SQL Azure Управляемый экземпляр SQL Azure azure Synapse Analytics Analytics Platform System (PDW)
Внимание
SQL Server Native Client (SNAC) не поставляется с:
- SQL Server 2022 (16.x) и более поздних версий
- SQL Server Management Studio 19 и более поздних версий
Собственный клиент SQL Server (SQLNCLI или SQLNCLI11) и устаревший поставщик Microsoft OLE DB для SQL Server (SQLOLEDB) не рекомендуется для разработки новых приложений.
Для новых проектов используйте один из следующих драйверов:
Сведения о SQLNCLI, которые поставляется в качестве компонента SQL Server ядро СУБД (версии 2012–2019), см. в этом исключении жизненного цикла поддержки.
Драйвер ODBC собственного клиента SQL Server может профилирование двух типов данных производительности:
Длительные запросы.
Драйвер может записывать в файл журнала любой запрос, который не получает ответа от сервера в течение заданного промежутка времени. Прикладные программисты или администраторы баз данных могут исследовать каждую записанную в журнал инструкцию SQL, чтобы определить, как повысить производительность.
Данные о производительности драйвера.
Драйвер может регистрировать статистику производительности и либо записывать ее в файл, либо раскрывать ее для приложения с помощью специфической собственной структуры драйвера, называемой SQLPERF. Файл, содержащий статистику производительности, использует в качестве разделителей знаки табуляции. Этот файл можно легко проанализировать с помощью электронной таблицы, поддерживающей знаки табуляции в качестве разделителей, такой как Microsoft Excel.
Оба типа профилирования можно включить одним из следующих способов.
Соединение с источником данных, настроенным для ведения журнала.
Вызов SQLSetConnectAttr для задания атрибутов, относящихся к драйверу, которые управляют профилированием.
Каждый процесс приложения получает собственную копию драйвера ODBC собственного клиента SQL Server, а профилирование — глобальное сочетание копии драйвера и процесса приложения. Если какое-либо действие приложения включает профилирование, записываются сведения для всех активных соединений с драйвером из этого приложения. Включаются даже соединения, которые сами не определяли профилирование.
После того как драйвер открывает журнал профилирования (журнал данных о производительности либо журнал длительных запросов), он не закрывает журнал, пока сам не будет выгружен диспетчером драйверов ODBC, когда приложение освободит все дескрипторы, открытые в драйвере. Если приложение открывает новый дескриптор среды, загружается новая копия драйвера. Если приложение затем подключается к источнику данных, указывающему тот же файл журнала или задающему запись атрибутов драйвера в тот же файл журнала, драйвер перезаписывает старый журнал.
Если приложение начинает профилирование в файл журнала, а другое приложение выполняет попытку профилирования в тот же файл журнала, второму приложению не удастся записать в журнал какие-либо данные профилирования. Если второе приложение запускает профилирование после выгрузки драйвера первым приложением, второе приложение перезаписывает файл журнала первого приложения.
Если приложение подключается к источнику данных с включенным профилированием, драйвер возвращает SQL_ERROR, если приложение вызывает SQLSetConnectOption для запуска ведения журнала. Затем вызов SQLGetDiagRec возвращает следующее:
SQLState: 01000, pfNative = 0
ErrorMsg: [Microsoft][SQL Server Native Client]
An error has occurred during the attempt to access
the log file, logging disabled.
Драйвер прекращает собирать данные при закрытии дескриптора среды. Если приложение собственного клиента SQL Server имеет несколько подключений, каждое из которых имеет собственный дескриптор среды, драйвер перестанет собирать данные о производительности при закрытии любого из связанных дескрипторов среды.
Данные о производительности драйвера могут сохраняться в структуре данных SQLPERF или записываться в файл со знаками табуляции в качестве разделителей. Эти данные содержат следующие категории статистики.
Профиль приложения
Connection
Network
Время
В следующей таблице приведены описания полей структуры данных SQLPERF, также относящиеся к файлу журнала производительности.
Статистика профиля приложения
| Поле SQLPERF | Description |
|---|---|
| TimerResolution | Минимальное разрешение времени с часов сервера в миллисекундах. Обычно возвращается 0 (ноль). Это значение учитывается только в тех случаях, когда сообщается большое число. Если минимальное разрешение часов сервера больше, чем вероятные интервалы какой-либо статистики по таймеру, эти статистические данные могут оказаться завышенными. |
| SQLidu | Количество инструкций INSERT, DELETE и UPDATE после SQL_PERF_START. |
| SQLiduRows | Количество инструкций INSERT, DELETE и UPDATE после SQL_PERF_START. |
| SQLSelects | Количество инструкций SELECT, обработанных после SQL_PERF_START. |
| SQLSelectRows | Количество строк, выбранных после SQL_PERF_START. |
| Транзакции | Количество пользовательских транзакций после SQL_PERF_START, включая откаты. Если приложение ODBC запущено с параметром SQL_AUTOCOMMIT_ON, каждая команда считается транзакцией. |
| SQLPrepares | Количество вызовов функции SQLPrepare после SQL_PERF_START. |
| ExecDirects | Количество вызовов SQLExecDirect после SQL_PERF_START. |
| SQLExecutes | Количество вызовов SQLExecute после SQL_PERF_START. |
| CursorOpens | Количество открытий драйвером серверного курсора после SQL_PERF_START. |
| CursorSize | Количество строк в результирующих наборах, открытых курсором после SQL_PERF_START. |
| CursorUsed | Количество строк, фактически полученных с помощью драйвера от курсоров после SQL_PERF_START. |
| PercentCursorUsed | Равно CursorUsed/CursorSize. Например, если приложение вынуждает драйвер открыть серверный курсор для выполнения команды SELECT COUNT(*) FROM Authors, в результирующем наборе инструкции SELECT будет содержаться 23 строки. Если приложение затем выберет только три из этих строк, то CursorUsed/CursorSize равно 3/23, поэтому PercentCursorUsed составляет 13.043478. |
| AvgFetchTime | Равно SQLFetchTime/SQLFetchCount. |
| AvgCursorSize | Равно CursorSize/CursorOpens. |
| AvgCursorUsed | Равно CursorUsed/CursorOpens. |
| SQLFetchTime | Общее количество времени, потребовавшегося для выборки из серверных курсоров. |
| SQLFetchCount | Количество выборок, выполненных из серверных курсоров после SQL_PERF_START. |
| CurrentStmtCount | Количество дескрипторов инструкций, открытых в настоящее время для всех открытых в драйвере соединений. |
| MaxOpenStmt | Максимальное количество одновременно открытых дескрипторов инструкций после SQL_PERF_START. |
| SumOpenStmt | Количество дескрипторов инструкций, открытых после SQL_PERF_START. |
| Статистика подключения: | |
| CurrentConnectionCount | Текущее количество активных дескрипторов соединений, открытых приложением для сервера. |
| MaxConnectionsOpened | Максимальное количество одновременно открытых дескрипторов соединений после SQL_PERF_START. |
| SumConnectionsOpened | Общее количество дескрипторов соединений, открытых после SQL_PERF_START. |
| SumConnectionTime | Общее количество времени, в течение которого были открыты соединения, после SQL_PERF_START. Например, если приложение открыло 10 соединений и поддерживало каждое соединение в течение 5 секунд, значение SumConnectionTime будет равно 50 секунд. |
| AvgTimeOpened | Равно SumConnectionsOpened/ SumConnectionTime. |
| Статистика сети: | |
| ServerRndTrips | Количество раз, когда драйвер отправлял команды на сервер и получал ответ. |
| BuffersSent | Количество пакетов табличного потока данных (TDS), отправленных в SQL Server драйвером после SQL_PERF_START. Большие команды могут занимать несколько буферов, поэтому если на сервер отправляется большая команда, занимающая шесть пакетов, значение ServerRndTrips увеличивается на 1, а значение BuffersSent — на 6. |
| BuffersRec | Количество пакетов TDS, полученных драйвером из SQL Server после запуска приложения с помощью драйвера. |
| BytesSent | Количество байтов данных, отправленных в SQL Server в пакетах TDS после запуска приложения с помощью драйвера. |
| BytesRec | Количество байтов данных в пакетах TDS, полученных драйвером из SQL Server после запуска приложения с помощью драйвера. |
Статистика по времени
| Поле SQLPERF | Description |
|---|---|
| msExecutionTime | Общее количество времени, затраченного драйвером на обработку после SQL_PERF_START, включая время на ожидание ответов от сервера. |
| msNetworkServerTime | Общее количество времени, затраченного драйвером на ожидание ответов от сервера. |
См. также
SQL Server Native Client (ODBC)
Инструкции по измерению производительности драйвера ODBC (ODBC)