データベース

すべてのデータベースは専用の 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 を表示するまで待つ必要があります。詳細はリアルタイム同期を参照してください。