ClickHouse が ODBC 経由で外部データベースに接続できるようにします。
ODBC 接続を安全に実現するため、ClickHouse は clickhouse-odbc-bridge という別プロセスを使用します。ODBC ドライバを clickhouse-server から直接読み込むと、ドライバの問題によって ClickHouse サーバーがクラッシュする可能性があります。ClickHouse は必要に応じて clickhouse-odbc-bridge を自動的に起動します。ODBC ブリッジプログラムは、clickhouse-server と同じパッケージに含まれています。
このエンジンは Nullable データ型をサポートしています。
CREATE TABLE クエリの詳細な説明を参照してください。
テーブル構造は、元のテーブルの構造と異なる場合があります。
- カラム名は元のテーブルと同じである必要がありますが、それらの一部のカラムだけを任意の順序で使用できます。
- カラムの型は、元のテーブルのものと異なっていてもかまいません。ClickHouse は値を ClickHouse のデータ型に cast しようとします。
- external_table_functions_use_nulls 設定は、Nullable カラムの扱い方を定義します。デフォルト値: 1。0 の場合、テーブル関数は Nullable カラムを作成せず、null の代わりにデフォルト値を挿入します。これは、配列内の NULL 値にも適用されます。
エンジンパラメータ
datasource — odbc.ini ファイル内の接続設定を含むセクション名。
external_database — 外部 DBMS 内のデータベース名。
external_table — external_database 内のテーブル名。
これらのパラメータは、named collections を使用して渡すこともできます。
ODBC 経由でローカルの MySQL インストールからデータを取得する
この例は、Ubuntu Linux 18.04 および MySQL server 5.7 で検証されています。
unixODBC と MySQL Connector がインストールされていることを確認してください。
デフォルトでは (パッケージからインストールした場合) 、ClickHouse は clickhouse ユーザーとして起動します。そのため、MySQL server 側でこのユーザーを作成し、設定する必要があります。
次に、/etc/odbc.ini で接続設定を行います。
unixODBC に含まれる isql ユーティリティを使用して、接続を確認できます。
MySQL のテーブル:
MySQL テーブルからデータを取得する ClickHouse のテーブル:
Last modified on August 14, 2026