Позволяет 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 внутри массивов.
Параметры движка
datasource — имя раздела с настройками подключения в файле odbc.ini.
external_database — имя базы данных во внешней СУБД.
external_table — имя таблицы в external_database.
Эти параметры также можно передавать с помощью именованных коллекций.
Получение данных из локально установленного MySQL через ODBC
Этот пример протестирован на Ubuntu Linux 18.04 и сервере MySQL 5.7.
Убедитесь, что установлены unixODBC и MySQL Connector.
По умолчанию (если ClickHouse установлен из пакетов) ClickHouse запускается от имени пользователя clickhouse. Поэтому вам нужно создать и настроить этого пользователя на сервере MySQL.
Затем настройте соединение в /etc/odbc.ini.
Вы можете проверить соединение с помощью утилиты isql, входящей в состав unixODBC.
Таблица в MySQL:
Таблица в ClickHouse, которая получает данные из таблицы MySQL:
Последнее изменение 24 июля 2026 г.