託管資料庫

可用性

託管 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.應用程式之間的網路隔離；
憑證輪換和取消配置；
備份和復原演練並測量復原結果；
資源限制、監控和故障警報；和
寫入資料、重新部署和讀回的端到端應用程式測試。

在目標環境中通過這些檢查之前，請帶上您自己的資料庫並將其真實連接字串放置在應用程式環境變數中。