ODBC
Позволяет 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: