> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kazzle.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Datenbanken

> Dedizierte Postgres-Instanzen für deine Apps.

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](/work/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:

```json theme={"theme":"material-theme-darker"}
{
  "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](/apps/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](/apps/build-and-publish) für den vollständigen Ablauf.