Saltar para o conteúdo principal
Cada banco de dados é uma instância Postgres dedicada, isolada, com escala para zero e conexões em pool e diretas. Peça ao AI para criar um e ele cuida da configuração e credenciais.

​
Criando um banco de dados

Diga ao AI o que o app precisa. Ele deve listar bancos de dados existentes primeiro e reutilizar um banco de dados ativo adequado quando um existir. Ele cria uma nova instância Postgres apenas quando você pede isolamento ou nenhum banco de dados existente se encaixa.

​
Credenciais

As credenciais do banco de dados são gerenciadas através do vault.
  • Visualizar credenciais - retorna os URIs de conexão atuais do banco de dados.
  • Regenerar credenciais - redefine a senha do banco de dados e cria novos segredos no vault. Use quando as credenciais estão faltando, comprometidas ou precisam ser rotacionadas. As credenciais antigas param de funcionar imediatamente.

​
Usando credenciais em um app

Para apps gerados, o AI conecta as credenciais do banco de dados ao componente de processo com a ferramenta db. O código do app lê variáveis de ambiente normais como DATABASE_URL e DIRECT_DATABASE_URL. Para comandos locais manuais, execute através do Kazzle CLI com a coleção e ambiente corretos: 
{
  "scripts": {
    "dev": "kazzle run --collection=my-saas --env=dev -- bun run server.ts"
  }
}
Não coloque URLs de banco de dados em código frontend ou variáveis VITE_*.

​
Migrações

Alterações de schema vão em arquivos SQL no repositório do app (ex: migrations/001_create_todos.sql). Kazzle pode executar essas migrações como parte do fluxo de deploy do seu app. Se a sincronização em tempo real estiver ativada, o AI também atualiza a configuração de sincronização relacionada.

​
Ativando sincronização em tempo real

Peça ao AI para ativar sincronização em um banco de dados. Ele deve aguardar até que o banco de dados mostre sync: ready antes de conectar um app em tempo real. Veja Sincronização em tempo real para saber como funciona.

​
Deletando um banco de dados

Peça ao AI para deletar um banco de dados. Kazzle o marca como deletado primeiro, e o banco de dados pode ser restaurado antes da limpeza permanente.

​
Exemplo: configurando um banco de dados do zero

  1. “Crie um banco de dados chamado my-app-db”
  2. O AI reutiliza um banco de dados adequado ou configura Postgres e armazena credenciais no vault
  3. “Crie uma tabela todos com id, text, done e created_at”
  4. O AI executa o SQL
  5. “Conecte ao meu app” - o AI conecta o banco de dados ao componente de processo do app
Para apps em tempo real com suporte offline, o AI também ativa sincronização e configura o schema do lado do cliente. Veja construindo um app em tempo real para o fluxo completo.