Vai al contenuto principale
Ogni database è un’istanza Postgres dedicata, isolata, con scalabilità a zero, con connessioni in pool e dirette. Chiedi all’AI di crearne una e gestisce setup e credenziali.

​
Creazione di un database

Descrivi all’AI cosa serve all’app. Dovrebbe elencare prima i database esistenti e riutilizzare un database attivo adatto quando esiste. Crea una nuova istanza Postgres solo quando chiedi isolamento o nessun database esistente è idoneo.

​
Credenziali

Le credenziali del database sono gestite tramite il vault.
  • Visualizza credenziali - restituisce gli URI di connessione attuali per il database.
  • Rigenera credenziali - reimposta la password del database e crea nuovi segreti nel vault. Usa quando le credenziali mancano, sono compromesse o necessitano rotazione. Le credenziali vecchie smettono di funzionare immediatamente.

​
Utilizzo delle credenziali in un’app

Per le app generate, l’AI collega le credenziali del database nel componente process con lo strumento db. Il codice dell’app legge variabili env normali come DATABASE_URL e DIRECT_DATABASE_URL. Per comandi locali manuali, esegui tramite la CLI Kazzle con la giusta collection e ambiente: 
{
  "scripts": {
    "dev": "kazzle run --collection=my-saas --env=dev -- bun run server.ts"
  }
}
Non inserire URL del database nel codice frontend o in variabili VITE_*.

​
Migrazioni

I cambiamenti dello schema vanno in file SQL nel repo dell’app (es. migrations/001_create_todos.sql). Kazzle può eseguire quelle migrazioni come parte del flusso di deploy della tua app. Se la sincronizzazione realtime è abilitata, l’AI aggiorna anche la configurazione di sync correlata.

​
Abilitazione della sincronizzazione realtime

Chiedi all’AI di abilitare la sync su un database. Dovrebbe attendere fino a quando il database non mostra sync: ready prima di collegare un’app realtime. Vedi Sincronizzazione realtime per come funziona.

​
Eliminazione di un database

Chiedi all’AI di eliminare un database. Kazzle lo contrassegna come eliminato per primo, e il database può essere ripristinato prima che la pulizia permanente venga eseguita.

​
Esempio: configurazione di un database da zero

  1. “Crea un database chiamato my-app-db”
  2. L’AI riutilizza un database adatto o configura Postgres e archivia le credenziali nel vault
  3. “Crea una tabella todos con id, text, done e created_at”
  4. L’AI esegue l’SQL
  5. “Collegalo alla mia app” - l’AI connette il database al componente process dell’app
Per app realtime con supporto offline, l’AI attiva anche la sync e configura lo schema lato client. Vedi creazione di un’app realtime per il flusso completo.