O Banco de Dados do Atoms Cloud armazena e gerencia os dados estruturados dos quais seu app depende, incluindo produtos, reservas, pedidos, envios de formulários e conteúdo gerado por usuários. No módulo Banco de Dados, você pode visualizar ambientes e tabelas, pesquisar e editar registros, inspecionar estruturas de tabelas e importar ou exportar dados usando arquivos CSV.

Este guia aborda o banco de dados integrado ao Atoms Cloud. Se o seu projeto usa Supabase, consulte Conectar Supabase em vez disso.

Abrir um banco de dados

Antes de abrir um banco de dados, conecte seu projeto ao Atoms Cloud. Se ele ainda não estiver conectado, siga as etapas de conexão em Atoms Cloud.

1. Abra seu projeto em um dispositivo desktop.
2. Na mesma barra de ferramentas do espaço de trabalho onde está o Visualizador de App , selecione Atoms Cloud.
3. Selecione Banco de Dados na barra lateral do Atoms Cloud.
4. Em Databases, selecione qual banco de dados você deseja inspecionar. Os cartões de banco de dados Development e Production aparecem quando estão disponíveis para o projeto.

Cada cartão de banco de dados mostra quanto armazenamento está sendo usado e o total disponível. Use Development enquanto estiver criando e testando seu app. As alterações feitas em Production podem afetar os dados do app em produção, então sempre verifique em qual ambiente você está antes de fazer alterações.

Escolha o banco de dados Development ou Production.

Navegar e filtrar dados da tabela

1. Selecione o cartão do banco de dados Development ou Production, dependendo do ambiente em que você deseja trabalhar.
2. Use Search tables para encontrar uma tabela ou selecione uma diretamente da lista. Cada cartão de tabela mostra sua contagem de linhas e se ela é somente leitura.
3. Use Search rows para pesquisar na tabela atual ou selecione Filter para restringir os resultados usando um ou mais campos.
4. Use os controles de seta de página abaixo da tabela para visualizar linhas adicionais.
5. Para inspecionar a estrutura da tabela, abra o menu ••• e selecione Schema.

A visualização Schema mostra o nome de cada campo, tipo de dado, status de chave, requisitos, restrições e valor padrão. Selecione Copy para copiar o schema exibido.

Adicionar, editar ou excluir linhas

Quando você encontrar o banco de dados no qual deseja fazer alterações, poderá usar estas ações para isso:

Operação	Como fazer
Adicionar uma linha	Abra ... e selecione Add Row. Insira valores que correspondam aos campos disponíveis e, em seguida, envie a linha.
Editar uma linha	Clique duas vezes em uma célula e insira o novo valor. Selecione Commit Changes para salvar todas as edições pendentes ou Discard para removê-las.
Excluir linhas	Selecione uma ou mais linhas, selecione Delete e confirme. A exclusão de linhas não pode ser desfeita.

Adicionar uma linha ou confirmar uma exclusão aplica a alteração imediatamente ao banco de dados selecionado. Apenas edições inline de células exigem que você selecione Commit Changes ou Discard. Se você tiver edições pendentes, confirme-as ou descarte-as antes de adicionar uma linha, importar ou exportar um arquivo CSV, alterar a pesquisa ou os filtros, ou navegar para outra página.

Se o projeto estiver em um espaço de trabalho, apenas Editors e o workspace owner podem editar linhas em tabelas graváveis. Se o Atoms não conseguir detectar uma chave primária para uma tabela, você não poderá editar nem excluir suas linhas porque o Atoms não consegue identificar registros individuais com confiabilidade.

Revise uma edição de linha pendente e, em seguida, confirme ou descarte a alteração.

Criar tabelas ou alterar o schema

Abra o ambiente do banco de dados que você deseja atualizar e siga as instruções para a alteração que deseja fazer:

Operação	Como fazer
Criar uma tabela	Na lista de tabelas, clique em ... e selecione Create table. Insira um nome de tabela válido e os campos iniciais e, em seguida, envie a solicitação. Aguarde o Agente terminar, reabra Banco de Dados e verifique a tabela.
Alterar o schema	Clique na tabela na qual deseja fazer alterações, depois clique em ... e selecione Schema. Use Add Field para criar um campo ou selecione um campo elegível para editá-lo. Você pode alterar seu nome, tipo, valor padrão, status de obrigatório ou unicidade. Você também pode marcar campos que não são chave para exclusão. Selecione Submit Changes para enviar a solicitação ao Agente ou Discard para limpar suas alterações pendentes.

Apenas o workspace owner pode criar tabelas ou alterar o schema de uma tabela.

Enviar uma solicitação de schema não significa que a migração foi concluída. Aguarde o Agente terminar, verifique o resultado em Banco de Dados e teste seu app depois. Campos de chave primária e tabelas somente leitura não podem ser modificados dessa forma.

Insira os detalhes do novo campo em Add Field.

Revise as alterações pendentes do schema antes de selecionar Submit Changes.

