Параметры функциональных возможностей для драйвера ODBC Databricks (Simba)

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

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

• Установка исходной схемы в ODBC
• Теги запросов для отслеживания
• Поддержка запросов ANSI SQL-92 в ODBC
• Извлечение результатов больших запросов в ODBC
• Сериализация со стрелками в ODBC
• Облачная выборка в ODBC
• Включение ведения журналов

Установка исходной схемы в 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.

Поддержка запросов 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 отправляет результаты во внутреннее расположение хранилища DBFS в виде сериализованных со стрелками файлов размером до 20 МБ. После завершения запроса драйвер отправляет запросы на получение, а Azure Databricks возвращает подписи для совместного доступа к загруженным файлам. Затем драйвер использует эти URL-адреса для скачивания результатов непосредственно из DBFS.

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

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

Дополнительные сведения об архитектуре облачной выборки см. в разделе Как обеспечить подключение с высокой пропускной способностью с помощью средств бизнес-аналитики.

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

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

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