Banco de dados e KV
Com os recursos de dados, o site guarda informações entre visitas: leads, pedidos, inscritos, contadores ou sessões. Você pede à IA e a próxima publicação cria e conecta tudo.
Antes de começar
Seção intitulada “Antes de começar”- O site precisa ser uma Landing Page ou uma Aplicação Web. Veja Landing Pages e Aplicações Web.
Tipos de recurso de dados
Seção intitulada “Tipos de recurso de dados”| Tipo | O que é | Nome no código (padrão) | Quando usar |
|---|---|---|---|
database |
Banco de dados SQL (D1) | DB |
Registros que você lista, filtra ou atualiza: leads, pedidos, comentários. |
kv |
Armazenamento chave-valor | KV |
Valores pequenos buscados por chave: sessões, contadores, cache. |
Na Aplicação Web, o código lê o recurso em funções de servidor. Na Landing Page, só páginas renderizadas sob demanda (export const prerender = false) acessam recursos de dados.
Limites de recursos de dados por site
Seção intitulada “Limites de recursos de dados por site”Cada site pode ter no máximo 1 banco de dados e 2 KV. Recursos “Fora do Site” continuam contando até os dados serem excluídos.
Status de um recurso de dados
Seção intitulada “Status de um recurso de dados”O painel mostra o status em Configurações → Dados.
| Rótulo no painel | O que significa |
|---|---|
| Aguardando publicação | O recurso foi pedido, mas ainda não foi publicado. |
| Ativo | O site publicado está conectado ao recurso. |
| Fora do Site | O site não usa mais o recurso. Os dados continuam guardados. |
| Excluindo | A exclusão dos dados está em andamento. |
Adicionar um banco de dados ou KV
Seção intitulada “Adicionar um banco de dados ou KV”- Diga o que o site precisa guardar, por exemplo: “salve os leads do formulário num banco de dados”.
- A IA declara o recurso, escreve o código e, no banco de dados, as migrações.
- A IA publica. A primeira publicação cria o recurso e o status fica Ativo.
Em Configurações → Dados → Pedir ao agente, clique em Copiar prompt em Banco de dados ou Chave-valor e cole na IA. O painel não cria recursos sozinho.
Migrações do banco de dados
Seção intitulada “Migrações do banco de dados”O esquema do banco de dados fica em arquivos SQL em migrations/, como migrations/0001_create_leads.sql. Cada publicação aplica os arquivos novos em ordem; um arquivo já aplicado não roda de novo, então mudanças de esquema viram arquivos novos. Um erro de SQL faz a publicação falhar e a versão anterior continua no ar.
Limites do KV
Seção intitulada “Limites do KV”- Chave de até 512 bytes e valor de até 25 MiB.
- Expiração de no mínimo 60 segundos.
- No máximo uma escrita por segundo na mesma chave.
- Um valor gravado pode levar até cerca de um minuto para aparecer em todo lugar. Para registros que precisam ser confiáveis, use o banco de dados.
Remover um recurso de dados do site
Seção intitulada “Remover um recurso de dados do site”Remover tira o recurso do site, mas mantém os dados. Peça à IA para remover (dizendo o nome, como DB) ou use Prompt para remover em Configurações → Dados. Depois da publicação, o recurso fica Fora do Site. Declarar o mesmo nome de novo traz de volta os mesmos dados.
Excluir os dados de um recurso
Seção intitulada “Excluir os dados de um recurso”Peça à IA para excluir os dados, dizendo o nome do recurso. Ela confirma com você antes.
Em Configurações → Dados, clique na lixeira do recurso “Fora do Site” e confirme em Excluir dados. Se ficar em “Excluindo”, clique na lixeira de novo.
Excluir o site inteiro também apaga os recursos de dados. Veja Excluir um site.
Conflitos de nome
Seção intitulada “Conflitos de nome”A publicação falha se um nome já é usado por um recurso de outro tipo ou por um recurso em exclusão. Use outro nome ou espere a exclusão terminar.
Prompts de exemplo
Seção intitulada “Prompts de exemplo”Adicione um banco de dados ao meu site e faça o formulário de contato salvar nome, e-mail e mensagem. Crie também uma página só para mim com a lista dos contatos.Use um KV para contar as visitas da página inicial e mostrar o total no rodapé.