Разработка драйвера ODBC с поддержкой пула подключений
В этом разделе рассматриваются сведения о разработке драйвера ODBC, содержащего сведения о том, как драйвер должен предоставлять службы пула подключений.
Включение пула Подключение с поддержкой драйверов
Драйвер должен реализовать следующие функции интерфейса поставщика служб ODBC (SPI):
SQLSet Подключение AttrForDbcInfo
SQLSet Подключение Info
SQLSetDriver Подключение Info
SQLGetPoolID
SQLRate Подключение ion
SQLPool Подключение
SQLCleanup Подключение ionPoolID
Дополнительные сведения см . в справочнике по интерфейсу поставщика услуг ODBC (SPI).
Драйвер также должен реализовать следующие существующие функции, чтобы включить пул с поддержкой драйверов:
| Function | Добавлена функциональность |
|---|---|
| SQLAllocHandle SQLFreeHandle SQLGetDiagField SQLGetDiagRec |
Поддержка нового типа дескриптора: SQL_HANDLE_DBC_INFO_TOKEN (см. описание ниже). |
| SQLSetConnectAttr | Поддержка нового атрибута подключения только для набора: SQL_ATTR_DBC_INFO_TOKEN для сброса подключения (см. описание ниже). |
Примечание.
Устаревшие функции, такие как SQLError и SQLSet Подключение Option не поддерживаются для пула подключений с поддержкой драйверов.
Идентификатор пула
Идентификатор пула — это идентификатор драйвера, зависящего от указателя, который представляет определенную группу подключений, которые можно использовать взаимозаменяемо. Учитывая набор сведений о подключении, драйвер должен быстро выводить соответствующий идентификатор пула.
Например, идентификатор пула должен кодировать имя сервера и учетные данные. Однако имя базы данных не требуется, так как драйвер может повторно использовать подключение, а затем изменить базу данных в меньшее время, чем создать новое подключение.
Драйвер должен определить набор ключевых атрибутов, который будет содержать идентификатор пула. Значение этих ключевых атрибутов может поступать из атрибутов подключения, строка подключения и DSN. Если в этих источниках существуют конфликты, существующая политика разрешения для конкретного драйвера должна использоваться для обратной совместимости.
Диспетчер драйверов будет использовать другой пул для различных идентификаторов пула. Все подключения в одном пуле можно использовать повторно. Диспетчер драйверов никогда не будет повторно использовать подключение с другим идентификатором пула.
Поэтому драйверы должны назначать уникальный идентификатор пула для каждой группы подключений с одинаковым значением в определенных ключевых атрибутах. Если драйвер использует один и тот же идентификатор пула для двух подключений с разными значениями в своих ключевых атрибутах, диспетчер драйверов по-прежнему помещает их в один пул (диспетчер драйверов ничего не знает об атрибутах ключа для конкретного драйвера). Это означает, что драйверу потребуется сообщить диспетчеру драйверов, что соединение с другим набором ключевых атрибутов не используется повторно внутри функции SQLRate Подключение ion. Это может снизить производительность, и это не рекомендуется.
Диспетчер драйверов не будет повторно использовать подключение, выделенное из другой среды драйвера, даже если все сведения о подключении совпадают. Диспетчер драйверов будет использовать другой пул для разных сред, даже если подключения имеют один и тот же идентификатор пула. Таким образом, идентификатор пула является локальным для среды драйвера.
Функция получения идентификатора пула от драйвера — функция SQLGetPoolID.
Оценка Подключение
По сравнению с установкой нового подключения можно повысить производительность, сбросив некоторые сведения о подключении (например, DATABASE) в пуле. Таким образом, возможно, имя базы данных не должно находиться в наборе ключевых атрибутов. В противном случае для каждой базы данных может быть отдельный пул, который не может быть хорошим в приложениях среднего уровня, где клиенты используют различные строка подключения.
При повторном использовании соединения с несоответствием атрибутов следует сбросить несовпаденные атрибуты на основе нового запроса приложения, чтобы возвращенное подключение было идентично запросу приложения (см. обсуждение атрибута SQL_ATTR_DBC_INFO_TOKEN в SQLSet Подключение Attr Function). Однако сброс этих атрибутов может снизить производительность. Например, для сброса базы данных требуется сетевой вызов к серверу. Поэтому повторно используйте соединение, которое идеально соответствует, если он доступен.
Функция оценки в драйвере может оценить существующее соединение с новым запросом на подключение. Например, функция оценки драйвера может определить следующее:
Если существующее подключение идеально соответствует запросу.
Если существует только некоторые незначительные несоответствия, такие как время ожидания подключения, которые не требуют связи с сервером для сброса.
Если существуют некоторые несовпадения атрибутов, которые требуют обмена данными с сервером для сброса, но по-прежнему приводят к повышению производительности, чем при установке нового подключения.
Если произошло несоответствие для атрибута, который очень занимает много времени для сброса (разработчик драйвера может рассмотреть возможность добавления этого атрибута в набор ключевых атрибутов, который используется для создания идентификатора пула).
Оценка от 0 до 100 возможна, где 0 означает не повторно использовать и 100 означает идеально совпадать. SQLRate Подключение ion — это функция для оценки соединения.
Новый дескриптор ODBC — SQL_HANDLE_DBC_INFO_TOKEN
Для поддержки пула подключений с поддержкой драйверов драйверу требуется информация о подключении для вычисления идентификатора пула. Драйвер также нуждается в сведениях о подключении для сравнения новых запросов подключения с подключениями в пуле. Всякий раз, когда подключение в пуле невозможно повторно использовать, драйвер должен установить новое подключение, поэтому требуется информация о подключении.
Так как сведения о подключении могут поступать из нескольких источников (строка подключения, атрибутов подключения и DSN), драйвер может потребоваться проанализировать строка подключения и устранить конфликт между этими источниками в каждом из приведенных выше вызовов функции.
Таким образом, появился новый дескриптор ODBC: SQL_HANDLE_DBC_INFO_TOKEN. При использовании SQL_HANDLE_DBC_INFO_TOKEN драйвер не должен анализировать строка подключения и разрешать конфликты в сведениях о подключении более одного раза. Так как это структура данных для конкретного драйвера, драйвер может хранить такие данные, как сведения о подключении или идентификатор пула.
Этот дескриптор используется только в качестве интерфейса между диспетчером драйверов и драйвером. Приложение не может напрямую выделить этот дескриптор.
Родительский дескриптор этого дескриптора имеет тип SQL_HANDLE_ENV, что означает, что драйвер может получить сведения о среде из дескриптора HENV во время разрешения сведений о подключении.
Когда он получает новый запрос на подключение, диспетчер драйверов выделяет дескриптор типа SQL_HANDLE_DBC_INFO_TOKEN для хранения сведений о подключении, после подтверждения того, что драйвер поддерживает осведомленность пула подключений. После завершения использования дескриптора (но перед возвратом некоторых кодов возврата, отличных от SQL_STILL_EXECUTING из SQLDriver Подключение или SQL Подключение), диспетчер драйверов освободит дескриптор. Поэтому дескриптор создается после вызова SQLAllocHandle и уничтожается после вызова SQLFreeHandle. Диспетчер драйверов гарантирует, что дескриптор будет освобожден перед освобождением связанного HENV (когда SQLDriver Подключение или SQL Подключение возвращает ошибку).
Драйвер должен изменить следующие функции, чтобы принять новый тип дескриптора SQL_HANDLE_DBC_INFO_TOKEN:
Диспетчер драйверов гарантирует, что одновременно несколько потоков не будут использовать один и тот же SQL_HANDLE_DBC_INFO_TOKEN дескриптор. Поэтому модель синхронизации этого дескриптора может быть очень простой внутри драйвера. Диспетчер драйверов не будет блокировать среду перед выделением и освобождением SQL_HANDLE_DBC_INFO_TOKEN.
SqlAllocHandle и SQLFreeHandle диспетчера драйверов не принимают этот новый тип дескриптора.
SQL_HANDLE_DBC_INFO_TOKEN может содержать конфиденциальную информацию, например учетные данные. Таким образом, драйвер должен безопасно очистить буфер памяти (с помощью SecureZeroMemory), который содержит конфиденциальную информацию перед выпуском этого дескриптора с помощью SQLFreeHandle. При закрытии дескриптора среды приложения все связанные пулы соединений будут закрыты.
Алгоритм оценки пула Подключение диспетчера драйверов
В этом разделе описывается алгоритм оценки для пула подключений Диспетчера драйверов. Разработчики драйверов могут реализовать тот же алгоритм для обратной совместимости. Этот алгоритм может быть не лучшим. Этот алгоритм следует уточнить на основе реализации (в противном случае нет причин для реализации этой функции).
Диспетчер драйверов возвращает целочисленную оценку от 0 до 100 для каждого подключения из пула. 0 означает, что подключение не может быть повторно использовано, и 100 указывает на идеальное соответствие. Предположим, что запрос на подключение называется hRequest, а существующее подключение из пула называется hCandidate. Если одно из следующих условий имеет значение false, подключение в пуле hCandidate нельзя повторно использовать для hRequest (диспетчер драйверов назначит рейтинг 0).
hCandidate и hRequest поступают из API ЮНИКОДа (например, SQLDriver Подключение W) или API ANSI (например, SQLDriver Подключение A). (Драйверы ЮНИКОД могут выполнять различные действия с помощью API ANSI и API ЮНИКОДа (см. атрибут подключения SQL_ATTR_ANSI_APP).)
hCandidate и hRequest создаются той же функцией; SQLDriver Подключение или SQL Подключение.
Строка подключения, используемый для открытия hCandidate, должен совпадать с hRequest, если используется SQLDriver Подключение.
Имя сервера (или DSN), имя пользователя и пароль, используемые для открытия hCandidate, должны быть одинаковыми для открытия hRequest при использовании SQL Подключение.
Идентификатор безопасности (SID) текущего потока должен совпадать с идентификатором безопасности, используемым для открытия hCandidate.
Для драйвера, который требуется запросить и отменить регистрацию (см. обсуждение SQL_DTC_TRANSITION_COST в SQL Подключение), повторное использование hRequest не должно требовать дополнительного зачисления или отмены регистрации.
В следующей таблице показано назначение оценки для различных сценариев.
| Сравнение атрибутов подключения между подключением в пуле и запросом | Нет перечисления или отмены регистрации | Требовать дополнительное перечисление / отмена списка |
|---|---|---|
| Каталог (SQL_ATTR_CURRENT_CATALOG) отличается | 60 | 50 |
| Некоторые атрибуты подключения отличаются, но каталог совпадает | 90 | 70 |
| Все атрибуты подключения идеально совпадают | 100 | 80 |
Диаграмма последовательностей
На этой схеме последовательности показан базовый механизм объединения, описанный в этом разделе. Он показывает только использование SQLDriver Подключение но sql Подключение случай аналогичен.
Диаграмма состояний
На этой схеме состояния показан объект маркера сведений о подключении, описанный в этом разделе. На схеме показан только SQLDriver Подключение но sql Подключение случай аналогичен. Так как диспетчер драйверов может в любое время обрабатывать ошибки, диспетчер драйверов может вызывать SQLFreeHandle для любого состояния.
См. также
Организация пулов соединений с учетом драйвера
Справочник по интерфейсу службы доступа (SPI) ODBC
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по