ClickHouse JDBCカタログ

Doris JDBC カタログは、標準のJDBCインターフェースを介してClickHouseデータベースへの接続をサポートしています。本文書では、ClickHouseデータベース接続の設定方法について説明します。

JDBC カタログの概要については、以下を参照してください：JDBC カタログ概要

使用上の注意

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

ClickHouseバージョン23.x以上（これより下のバージョンは完全にテストされていません）。
ClickHouseデータベース用のJDBCドライバー。Maven RepositoryからClickHouse JDBCドライバーの最新版または指定版をダウンロードできます。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 Configurationで確認できます。

接続セキュリティ

データソースにグローバルに信頼された証明書がインストールされた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 Configuration Sectionを参照してください。

階層マッピング

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

Doris	ClickHouse
Catalog	ClickHouse Server
Database	Database
Table	Table

カラムタイプマッピング

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

接続セキュリティ​

階層マッピング​

カラムタイプマッピング​

関連パラメータ​

よくある問題​