Skip to main content
HeavenBase 会先读仓库地图,再考虑搬任何箱子。

1. 动机

当表、列、枚举与连接摘要都是普通类型化行时,Agent 可以更安全地理解外部数据库。 可选 database 扩展会内省 schema 元数据,而不会把源表数据复制进 HeavenBase。

2. 安装 SQL 支持

本例使用 SQLite,但摄取也接受工作区 SQL Backend 名称、DSN 或 hb.Database 实例。

3. 创建一个小型数据源

该文件就是外部数据源。 HeavenBase 只会存储脱敏的连接元数据与发现的 schema 行。

4. 启用并摄取

摄取会创建或更新六种 Entity:db-databasedb-tabledb-columndb-enumdb-snippetdb-predicate。 凭据会从存储摘要中脱敏。

5. 浏览 Schema

这些行使用普通 HeavenBase Query、Catalog、搜索与 MCP 表面。 它们描述数据源,而不会镜像其中的业务行。

6. 理解重连

db-database 行会保留脱敏的数据源描述。 实时执行仍要求目标环境提供可访问的连接信息与凭据。 重放工作区清单后,如果需要实时外部元数据,请再次调用 ws.database.ingest(...)。 清单不会导出源数据库或 db-* 行数据。

总结

  • Database 扩展把外部 schema 变成类型化 HeavenBase 行。
  • 摄取会脱敏凭据,而且不会复制业务数据。
  • ws.database 是摄取与 snippet 执行的工作区附属 API。
  • 重建后需要实时元数据时,请重新摄取。

进一步探索

相关资源: