Skip to main content
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 値にも適用されます。
エンジンパラメータ
  • datasourceodbc.ini ファイル内の接続設定を含むセクション名。
  • external_database — 外部 DBMS 内のデータベース名。
  • external_tableexternal_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 のテーブル:

関連項目

最終更新日 2026年7月24日