本工作坊是
demos/enterprise/01_connect_and_ingest.py 的文档转录。它使用仓库中已提交的 seed 数据库 demos/data/warehouse.db。database 扩展,把现有 SQLite 数据仓库摄取为可浏览的 db-* 行,并通过常规 HeavenBase 查询与卡片搜索发现表。
1. 前置条件
在已同步 SQL 额外依赖的 HeavenBase 源码检出目录中:2. 启用 Database 扩展
database 扩展注册六个 schema 实体:db-database、db-table、db-column、db-enum、db-snippet 与 db-predicate。从 Python 摄取时需显式启用:
3. 摄取现有数据库
hb.ext.ingest_database 接受工作区 SQL 后端 (Backend) 名称、DSN、本地 SQLite 路径或 hb.Database 实例。它使用 SQLAlchemy 的 inspect(),并在存储行中脱敏凭证:
4. 浏览 Schema 行
像查询其他任何实体一样查询已摄取的表与列:Summary
database扩展将外部 SQL 数据库内省为 HeavenBase 一等实体。- 摄取过程会脱敏凭证;导入 manifest 后若需要实时连接元数据,请重新运行摄取。
- 在注册 SQL snippet 或暴露 MCP 工具之前,schema 行即可查询与搜索。

