Banco de Dados
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.
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.
- Abra seu projeto em um dispositivo desktop.
- Na mesma barra de ferramentas do espaço de trabalho onde está o Visualizador de App, selecione Atoms Cloud.
- Selecione Banco de Dados na barra lateral do Atoms Cloud.
- 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
- Selecione o cartão do banco de dados Development ou Production, dependendo do ambiente em que você deseja trabalhar.
- Use Search tables para encontrar uma tabela ou selecione uma diretamente na lista. Cada cartão de tabela mostra sua contagem de linhas e se ela é somente leitura.
- Use Search rows para pesquisar na tabela atual ou selecione Filter para restringir os resultados usando um ou mais campos.
- Use os controles de seta de página abaixo da tabela para visualizar linhas adicionais.
- 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 esquema 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:
| Operation | How to do it |
|---|---|
| Add a row | Abra... e selecione Add Row. Insira valores que correspondam aos campos disponíveis e, em seguida, envie a linha. |
| Edit a row | Clique duas vezes em uma célula e insira o novo valor. SelecioneCommit Changes para salvar todas as edições pendentes ou Discard para removê-las. |
| Delete rows | Selecione uma ou mais linhas, selecioneDelete 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 ou 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 esquema
Abra o ambiente do banco de dados que você deseja atualizar e siga as instruções para a alteração que deseja fazer:
| Operation | How to do it |
|---|---|
| Create a table | 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. |
| Change the 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 exclusividade. 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 esquema de uma tabela.
Enviar uma solicitação de esquema 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 de esquema pendentes 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:
| Operation | How to do it |
|---|---|
| Import CSV | Clique em... e selecione Import CSV. Escolha um arquivo .csv com no máximo 10 MB e 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 esquema da tabela. As linhas importadas são adicionadas imediatamente e não podem ser desfeitas automaticamente, então considere exportar os dados existentes primeiro. |
| Export 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
| Action | Who can perform it | Additional requirements |
|---|---|---|
| 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 esquemas | 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 esquema quando disponível, mas não pode modificar suas linhas ou estrutura nesta 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 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 de 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 usa o formato
.csv. - O arquivo não tem mais de 10 MB.
- Suas colunas e dados são compatíveis com o esquema da tabela de destino.
- Você confirmou ou descartou 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 Development funciona normalmente, mas o site em produção (Production) mostra 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 publicada
- Mensagem de erro SQL completa
- Nomes da tabela/coluna ausentes
- Última alteração no esquema do banco de dados
- Última versão publicada 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 esquema antes de fazer alterações.
Por que meus dados de development são diferentes dos dados de production?
Se você publicou várias vezes, mas 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 é sua janela de manutenção aceitável?
Não sobrescreveremos nem reconstruiremos os dados de produção até que o objetivo do tratamento de dados seja confirmado. Forneça as URLs de Development/Production e IDs ou contagens de registros de exemplo que mostrem a diferença.
Posso mover um banco de dados de um projeto Atoms para outro sem perder dados?
No momento, o Atoms não oferece suporte à migração automática e sem perdas de banco de dados entre projetos. Criar um novo projeto ou dividir um projeto existente não copiará automaticamente contas de usuário ou registros de banco de dados existentes para o novo projeto.
Antes de prosseguir:
- Não redefina, substitua, migre nem exclua o banco de dados existente ou os recursos do projeto.
- Mantenha o projeto original inalterado como fonte dos dados existentes.
- Entre em contato com o Suporte do Atoms e informe o projeto de origem, o projeto de destino, o provedor do banco de dados e os dados que precisam ser preservados.
Em alguns casos, a equipe pode conseguir ajudar com uma cópia manual única do banco de dados de origem para o banco de dados de destino. Isso não é sincronização contínua: quaisquer novos dados gravados na origem após o início da cópia não aparecerão automaticamente no destino.
Para minimizar diferenças de dados, pause gravações no banco de dados de origem durante a janela de migração e verifique os dados copiados no projeto de destino antes de mudar para ele. No momento, não é possível garantir uma migração completamente sem perdas.