Инструкция по установке ODBC-драйвера ClickHouse на Ubuntu 22.04

1. На сервере CH выполним команду:

clickhouse-client -uroot --ask-password --query "SELECT version()"

На основе вывода данной команды можно узнать версию ClickHouse.

2. Скачиваем архив ODBC-драйвера версии 1.4.3.20250807:

wget https://github.com/ClickHouse/clickhouse-odbc/releases/download/1.4.3.20250807/clickhouse-odbc-linux-Clang-UnixODBC-Release.zip

Выбор версии ODBC-драйвера зависит от версии ClickHouse.

3. Выполним установку зависимостей и распаковку скачанного архива:

apt install openssl libicu unixodbc unzip -y
unzip clickhouse-odbc-linux-Clang-UnixODBC-Release.zip -d clickhouse-odbc
cd clickhouse-odbc
tar -xzf clickhouse-odbc-1.4.3-Linux.tar.gz

4. Переместим файлы в другую директорию:

mkdir /opt/clickhouse-odbc
mv * /opt/clickhouse-odbc/
mv /opt/clickhouse-odbc/share/doc/clickhouse-odbc/config /opt/clickhouse-odbc/
rm -rf /opt/clickhouse-odbc/share

5. Отредактируем файл /opt/clickhouse-odbc/config/odbcinst.ini.sample:

# Insert the content of this file into ~/.odbcinst.ini or /etc/odbcinst.ini files,
# and fix the absolute paths to libclickhouseodbc.so and libclickhouseodbcw.so files.

[ODBC Drivers]
ClickHouse ODBC Driver (ANSI)    = Installed
ClickHouse ODBC Driver (Unicode) = Installed

[ClickHouse ODBC Driver (ANSI)]
Description = ODBC Driver (ANSI) for ClickHouse
Driver      = /opt/clickhouse-odbc/lib/libclickhouseodbc.so
Setup       = /opt/clickhouse-odbc/lib/libclickhouseodbc.so
UsageCount  = 1

[ClickHouse ODBC Driver (Unicode)]
Description = ODBC Driver (Unicode) for ClickHouse
Driver      = /opt/clickhouse-odbc/lib/libclickhouseodbcw.so
Setup       = /opt/clickhouse-odbc/lib/libclickhouseodbcw.so
UsageCount  = 1

6. Выполним установку драйвера:

odbcinst -i -d -f /opt/clickhouse-odbc/config/odbcinst.ini.sample
odbcinst -i -s -l -f /opt/clickhouse-odbc/config/odbc.ini.sample

7. В файле /etc/odbc.ini указываем параметры подключения:

[ODBC Data Sources]
ClickHouse DSN (ANSI)=ClickHouse ODBC Driver (ANSI)
ClickHouse DSN (Unicode)=ClickHouse ODBC Driver (Unicode)
MY-CH-01=ClickHouse ODBC Driver (Unicode)

[ClickHouse DSN (ANSI)]
Driver=ClickHouse ODBC Driver (ANSI)
Description=DSN (localhost) for ClickHouse ODBC Driver (ANSI)

[ClickHouse DSN (Unicode)]
Driver=ClickHouse ODBC Driver (Unicode)
Description=DSN (localhost) for ClickHouse ODBC Driver (Unicode)

[MY-CH-01]
Driver      = ClickHouse ODBC Driver (Unicode)
Server      = 1.2.3.4
Port        = 8123
Database    = example
Username    = example
Password    = example
Proto       = http
Timeout     = 30

6. Проверяем подключение:

isql -v "MY-CH-01"