バージョン: 26.x

ClickHouse JDBCカタログ

Doris JDBC Catalogは、標準のJDBCインターフェースを介してClickHouseデータベースに接続することをサポートしています。このドキュメントでは、ClickHouseデータベース接続の設定方法について説明します。

JDBC Catalogの概要については、こちらを参照してください: JDBC カタログ概要

使用上の注意

ClickHouseデータベースに接続するには、以下が必要です

ClickHouseバージョン23.x以上（これより古いバージョンは完全にテストされていません）。
ClickHouseデータベース用のJDBCドライバー。最新版または指定バージョンのClickHouse JDBCドライバーはMaven Repositoryからダウンロードできます。ClickHouse JDBC Driverのバージョン0.4.6の使用を推奨します。
DorisのFEおよびBEノードとClickHouseサーバー間のネットワーク接続。デフォルトポートは8123です。

ClickHouseへの接続

CREATE CATALOG clickhouse PROPERTIES (
    'type' = 'jdbc',
    'user' = 'username',
    'password' = 'pwd',
    'jdbc_url' = 'jdbc:clickhouse://example.net:8123/',
    'driver_url' = 'clickhouse-jdbc-0.4.6-all.jar',
    'driver_class' = 'com.clickhouse.jdbc.ClickHouseDriver'
)

jdbc_url は、ClickHouse JDBC ドライバーに渡される接続情報とパラメータを定義します。サポートされるURLパラメータは、ClickHouse JDBC Driver 構成で確認できます。

Connection Security

データソースにグローバルに信頼された証明書がインストールされたTLSを設定している場合、jdbc_url プロパティに設定されたJDBC接続文字列にパラメータを追加することで、クラスターとデータソース間でTLSを有効にできます。

たとえば、jdbc_url 設定プロパティに ssl=true パラメータを追加してTLSを有効にします：

'jdbc_url' = 'jdbc:clickhouse://example.net:8123/db?ssl=true'

TLS設定オプションの詳細については、Clickhouse JDBC Driver Documentation SSL 構成 Sectionを参照してください。

階層マッピング

ClickHouseをマッピングする際、DorisのDatabaseはClickHouseのDatabaseに対応します。そして、DorisのDatabase配下のTableは、ClickHouseのそのDatabase配下のTableに対応します。マッピング関係は以下の通りです：

Doris	ClickHouse
カタログ	ClickHouse サーバー
Database	Database
Table	Table

カラム型マッピング

ClickHouse タイプ	Doris タイプ	Comment
bool	boolean
string	string
date/date32	date
datetime(S)/datetime64(S)	datetime(S)
float32	float
float64	double
int8	tinyint
int16/uint8	smallint	DorisにはUNSIGNEDデータ型がないため、1段階大きくスケールアップします
int32/uInt16	int	上記と同様
int64/uint32	bigint	上記と同様
int128/uint64	largeint	上記と同様
int256/uint128/uint256	string	Dorisにはこの大きさのデータ型がないため、STRINGで処理します
decimal(P, S)	decimal(P, S) or string	Dorisがサポートする最大精度を超える場合は、stringで処理します
enum/ipv4/ipv6/uuid	string
array	array
other	UNSUPPORTED

よくある問題

Clickhouseデータを読み取る際にNoClassDefFoundError: net/jpountz/lz4/LZ4Factoryエラーメッセージが発生する

まずlz4-1.3.0.jarパッケージをダウンロードし、各FEとBEディレクトリのcustom_lib/ディレクトリに配置してください（存在しない場合は手動で作成してください）。

使用上の注意​

ClickHouseへの接続​

Connection Security​

階層マッピング​

カラム型マッピング​

関連パラメータ​

よくある問題​