用途：在 Python 进程内直接运行 ClickHouse SQL，无需部署服务器，即可对本地文件、远程数据库和云存储做分析型查询。
主要能力：支持查询本地 parquet/csv/json 文件、URL、S3 路径、Delta Lake 数据湖，以及 Postgres、MySQL 等远程数据库；支持跨数据源 JOIN；可查询 Python 字典数据；输出支持 DataFrame 等格式；支持参数化查询。
使用方式：先安装 pip install chdb。按场景选择 API：一次性查询用 chdb.query()；多步分析用 Session（可持久化或内存态）；DB-API 2.0 用 chdb.connect()；Pandas 风格操作应改用 chdb-datastore 技能。示例：chdb.query("SELECT * FROM file('data.parquet', Parquet) WHERE price > 100 LIMIT 10")；chdb.query("SELECT * FROM mysql('db:3306', 'shop', 'orders', 'root', 'pass')")；chdb.query("SELECT * FROM s3('s3://bucket/data.parquet', NOSIGN) LIMIT 10")。Session 用法：from chdb import session as chs; sess = chs.Session("./analytics_db")，可建表并跨源关联，最后 sess.close()。
适用场景：本地文件与云存储的即席分析、跨数据库与文件的联合查询、Python 数据探索。
限制：需已安装 chdb；文件路径错误会报 FILE_NOT_FOUND，表函数名拼写需正确（如 deltaLake）；远程数据库连接需检查 host:port 并确保允许连接。Pandas 风格操作请用 chdb-datastore 技能，贡献源码见项目根目录 CLAUDE.md。