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 richiedi 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 precedenti 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 d’ambiente normali come DATABASE_URL e DIRECT_DATABASE_URL. Per comandi locali manuali, esegui tramite la CLI Kazzle con la giusta collection e ambiente:
Non inserire URL del database nel codice frontend o nelle 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 in tempo reale è abilitata, l’AI aggiorna anche la configurazione di sincronizzazione correlata.

Abilitazione della sincronizzazione in tempo reale

Chiedi all’AI di abilitare la sincronizzazione su un database. Dovrebbe attendere fino a quando il database non mostra sync: ready prima di collegare un’app in tempo reale. Vedi Sincronizzazione in tempo reale 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 in tempo reale con supporto offline, l’AI attiva anche la sincronizzazione e configura lo schema lato client. Vedi Sincronizzazione in tempo reale per il flusso completo.