chDB

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 をサポート

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

# 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()

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

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

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

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

• Python - API リファレンス
• Go
• Rust
• NodeJS
• Bun
• C と C++

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

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

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

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

• Python API リファレンス - SQL API の完全なドキュメント
• JupySQL
• Pandas のクエリ
• Apache Arrow のクエリ
• S3 内のデータのクエリ
• Parquet ファイルのクエリ
• リモート ClickHouse のクエリ
• clickhouse-local database の使用

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

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

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

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

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