跳转到主要内容
本工作坊是 demos/enterprise/01_connect_and_ingest.py 的文档转录。它使用仓库中已提交的 seed 数据库 demos/data/warehouse.db
你将启用可选的 database 扩展,把现有 SQLite 数据仓库摄取为可浏览的 db-* 行,并通过常规 HeavenBase 查询与卡片搜索发现表。

1. 前置条件

在已同步 SQL 额外依赖的 HeavenBase 源码检出目录中:

2. 启用 Database 扩展

database 扩展注册六个 schema 实体:db-databasedb-tabledb-columndb-enumdb-snippetdb-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 行即可查询与搜索。

进一步探索

相关资源: