Saltar al contenido principal
Cada base de datos es una instancia dedicada de Postgres, aislada, con escalado a cero, y conexiones agrupadas y directas. Pídele al AI que cree una y se encargará de la configuración y las credenciales.

​
Crear una base de datos

Cuéntale al AI qué necesita la aplicación. Debería listar primero las bases de datos existentes y reutilizar una activa adecuada cuando exista. Solo crea una nueva instancia de Postgres cuando solicites aislamiento o ninguna base de datos existente sea compatible.

​
Credenciales

Las credenciales de la base de datos se gestionan a través de la bóveda.
  • Ver credenciales - devuelve los URIs de conexión actuales de la base de datos.
  • Regenerar credenciales - restablece la contraseña de la base de datos y crea nuevos secretos en la bóveda. Úsalo cuando las credenciales falten, estén comprometidas o necesiten rotación. Las credenciales antiguas dejan de funcionar inmediatamente.

​
Usar credenciales en una aplicación

Para aplicaciones generadas, el AI conecta las credenciales de la base de datos al componente de proceso con la herramienta db. El código de la aplicación lee variables de entorno normales como DATABASE_URL y DIRECT_DATABASE_URL. Para comandos locales manuales, ejecuta a través de la CLI de Kazzle con la colección y el entorno correctos: 
{
  "scripts": {
    "dev": "kazzle run --collection=my-saas --env=dev -- bun run server.ts"
  }
}
No pongas URLs de base de datos en código frontend ni en variables VITE_*.

​
Migraciones

Los cambios de esquema van en archivos SQL en el repositorio de la aplicación (p. ej. migrations/001_create_todos.sql). Kazzle puede ejecutar esas migraciones como parte del flujo de despliegue de tu aplicación. Si la sincronización en tiempo real está habilitada, el AI también actualiza la configuración de sincronización relacionada.

​
Habilitar sincronización en tiempo real

Pídele al AI que habilite la sincronización en una base de datos. Debería esperar hasta que la base de datos muestre sync: ready antes de conectar una aplicación en tiempo real. Consulta Sincronización en tiempo real para saber cómo funciona.

​
Eliminar una base de datos

Pídele al AI que elimine una base de datos. Kazzle la marca como eliminada primero, y la base de datos puede restaurarse antes de que se ejecute la limpieza permanente.

​
Ejemplo: configurar una base de datos desde cero

  1. “Crea una base de datos llamada my-app-db”
  2. El AI reutiliza una base de datos adecuada o configura Postgres y almacena las credenciales en la bóveda
  3. “Crea una tabla de tareas con id, text, done y created_at”
  4. El AI ejecuta el SQL
  5. “Conéctala a mi aplicación” - el AI conecta la base de datos al componente de proceso de la aplicación
Para aplicaciones en tiempo real con soporte sin conexión, el AI también activa la sincronización y configura el esquema del lado del cliente. Consulta crear una aplicación en tiempo real para el flujo completo.