バージョン: 2.1

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 構成で確認できます。

接続セキュリティ

データソースにグローバルに信頼された証明書がインストールされた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配下のTablesに対応します。マッピング関係は以下の通りです：

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への接続​

接続セキュリティ​

階層マッピング​

カラム型マッピング​

関連パラメータ​

よくある問題​