ClickHouse/docs/ja/integrations/language-clients/java/index.md

sidebar_label	sidebar_position	keywords	description	slug
Java	1	clickhouse java jdbc client integrate r2dbc	Java から ClickHouse への接続オプション	/ja/integrations/java

import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; import CodeBlock from '@theme/CodeBlock';

Java クライアント概要

• Client-V2
• Client-V1 (旧版)
• JDBC ドライバー
• R2DBC ドライバー

ClickHouse クライアント

Java クライアントは、ClickHouse サーバーとのネットワーク通信の詳細を抽象化する独自の API を実装するライブラリです。現在、HTTP インターフェースのみサポートされています。このライブラリは、様々な ClickHouse フォーマットおよび関連する機能を扱うためのユーティリティを提供します。

Java クライアントは 2015 年に開発されました。そのコードベースは非常に維持しにくく、API は混乱し、これ以上最適化するのが難しくなりました。そのため、2024 年に新しいコンポーネント client-v2 へのリファクタリングを行いました。これには、明確な API、より軽量なコードベース、パフォーマンスの向上、より良い ClickHouse フォーマットサポート（主に RowBinary と Native）が含まれます。JDBC は近い将来このクライアントを使用する予定です。

サポートされているデータタイプ

データタイプ	Client V2 サポート	Client V1 サポート
Int8	✔	✔
Int16	✔	✔
Int32	✔	✔
Int64	✔	✔
Int128	✔	✔
Int256	✔	✔
UInt8	✔	✔
UInt16	✔	✔
UInt32	✔	✔
UInt64	✔	✔
UInt128	✔	✔
UInt256	✔	✔
Float32	✔	✔
Float64	✔	✔
Decimal	✔	✔
Decimal32	✔	✔
Decimal64	✔	✔
Decimal128	✔	✔
Decimal256	✔	✔
Bool	✔	✔
String	✔	✔
FixedString	✔	✔
Nullable	✔	✔
Date	✔	✔
Date32	✔	✔
DateTime	✔	✔
DateTime32	✔	✔
DateTime64	✔	✔
Interval	✗	✗
Enum	✔	✔
Enum8	✔	✔
Enum16	✔	✔
Array	✔	✔
Map	✔	✔
Nested	✔	✔
Tuple	✔	✔
UUID	✔	✔
IPv4	✔	✔
IPv6	✔	✔
Object	✗	✔
Point	✔	✔
Nothing	✔	✔
MultiPolygon	✔	✔
Ring	✔	✔
Polygon	✔	✔
SimpleAggregateFunction	✔	✔
AggregateFunction	✗	✔

ClickHouse データタイプ

:::note

• AggregatedFunction - ⚠️ SELECT * FROM table ... はサポートされていません
• Decimal - 一貫性のために 21.9+ で SET output_format_decimal_trailing_zeros=1 を使用
• Enum - 文字列および整数の両方として扱うことができます
• UInt64 - client-v1 では long にマッピングされます :::

機能

クライアントの機能の表:

名称	Client V2	Client V1	コメント
Http 接続	✔	✔
Http 圧縮（LZ4）	✔	✔
サーバー応答の圧縮 - LZ4	✔	✔
クライアント要求の圧縮 - LZ4	✔	✔
HTTPs	✔	✔
クライアント SSL 証明書 (mTLS)	✔	✔
Http プロキシ	✔	✔
POJO シリアライズ・デシリアライズ	✔	✗
コネクションプール	✔	✔	Apache HTTP クライアントを使用する場合
名前付きパラメータ	✔	✔
失敗時のリトライ	✔	✔
フェイルオーバー	✗	✔
ロードバランシング	✗	✔
サーバー自動検出	✗	✔
ログコメント	✗	✔
セッションロール	✗	✔	V2 で導入予定
SSL クライアント認証	✗	✔	V2 で導入予定
セッションタイムゾーン	✔	✔

JDBC ドライバーは、基盤となるクライアント実装と同様の機能を継承します。他の JDBC の機能はその ページ に記載されています。

互換性

• このリポジトリ内のすべてのプロジェクトは、すべての アクティブな LTS バージョン の ClickHouse でテストされています。
• サポートポリシー
• セキュリティ修正や新たな改善を逃さないよう、クライアントを継続的にアップグレードすることをお勧めします
• v2 API への移行で問題がある場合は、問題を作成 していただければ対応します！