跳轉到主要內容
每個資料庫都是一個專用的 Postgres 實例,隔離運行、自動縮放至零、支援連線池和直接連線。告訴 AI 你需要什麼,它會處理設定和認證。

建立資料庫

告訴 AI 你的應用需要什麼。它應該先列出現有資料庫,當有合適的活躍資料庫時就直接重用。只有當你要求隔離或沒有現有資料庫符合需求時,它才會建立新的 Postgres 實例。

認證

資料庫認證透過 vault 管理。
  • 檢視認證 - 返回資料庫的目前連線 URI。
  • 重新產生認證 - 重設資料庫密碼並建立新的 vault 密鑰。當認證遺失、洩露或需要輪換時使用。舊認證會立即停止運作。

在應用中使用認證

對於生成的應用,AI 會透過 db 工具將資料庫認證連接到流程元件。應用程式碼讀取一般環境變數,例如 DATABASE_URL 和 DIRECT_DATABASE_URL。 對於手動本機命令,透過 Kazzle CLI 搭配正確的集合和環境執行:
不要將資料庫 URL 放在前端程式碼或 VITE_* 變數中。

遷移

結構描述變更放在應用程式庫的 SQL 檔案中(例如 migrations/001_create_todos.sql)。Kazzle 可以在應用部署流程中執行這些遷移。如果啟用了即時同步,AI 也會更新相關的同步設定。

啟用即時同步

告訴 AI 在資料庫上啟用同步。在連接即時應用之前,它應該等到資料庫顯示 sync: ready。詳見 即時同步。

刪除資料庫

告訴 AI 刪除資料庫。Kazzle 會先將其標記為已刪除,在永久清理執行前可以還原資料庫。

範例:從零開始設定資料庫

  1. 「建立一個叫 my-app-db 的資料庫」
  2. AI 重用合適的資料庫或設定 Postgres 並將認證儲存在 vault 中
  3. 「建立一個 todos 表,包含 id、text、done 和 created_at」
  4. AI 執行 SQL
  5. 「將它連接到我的應用」- AI 將資料庫連接到應用的流程元件
對於具有離線支援的即時應用,AI 也會開啟同步並設定用戶端結構描述。詳見 即時同步 了解完整流程。