跳轉到主要內容
每個資料庫都是一個專用的 Postgres 實例，隔離、可縮放至零，支援連線池和直接連線。告訴 AI 建立一個，它會處理設定和認證。

​
建立資料庫

告訴 AI 應用程式需要什麼。它應該先列出現有資料庫，並在存在合適的活躍資料庫時重複使用。只有當您要求隔離或沒有現有資料庫符合需求時，它才會建立新的 Postgres 實例。

​
認證

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

​
在應用程式中使用認證

對於生成的應用程式，AI 會使用 db 工具將資料庫認證連接到流程元件。應用程式程式碼讀取一般環境變數，例如 DATABASE_URL 和 DIRECT_DATABASE_URL。 對於手動本機命令，透過 Kazzle CLI 使用正確的集合和環境執行： 
{
  "scripts": {
    "dev": "kazzle run --collection=my-saas --env=dev -- bun run server.ts"
  }
}
不要將資料庫 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 也會開啟同步並設定用戶端結構描述。請參閱 建立即時應用程式 了解完整流程。