Zum Hauptinhalt springen
Jede Datenbank ist eine dedizierte Postgres-Instanz, isoliert, mit automatischer Skalierung auf Null, mit gepoolten und direkten Verbindungen. Bitte die KI, eine zu erstellen, und sie kümmert sich um Setup und Anmeldedaten.

Datenbank erstellen

Teile der KI mit, was die App benötigt. Sie sollte zuerst vorhandene Datenbanken auflisten und eine geeignete aktive Datenbank wiederverwenden, falls vorhanden. Sie erstellt eine neue Postgres-Instanz nur, wenn du Isolation anfordest oder keine vorhandene Datenbank passt.

Anmeldedaten

Datenbank-Anmeldedaten werden über den Vault verwaltet.
  • Anmeldedaten anzeigen - gibt die aktuellen Verbindungs-URIs für die Datenbank zurück.
  • Anmeldedaten neu generieren - setzt das Datenbank-Passwort zurück und erstellt neue Vault-Secrets. Verwende dies, wenn Anmeldedaten fehlen, kompromittiert sind oder rotiert werden müssen. Alte Anmeldedaten funktionieren sofort nicht mehr.

Anmeldedaten in einer App verwenden

Bei generierten Apps verbindet die KI Datenbank-Anmeldedaten mit dem Process-Component über das db-Tool. App-Code liest normale Umgebungsvariablen wie DATABASE_URL und DIRECT_DATABASE_URL. Für manuelle lokale Befehle führe sie über die Kazzle CLI mit der richtigen Collection und Umgebung aus:
{
  "scripts": {
    "dev": "kazzle run --collection=my-saas --env=dev -- bun run server.ts"
  }
}
Gib Datenbank-URLs nicht in Frontend-Code oder VITE_*-Variablen ein.

Migrationen

Schema-Änderungen gehören in SQL-Dateien im App-Repository (z. B. migrations/001_create_todos.sql). Kazzle kann diese Migrationen als Teil deines App-Deploy-Flows ausführen. Wenn Echtzeit-Sync aktiviert ist, aktualisiert die KI auch das zugehörige Sync-Setup.

Echtzeit-Sync aktivieren

Bitte die KI, Sync auf einer Datenbank zu aktivieren. Sie sollte warten, bis die Datenbank sync: ready anzeigt, bevor sie eine Echtzeit-App verbindet. Siehe Echtzeit-Sync für weitere Informationen.

Datenbank löschen

Bitte die KI, eine Datenbank zu löschen. Kazzle markiert sie zuerst als gelöscht, und die Datenbank kann vor der endgültigen Bereinigung wiederhergestellt werden.

Beispiel: Datenbank von Grund auf einrichten

  1. “Erstelle eine Datenbank namens my-app-db”
  2. Die KI verwendet eine geeignete Datenbank oder richtet Postgres ein und speichert Anmeldedaten im Vault
  3. “Erstelle eine todos-Tabelle mit id, text, done und created_at”
  4. Die KI führt das SQL aus
  5. “Verbinde es mit meiner App” - die KI verbindet die Datenbank mit dem Process-Component der App
Für Echtzeit-Apps mit Offline-Unterstützung aktiviert die KI auch Sync und richtet das Client-seitige Schema ein. Siehe Echtzeit-App erstellen für den vollständigen Ablauf.