chDB - ClickHouse Documentation

chDB は、ClickHouse v25.8.2.1 を基盤とする高速な in-process SQL OLAP Engine です。 ClickHouse server に接続しなくても、プログラミング言語から ClickHouse の機能を利用したい場合に使えます。

主な機能

In-process SQL OLAP Engine - ClickHouse を基盤とし、ClickHouse server を別途インストールする必要はありません
複数のデータフォーマット - Parquet、CSV、JSON、Arrow、ORC、さらに 70 種類以上のフォーマットでの Input / Output をサポート
データコピーを最小化 - python memoryview により、C++ から Python への受け渡しを効率化
豊富な Python エコシステムとのインテグレーション - Pandas、Arrow、DB API 2.0 をネイティブサポートし、既存のデータサイエンス workflow にシームレスに組み込めます
依存関係ゼロ - 外部 database をインストールする必要はありません
DataStore API - SQL 最適化を備えた pandas-compatible API で、630 以上の methods をサポート

DataStore: pandas互換API

NEW! DataStore は、使い慣れた pandas 構文と ClickHouse のパフォーマンスを組み合わせた pandas互換API を提供します。

Hex を使い始める

📖 スタートガイドチュートリアル — 最初の接続を設定する
🚀 Hex の30日間延長トライアル — ClickHouse インテグレーションへのフルアクセス

ワンライナーでの移行

# Just change your import - your pandas code works unchanged
- import pandas as pd
+ from chdb import datastore as pd

df = pd.read_csv("data.csv")
result = df[df['age'] > 25].groupby('city')['salary'].mean()

パフォーマンスの概要

操作	pandas	DataStore	高速化率
GroupBy count	347ms	17ms	19.93x
複雑なパイプライン	2,047ms	380ms	5.39x
Filter+Sort+Head	1,537ms	350ms	4.40x

1,000万行でのベンチマーク

DataStore の機能

630 を超える API メソッド - 209 個の pandas DataFrame メソッド、185 個超のアクセサメソッド
遅延実行 - 操作は最適化された SQL にコンパイルされます
SQL プッシュダウン - フィルターと集計はデータソース側で実行されます
幅広いデータソースに対応 - ファイル、S3、データベース、データレイクから読み取れます

詳しくは: DataStore ドキュメント

chDBはどの言語をサポートしていますか？

chDBは次の言語バインディングに対応しています。

はじめるには？

Go、Rust、NodeJS、Bun、または C/C++ を使用している場合は、それぞれの言語向けページを参照してください。
Python を使用している場合は、入門開発者ガイドまたは chDB オンデマンドコースを参照してください。

pandasユーザー向け

ClickHouseの性能を活かしながら、使い慣れたpandasのように扱うには、まずDataStore APIから始めてください。

DataStore クイックスタート - インストールとワンライナーでの移行
pandasからの移行 - ステップごとの移行ガイド
Pandas Cookbook - よく使われるパターン
主な違い - pandasとの重要な違い
パフォーマンスガイド - 最適化のヒント

DataStore API リファレンス

ファクトリメソッド - ファイル、データベース、クラウドストレージから作成
クエリ構築 - SQL スタイルの操作
Pandas 互換性 - 209 の対応メソッド
アクセサ - .str, .dt, .arr, .json, .url, .ip, .geo
設定 - エンジン、ログ、プロファイリング
デバッグ - explain()、プロファイリング、ログ

SQL API ガイド

chDB の紹介ビデオ

chDB の概要を短いビデオで紹介します。ClickHouse のパワーを Python 環境で活用する方法をご覧ください。

パフォーマンスベンチマーク

chDBは、さまざまなユースケースで優れたパフォーマンスを発揮します。

埋め込みエンジンの ClickBench - SQL API パフォーマンス比較
DataFrame Benchmark - DataFrameエンジンの比較
DataStore と Pandas - 一般的な操作では pandas より最大20倍高速

chDBについて

ブログで、chDBプロジェクト誕生の全貌をご覧ください
ブログで、chDBとそのユースケースについてご覧ください
chDBのオンデマンドコースを受講してください
codapi examplesを使って、ブラウザーでchDBを試してみてください
その他の例については、(https://github.com/chdb-io/chdb/tree/main/examples) を参照してください

ライセンス

chDB は Apache License 2.0 の下で提供されています。詳細については、LICENSE を参照してください。

​主な機能

​DataStore: pandas互換API

​ワンライナーでの移行

​パフォーマンスの概要

​DataStore の機能

​chDBはどの言語をサポートしていますか？

​はじめるには？

​pandasユーザー向け

​DataStore API リファレンス

​SQL API ガイド

​chDB の紹介ビデオ

​パフォーマンスベンチマーク

​chDBについて

​ライセンス

主な機能

DataStore: pandas互換API

ワンライナーでの移行

パフォーマンスの概要

DataStore の機能

chDBはどの言語をサポートしていますか？

はじめるには？

pandasユーザー向け

DataStore API リファレンス

SQL API ガイド

chDB の紹介ビデオ

パフォーマンスベンチマーク

chDBについて

ライセンス