mirror of
https://github.com/ClickHouse/ClickHouse.git
synced 2024-12-15 10:52:30 +00:00
8.4 KiB
8.4 KiB
sidebar_label | sidebar_position | keywords | description | slug | ||||||
---|---|---|---|---|---|---|---|---|---|---|
Java | 1 |
|
Java から ClickHouse への接続オプション | /ja/integrations/java |
import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; import CodeBlock from '@theme/CodeBlock';
Java クライアント概要
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 | ✗ | ✔ |
:::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 への移行で問題がある場合は、問題を作成 していただければ対応します!