Importar ou exportar dados CSV

Selecione a tabela com a qual deseja trabalhar e siga as instruções para a operação relevante:

Operação	Como fazer
Importar CSV	Clique em ... e selecione Import CSV. Escolha um arquivo .csv com no máximo 10 MB e, em seguida, revise o nome do arquivo, a contagem estimada de linhas, a tabela selecionada e o ambiente antes de confirmar. As colunas do CSV devem corresponder ao schema da tabela. As linhas importadas são adicionadas imediatamente e não podem ser desfeitas automaticamente, então considere exportar os dados existentes primeiro.
Exportar CSV	Clique em ... e selecione Export CSV. Se uma pesquisa ou filtro estiver ativo, apenas as linhas correspondentes serão exportadas. Caso contrário, todos os dados da tabela atual serão exportados.

Apenas o workspace owner pode importar ou exportar arquivos CSV. Para tabelas somente leitura, Export CSV é a única opção disponível.

Permissões e tabelas protegidas

Ação	Quem pode executá-la	Requisitos adicionais
Adicionar, editar ou excluir linhas	Editor ou workspace owner	A tabela deve ser gravável. Editar e excluir linhas também exige informações de chave primária.
Criar tabelas ou alterar schemas	Espaço de Trabalho owner	Campos de chave primária e tabelas somente leitura não podem ser modificados.
Importar ou exportar arquivos CSV	Espaço de Trabalho owner	Arquivos CSV não podem ser importados para tabelas somente leitura.

Tabelas protegidas do sistema ou do usuário podem exibir um selo Read-only. Você pode visualizar seus dados e inspecionar seu schema quando disponível, mas não pode modificar suas linhas nem sua estrutura a partir desta página.

Corrigir problemas comuns de banco de dados

“No databases found” ou “No tables found”

Certifique-se de que o Atoms Cloud esteja conectado ao projeto. Se ele já estiver conectado, confirme que seu app inclui um recurso que armazena dados persistentes. Se necessário, peça ao Agente para adicionar o recurso com suporte de banco de dados. Quando o Agente terminar, reabra Banco de Dados ou selecione Refresh.

Uma ação do banco de dados está ausente ou indisponível

Verifique se a tabela tem um selo Read-only e depois revise as permissões acima para confirmar que sua função no espaço de trabalho permite a ação. Editar e excluir linhas também exige informações de chave primária.

Edições de linha pendentes podem impedir outras ações. Selecione Commit Changes ou Discard antes de adicionar uma linha, importar ou exportar um arquivo CSV, alterar a pesquisa ou os filtros, ou ir para outra página.

Se a ação ainda estiver indisponível após essas verificações, entre em contato com o Support e inclua o link do projeto ou do Chat, ambiente, tabela, função no espaço de trabalho, ação tentada e o texto exato do erro.

Um arquivo CSV não pode ser importado

Apenas o workspace owner pode importar dados, e a tabela de destino deve ser gravável. Certifique-se de que:

• O arquivo use o formato .csv.
• O arquivo não tenha mais de 10 MB.
• Suas colunas e dados sejam compatíveis com o schema da tabela de destino.
• Você tenha confirmado ou descartado quaisquer edições de linha pendentes.

Se a importação ainda falhar, entre em contato com o Support e inclua o link do projeto ou do Chat, ambiente, tabela de destino, função no espaço de trabalho, nome e tamanho do arquivo, ação tentada e o texto exato do erro.

FAQ

Meu banco de dados de produção não está sincronizando. O que devo fazer?

Se o Development funcionar normalmente, mas o site ao vivo (Production) mostrar tabelas, colunas ou erros de migração ausentes:

Importante: não reconstrua nem sobrescreva o banco de dados de produção por conta própria.

Informações necessárias:

• Link do Chat e URL ao vivo
• Mensagem de erro SQL completa
• Nomes de tabelas/colunas ausentes
• Última alteração no schema do banco de dados
• Última versão ao vivo que funcionava
• Se os dados de produção precisam ser preservados
• Se você deseja sincronizar totalmente os dados de Development ou apenas preencher estruturas ausentes

Entre em contato com o suporte com esses detalhes para que possamos comparar as versões de Development/Production, o status da migração e as diferenças de schema antes de fazer alterações.

Por que meus dados de desenvolvimento são diferentes dos dados de produção?

Se você publicou várias vezes, mas o Production ainda mostra dados antigos enquanto as atualizações de código funcionam bem:

Antes de entrar em contato com o suporte, confirme:

1. Os dados atuais de produção precisam ser preservados?

2. Você deseja sobrescrever totalmente com os dados atuais de Development ou apenas preencher registros ausentes?

3. Você já tem um backup?

4. Qual é a sua janela de manutenção aceitável?

Não vamos sobrescrever nem reconstruir os dados de produção até que o objetivo de tratamento dos dados seja confirmado. Forneça as URLs de Development/Production e exemplos de IDs ou contagens de registros que mostrem a diferença.