托管数据库

可用性

托管 Postgres 是 not available yet。当前的数据库服务是控制平面预览：它验证请求、记录元数据、生成一次性凭证形状，并且可以发布 DATABASE_URL，但它返回不可路由的主机 stub-shared-pg-01.local。它不会创建数据库服务器、租户、架构、备份或恢复点。

请勿将应用程序连接到状态为 stub 的记录。不要将成功的 API 响应视为存储存在的证据。

今天您可以测试什么

预览对于根据计划合同测试集成非常有用：

应用程序所有权由 MCP 包装器检查；
可以创建和列出数据库记录；
生成的密码不会被以后的元数据读取返回；
当配置了生产者令牌时，DATABASE_URL 可以交给应用程序环境生产者；和
应用程序记录返回的数据库引用。

发布占位符 URL 并不使其可用。在真正部署之前将其从应用程序环境中删除。

MCP 工具

工具	当前行为
`add_app_database(app_id, engine='postgres')`	创建 `stub` 记录。它可能会发布占位符 `DATABASE_URL`。
`list_app_databases(app_id)`	仅返回元数据。它永远不会返回密码。

在执行其他操作之前检查返回的状态：


add_app_database(app_id='app-12345678', engine='postgres')


{
  "db_id": "db-a1b2c3d4e5f6",
  "engine": "postgres",
  "status": "stub",
  "env_published": false,
  "publish_skipped_reason": "OPENFACTORY_DB_PRODUCER_TOKEN is not configured"
}

确切的响应还可以包含一次性连接字段。在预览中，它们指向存根主机，并且不得用作实际工作负载的凭据。

REST 合约

平台侧路线有：

方法	路径	结果
`POST`	`/api/app-infra/databases`	创建预览记录并返回一次性连接形状数据。
`GET`	`/api/app-infra/databases/{db_id}`	返回没有密码的元数据。
`GET`	`/api/app-infra/databases?app_id={app_id}`	列出元数据，可以选择按应用程序过滤。

这些较低级别的路由主要用于内部集成。优先选择所有者范围内的 MCP 工具，除非您正在开发平台本身。

在托管 Postgres 可以调用ready之前

可生产的版本需要满足以下所有条件的证据：

可访问的 Postgres 服务和真实租户配置； 2.应用程序之间的网络隔离；
凭证轮换和取消配置；
备份和恢复演练并测量恢复结果；
资源限制、监控和故障警报；和
写入数据、重新部署和读回的端到端应用程序测试。

在目标环境中通过这些检查之前，请带上您自己的数据库并将其真实连接字符串放置在应用程序环境变量中。