chdb SQL — ClickHouse in Your Python Process
Run ClickHouse SQL directly in Python — no server needed. Query local files, remote databases, and cloud storage with full ClickHouse SQL power.
Decision Tree: Pick the Right API
chdb.query() — One Line, Any Data
Table functions → table-functions.md [blocked] | SQL functions → sql-functions.md [blocked] | Full API → api-reference.md [blocked]
Session — Stateful Analysis Pipelines
Connection API (DB-API 2.0)
Troubleshooting
References
- API Reference [blocked] — query/Session/connect signatures
- Table Functions [blocked] — All ClickHouse table functions
- SQL Functions [blocked] — Commonly used SQL functions
- Examples [blocked] — 9 runnable examples with expected output
- Official Docs
Note: This skill teaches how to use chdb SQL. For pandas-style operations, use the
chdb-datastoreskill. For contributing to chdb source code, see CLAUDE.md in the project root.
