Skip to main content
chDB-goはchDB用のGoバインディングで、Goアプリケーションから外部依存関係なしでClickHouseクエリを直接実行できます。

インストール

1

libchdb をインストール

まず、chDB ライブラリをインストールします。
2

chdb-go をインストール

Go パッケージをインストールします。
または、go.mod に追加します。

使い方

コマンドラインインターフェイス

chDB-go には、簡単なクエリをすばやく実行できる CLI が含まれています。

Goライブラリ - クイックスタート

ステートレスなクエリ

単純な単発のクエリの場合:

セッションを使用するステートフルクエリ

永続的な状態を伴う複雑なクエリの場合:

SQLドライバーインターフェイス

chDB-go は Go の database/sql インターフェイスを実装しています。

大規模なデータセット向けのクエリストリーミング

メモリに収まらない大規模なデータセットを処理するには、クエリストリーミングを使用します。
クエリストリーミングの利点:
  • メモリ効率が高い - すべてをメモリに読み込まなくても大規模なデータセットを処理できます
  • リアルタイム処理 - 最初の chunk が到着したらすぐにデータ処理を開始できます
  • キャンセル対応 - Cancel() を使って長時間実行されるクエリをキャンセルできます
  • エラー処理 - ストリーミング中に Error() でエラーを確認できます

APIドキュメント

chDB-go は、高レベル API と低レベル API の両方を提供しています。

システム要件

  • Go 1.21 以降
  • Linux、macOS 対応
最終更新日 2026年7月23日