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

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:

См. также