> ## Documentation Index
> Fetch the complete documentation index at: https://vibewax.be/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Bancos de dados
> Entenda como o seu projeto armazena dados e como navegar por eles, editá-los e fazer backup
Todo projeto do Vibewax vem com o seu próprio banco de dados. Tudo o que o seu site ou app precisa lembrar fica nele: mensagens do formulário de contato, e-mails de inscrições na newsletter, posts de blog, pedidos de reserva, contas de usuários e assim por diante.
Você não precisa configurar um banco de dados com um provedor, informar credenciais nem conectar nada. O Vibewax cria um para você na primeira vez que o projeto precisar, e a aba **Banco de dados** do seu [chat](/docs/pt-BR/chat/overview) é o lugar onde você vê esses dados, trabalha com eles e baixa uma cópia.
## Como os bancos de dados funcionam no Vibewax
Um banco de dados armazena informações para que elas continuem lá depois que a página é recarregada, prontas para você voltar a elas sempre que precisar. Pense nele como uma planilha que fica por trás do seu projeto, em que cada **linha** é um item, como um assinante, e cada **coluna** é uma informação, como o e-mail ou a data.
O Vibewax cria um banco de dados para cada projeto automaticamente:
- **Pronto para usar**: ele é atualizado em tempo real e escala sozinho, sem nada para configurar do seu lado.
- **Isolado por projeto**: os dados de um projeto nunca se misturam com os de outro.
- **Hospedado na UE**: seus dados ficam na UE (Irlanda). Você encontra mais informações em [Segurança](/docs/pt-BR/security/overview).
Se o seu projeto ainda não tem um banco de dados, a aba Banco de dados mostra um botão **Configurar banco de dados**. Você também pode simplesmente descrever no chat o que quer armazenar, e o agente configura tudo para você.
## O seu banco de dados no chat
Suas **Tabelas** aparecem listadas à esquerda na aba Banco de dados, cada uma com a contagem atual de linhas. As tabelas que pertencem a bibliotecas usadas pelo seu projeto, como as de autenticação, ficam agrupadas abaixo e permanecem recolhidas até você abri-las. Clique no nome de uma tabela para abri-la na grade à direita.
### Navegando e filtrando
- **Paginação**: as linhas são carregadas de 50 em 50 e continuam carregando conforme você rola a página. **Carregar mais**, no fim da tabela, busca mais linhas, ao lado de um contador que mostra quantas linhas a tabela tem.
- **Ordenação**: **Mais recentes primeiro** e **Mais antigos primeiro** invertem a ordem.
- **Filtragem**: **Filtro** permite restringir os dados. Escolha um campo, um operador e um valor e clique em **Aplicar**. Os operadores incluem é igual a, não é igual a, é maior que, é menor que, existe, não existe e correspondência por tipo. Adicione mais condições e elas são combinadas com "e". **Limpar filtros** remove todas elas.
- **Atualizações ao vivo**: as linhas que o seu app cria enquanto você olha a tabela aparecem sozinhas.
Os campos que apontam para outra tabela são exibidos como links. Clique em um deles para ir direto à linha a que ele se refere.
### Editando linhas
Você pode alterar os dados direto na grade, sem passar pelo agente.
- **Clique em uma célula de texto** para editá-la ali mesmo. Pressione Enter para salvar ou Escape para cancelar. As caixas de seleção alternam com um único clique.
- **Clique em uma linha** para abrir um formulário com um campo por coluna. Você pode inserir números, datas, listas e referências, ver quais campos são obrigatórios e copiar a linha como JSON se quiser tê-la na área de transferência. Clique em **Salvar** quando terminar.
- **Adicionar linha** cria uma nova linha na tabela que você está vendo, com base nos campos que o Vibewax já conhece.
- **Marque uma ou mais linhas** para ver um botão **Excluir**. A caixa de seleção na linha de cabeçalho seleciona a tabela inteira. O Vibewax pede que você confirme. As exclusões não podem ser desfeitas.
A aba Banco de dados serve para os dados, não para a estrutura. Criar, renomear e excluir tabelas, e alterar quais campos uma tabela tem, fica no código do seu projeto, então quem cuida disso é o agente. Peça no chat, por exemplo: "Adicione um campo de telefone à tabela Leads."
### Baixando e restaurando
No fim da lista de **Tabelas** você encontra **Exportar** e **Importar**.
**Exportar** empacota o seu banco de dados em um snapshot e o baixa como um arquivo ZIP com todas as tabelas e todas as linhas. Use quando quiser ter o seu próprio backup antes de mudanças maiores ou trabalhar com os seus dados fora do Vibewax.
**Importar** restaura um snapshot em ZIP no banco de dados que você está vendo. Ele substitui tudo o que já existe ali, então o Vibewax mostra o nome do arquivo escolhido e pede que você confirme com **Substituir e importar**. Isso não pode ser desfeito, então exporte antes o estado atual, caso queira recuperá-lo. Quando a importação termina, o Vibewax informa quantas linhas foram gravadas e recarrega a prévia. Você pode testar um snapshot no seu banco de dados de teste antes de usá-lo com dados reais.
As duas ações são executadas no seu navegador, então deixe a aba aberta até terminarem. Bancos de dados grandes podem demorar um pouco.
Os arquivos que o seu projeto armazena, como imagens ou documentos enviados, não fazem parte do snapshot. O snapshot cobre apenas os dados das tabelas.
## Bancos de dados de produção e de teste
Por padrão, o seu projeto usa um único banco de dados de **Produção**, compartilhado pelo seu site publicado e pela prévia do chat. Qualquer alteração que você fizer enquanto constrói aparece no site publicado na mesma hora. Adicionar um banco de dados de **Teste** cria uma cópia separada para você trabalhar, sem alterar os dados que os seus usuários veem.
### Adicionando um banco de dados de teste
1. Abra a aba **Banco de dados** no seu chat.
2. Clique em **Adicionar modo de teste**.
3. Aguarde a configuração terminar.
O Vibewax cria um segundo banco de dados e copia para ele os seus dados de Produção.
Se o seu app já armazena arquivos enviados pelos seus usuários (veja [Arquivos enviados por usuários do app](/docs/pt-BR/chat/assets#arquivos-enviados-por-usuários-do-app)), o banco de dados de teste começa vazio.
### Deixando o agente escolher o Teste
Quando o seu projeto está publicado e tem dados reais, o agente consulta você antes de alterar o backend. Quando um pedido envolve o banco de dados ou funções do servidor, ele pergunta se as alterações devem ser feitas no Teste ou na Produção.
- **Develop in Testing**: o agente cria ou seleciona o seu banco de dados de teste e faz as alterações nele. Enquanto isso, os seus usuários continuam trabalhando com os dados de Produção.
- **Continue on Live**: o agente altera o app publicado e os dados dele.
Escolha o Teste quando a alteração puder quebrar algo de que os seus usuários dependem, como renomear um campo ou refazer um formulário que grava no banco de dados.
### Alternando entre os bancos de dados
Use os botões **Produção** e **Teste** no topo da aba para alternar entre os dois bancos de dados. Ao alternar, o seu projeto passa a apontar para o banco de dados selecionado e a prévia é recarregada, então o chat e a prévia leem e editam o banco que você escolheu.
O trabalho que você faz no Teste continua alterando o código do seu projeto. Quando você volta para o banco de dados de Produção, o Vibewax reimplanta o esquema e as funções, então as mudanças estruturais feitas durante o teste passam para o projeto publicado. Os dados em si ficam no banco de dados de teste.
### Publicando a partir do Teste
Você pode publicar enquanto o banco de dados de teste está ativo. Clique em **Publicar** e o menu mostra o aviso **Banco de dados de teste ativo**: a publicação promove o seu código para Produção depois de uma verificação de compatibilidade, enquanto o chat e a prévia continuam no Teste. Os dados e os segredos do Teste nunca são copiados para a Produção.
A verificação de compatibilidade garante que as suas alterações continuem funcionando com os dados que o seu app publicado já tem. Se não funcionarem, o Vibewax bloqueia a publicação e oferece **Ask agent to make compatible**. Clique nele e o agente ajusta as alterações para que funcionem com os seus dados de Produção, e então você pode publicar de novo.
Publicar a partir do Teste está disponível apenas para projetos com Git. Nos outros projetos, o botão Publicar fica desativado até você clicar em **Mudar para Produção**.
## Duplicando o seu próprio projeto
Quando você duplica seu próprio chat, a cópia obtém um banco de dados separado. Vibewax copia os dados da tabela atual onde há suporte; projetos mais antigos com uma configuração herdada de App Files podem começar com um banco de dados vazio e nenhum arquivo carregado. Uma duplicata não restaura dados de um momento anterior.
## Exemplos de uso de um banco de dados
Você vai recorrer a um banco de dados com mais frequência para funcionalidades como estas:
- **Formulários de contato**: armazene as mensagens que as pessoas enviam pelo seu formulário de contato ou de solicitação.
- **Newsletters**: reúna endereços de e-mail e acompanhe quando cada pessoa se inscreveu.
- **Gerenciamento de conteúdo**: crie um sistema que guarde seus posts de blog, estudos de caso, avaliações ou comentários.
- **Reservas e solicitações**: armazene pedidos de agendamento e inscrições em eventos.
- **Painéis de administração**: crie uma página interna para revisar envios de formulários, gerenciar assinantes ou moderar conteúdo.
- **Notificações**: receba um e-mail quando alguém preencher um formulário ou um novo cadastro chegar ao seu banco de dados.
Você não precisa projetar a estrutura sozinho. Descreva o que quer armazenar, e o agente cria a tabela e a conecta ao seu projeto.
**Exemplos de prompts:**
```
Adicione um banco de dados chamado "Leads" para os envios do formulário
de contato, com nome, e-mail, telefone e mensagem. Conecte o formulário
de contato para que cada envio seja salvo automaticamente e me mande um
e-mail de notificação a cada envio.
```
```
Crie um banco de dados de artigos, com título, descrição, conteúdo,
imagem e data de publicação, e use-o para exibir uma lista de posts de
blog no site.
```
## Perguntas frequentes
Não. Todo projeto do Vibewax recebe um automaticamente. Você não precisa configurar nada com um provedor, informar credenciais nem conectar coisa alguma. Descreva o que você quer armazenar, como envios de formulários de contato ou posts de blog, e o agente cria as tabelas e as integra ao seu projeto.
Cada projeto tem o próprio banco de dados isolado, com atualizações em tempo real e escalonamento automático, hospedado na UE. Veja Bancos de dados.
A aba **Banco de dados** lista suas tabelas e mostra as linhas de cada uma. Você pode filtrar e ordenar, editar valores ali mesmo, adicionar linhas ou excluí-las. A criação de tabelas e a mudança dos campos delas acontecem no código do seu projeto, então peça isso ao agente, por exemplo: "Adicione um campo de telefone à tabela Leads."
Sim. Na aba **Banco de dados**, clique em **Adicionar modo de teste** e o Vibewax cria um banco de dados de **Teste**, uma cópia separada dos seus dados em que você pode trabalhar sem alterar o que seus usuários veem. Você pode alternar entre os bancos de **Produção** e de **Teste** quando quiser e publicar a partir de qualquer um deles. Ao publicar a partir do Teste, uma verificação de compatibilidade roda primeiro para que seu app publicado continue funcionando com os dados existentes.
**Exportar**, na aba **Banco de dados**, baixa um ZIP com um instantâneo dos dados das suas tabelas, e **Importar** restaura um deles. Os arquivos que seu projeto armazena, como imagens enviadas, não fazem parte desse arquivo. Guarde um instantâneo antes de mudanças maiores, já que excluir linhas e importar um instantâneo substituem os dados de forma permanente.
This page is part of the [Vibewax documentation](https://vibewax.be/docs/pt-BR/welcome/overview).