Параметры возможностей драйвера для драйвера ODBC Databricks

На этой странице описывается настройка специальных и расширенных параметров возможностей драйвера для драйвера ODBC Databricks.

Драйвер ODBC Databricks предоставляет следующие специальные и расширенные параметры возможностей драйвера.

Установка исходной схемы в ODBC

Драйвер ODBC позволяет указать схему, задав для параметра Schema=<schema-name> конфигурацию соединения. Это эквивалентно инструкции USE <schema-name>.

Теги запросов для отслеживания

Это важно

Эта функция доступна в закрытой предварительной версии. Чтобы запросить доступ, обратитесь в вашу команду поддержки аккаунтов.

Прикрепите теги key-value к запросам SQL для отслеживания и анализа. Теги запросов отображаются в system.query.history таблице для идентификации и анализа запросов.

Чтобы добавить теги запросов в подключение, включите ssp_query_tags параметр в конфигурацию подключения ODBC:

Определите теги запросов как пары "ключ-значение", разделенные запятыми, где каждый ключ и значение разделены двоеточием. Например: ssp_query_tags=team:engineering,env:prod.

Необходимо также задать ApplySSPWithQueries=0 в конфигурации подключения драйвера ODBC.

Поддержка запросов ANSI SQL-92 в ODBC

Устаревшие драйверы ODBC Spark принимают sql-запросы в диалекте ANSI SQL-92 и переводят их в Databricks SQL перед отправкой на сервер.

Если приложение создает Databricks SQL напрямую или использует синтаксис, отличный от ANSI SQL-92, относящийся к Azure Databricks, задайте UseNativeQuery=1 в конфигурации подключения. Этот параметр передает запросы SQL подробным образом в Azure Databricks без перевода.

Извлечение результатов больших запросов в ODBC

Чтобы обеспечить оптимальную производительность при извлечении больших результатов запроса, используйте последнюю версию драйвера ODBC, которая включает следующие оптимизации.

Сериализация со стрелками в ODBC

Драйвер ODBC версии 2.6.15 и выше поддерживает оптимизированный формат сериализации результатов запросов, использующий Apache Arrow.

Облачная выборка в ODBC

Драйвер ODBC версии 2.6.17 и выше поддерживает Cloud Fetch, возможность получения результатов запроса через облачное хранилище, настроенное в развертывании Azure Databricks.

При выполнении запроса Azure Databricks сохраняет результаты в облачном хранилище рабочей области в виде сериализованных со стрелками файлов до 20 МБ. После завершения запроса драйвер отправляет запросы на получение, а Azure Databricks возвращает URL-адреса url-адреса подписанных URL-адресов сигнатуры доступа в файлы результатов. Затем драйвер использует эти URL-адреса для скачивания результатов непосредственно из хранилища Azure.

Cloud Fetch применяется только к результатам запроса размером более 1 МБ. Драйвер получает меньшие результаты непосредственно из Azure Databricks.

Azure Databricks автоматически мусор собирает накопленные файлы, помечая их на удаление через 24 часа и окончательно удаляя их через 24 часа.

Предварительные требования к сети

Если сеть является частной, необходимо настроить следующие параметры для работы Cloud Fetch:

• Разрешить *.blob.core.windows.net и *.store.core.windows.net в сетевой среде.
• Добавьте необходимые скачиваемый сертификат и отзыв в список разрешений.
• Если в учетной записи хранения рабочей области Azure Databricks включена поддержка брандмауэра, настройте шлюз данных virtual network data gateway или локальный шлюз данных для предоставления частного доступа к учетной записи хранения.

Чтобы отключить cloud Fetch, задайте EnableQueryResultDownload=0 в конфигурации подключения.

Диагностика медленных скачивание

LogLevel Задайте значение 4 (INFO) и LogPath полный путь к папке журнала, чтобы просмотреть метрики скорости скачивания Cloud Fetch. Скорость скачивания для каждого блока регистрируется в журналах драйвера, поэтому большие результирующие наборы создают несколько строк журнала. Драйвер также записывает предупреждение, когда скорость снижается примерно на 1 МБ/с. Эта функция доступна в версиях драйверов ODBC, выпущенных после ноября 2025 г.

Если скачивание замедлено или приостановлено, маркеры SAS могут истекать до завершения скачивания всех файлов результатов. Проверьте регулирование пропускной способности или перегрузку сети между клиентом и Хранилище BLOB-объектов Azure.

Включение ведения журналов

Чтобы включить ведение журнала в драйвере ODBC, задайте значению свойства LogLevel промежуточное значение между 1 (только серьезными событиями) и 6 (всеми действиями драйвера). LogPath Задайте свойству полный путь к папке, в которой требуется сохранить файлы журналов.

Дополнительные сведения см. в разделе Параметры ведения журналов, отличных от Windows в руководстве по драйверу ODBC Databricks.