Перейти к основному содержимому
Перейти к основному содержимому

ODBC

Not supported in ClickHouse Cloud

Позволяет ClickHouse подключаться к внешним базам данных через ODBC.

Для безопасной реализации ODBC подключений ClickHouse использует отдельную программу clickhouse-odbc-bridge. Если ODBC драйвер загружается напрямую из clickhouse-server, проблемы с драйвером могут привести к сбою сервера ClickHouse. ClickHouse автоматически запускает clickhouse-odbc-bridge, когда это необходимо. Программа ODBC моста устанавливается из того же пакета, что и clickhouse-server.

Этот движок поддерживает Nullable тип данных.

Создание таблицы​

Смотрите подробное описание запроса CREATE TABLE.

Структура таблицы может отличаться от структуры исходной таблицы:

  • Имена колонок должны быть такими же, как в исходной таблице, но вы можете использовать только некоторые из этих колонок и в любом порядке.
  • Типы колонок могут отличаться от типов в исходной таблице. ClickHouse пытается преобразовать значения в типы данных ClickHouse.
  • Настройка external_table_functions_use_nulls определяет, как обрабатывать Nullable колонки. Значение по умолчанию: 1. Если 0, табличная функция не создает Nullable колонки и вставляет значения по умолчанию вместо null. Это также применимо к значениям NULL внутри массивов.

Параметры движка

  • connection_settings — Имя секции с настройками подключения в файле odbc.ini.
  • external_database — Имя базы данных во внешней СУБД.
  • external_table — Имя таблицы в external_database.

Пример использования​

Получение данных из локальной установки MySQL через ODBC

Этот пример проверен на Ubuntu Linux 18.04 и MySQL сервере 5.7.

Убедитесь, что unixODBC и MySQL Connector установлены.

По умолчанию (если установлено из пакетов) ClickHouse запускается как пользователь clickhouse. Поэтому вам нужно создать и настроить этого пользователя в MySQL сервере.

Затем настройте подключение в /etc/odbc.ini.

Вы можете проверить подключение с помощью утилиты isql из установки unixODBC.

Таблица в MySQL:

Таблица в ClickHouse, получение данных из таблицы MySQL:

См. также​