Pular para o conteúdo

O banco de dados do seu app

ResumindoTodo app que o MonstarX cria tem um banco de dados próprio e privado, criado para você assim que o app é gerado pela primeira vez. Abra Backend → Banco de dados para ver cada tabela, suas linhas e migrações, e para executar SQL somente leitura. Para adicionar ou alterar registros, use a aba Admin ou peça no chat. A prévia e o app publicado compartilham os mesmos dados, e restaurar uma versão nunca mexe neles.

O banco de dados é onde o seu app guarda as informações dele: o cardápio de uma cafeteria, os pedidos que as pessoas fazem, as receitas que elas publicam, as contas com que elas entram. Todo app que você cria no MonstarX tem um banco de dados próprio e privado, criado assim que o app é gerado pela primeira vez. Nenhum outro app consegue ler esses dados.

Você nunca precisa planejar a estrutura dele. Quando você pede uma funcionalidade que precisa guardar alguma informação, o MonstarX cria as tabelas necessárias e escreve o código que lê e grava nelas.

  1. Abra o seu projeto e clique em Backend na barra superior.

  2. Clique em Banco de dados. À esquerda aparecem as Tabelas, cada uma com o seu número de linhas.

  3. Clique em uma tabela para ver as linhas. O MonstarX mostra as primeiras 50.

O quadro no topo da lista mostra onde o banco de dados fica e qual é o nome dele. Abaixo das tabelas, Migrações lista todas as mudanças que deram forma ao banco de dados até agora (falamos delas mais abaixo). Depois que o app for usado, clique na seta de atualizar ao lado de Tabelas para contar as linhas de novo.

Quatro tabelas existem em todo app antes mesmo de você pedir qualquer coisa: user, session, account e verification. Elas guardam as pessoas que se cadastram no seu app e os logins delas. Veja Contas de usuário. Todas as outras tabelas foram criadas pelo MonstarX para o seu app, como menu_items ou recipes.

Sim, para consultar informações. SQL é a linguagem que os bancos de dados entendem. Digite uma consulta no campo no topo e clique em Executar. A resposta aparece em forma de tabela logo abaixo.

Por exemplo:

SELECT title, country_code, tags FROM recipes ORDER BY created_at DESC LIMIT 5

É bom saber:

  • O campo é somente leitura. Ele executa uma instrução por vez, e só instruções que leem dados: SELECT, WITH, PRAGMA e EXPLAIN. Qualquer coisa que alteraria os dados — INSERT, UPDATE, DELETE, DROP — é recusada, então não tem como quebrar o app sem querer.
  • Uma consulta mostra até 200 linhas.
  • PRAGMA table_info(recipes) lista as colunas de uma tabela.
  • Para um app cujos dados estão no Supabase ou no Railway Postgres, o campo aceita SELECT, WITH, TABLE e EXPLAIN.

Há dois jeitos fáceis, e nenhum deles exige SQL:

  • A aba Admin. Todo app tem um painel de administração ao lado de Prévia. Ele mostra as suas tabelas como formulários fáceis de usar, com a linguagem do seu negócio, onde você adiciona, edita e exclui registros — com Desfazer. A alteração entra no app na hora e não gasta créditos. Veja O painel Admin do seu app.
  • O chat. Diga o que você quer, como “adicione um Flat White ao cardápio de cafés por US$ 4,50” ou “exclua os pedidos de teste”. No modo Conversar, o MonstarX também consegue olhar os seus dados e responder perguntas sobre eles sem alterar nada — veja Criar, Planejar e Conversar.

O que o MonstarX faz no banco de dados quando cria o app?

Seção intitulada “O que o MonstarX faz no banco de dados quando cria o app?”

Quando uma funcionalidade precisa de um lugar para guardar informações, o MonstarX escreve uma migração: um conjunto numerado de instruções que cria ou altera tabelas, como 0001_create_menu_and_orders. Ele aplica a migração ao seu banco de dados e a salva junto com o código, para que as tabelas e o código sempre combinem. Algumas migrações já trazem dados iniciais, como um cardápio de exemplo (0002_seed_recipes no exemplo acima).

A lista Migrações no Backend mostra todas as que já foram executadas, em ordem. A 0000_monstarx_auth é do próprio MonstarX e cria as tabelas de contas.

Meus dados continuam lá quando altero ou restauro o app?

Seção intitulada “Meus dados continuam lá quando altero ou restauro o app?”

Sim. Os seus dados ficam separados do código:

  • Novas criações mantêm todas as linhas. Quando uma criação altera uma tabela — adiciona uma coluna, por exemplo —, ela faz isso com uma migração que preserva o que já existe.
  • Restaurar uma versão traz de volta apenas uma cópia anterior do código. Os dados do app não mudam. Veja Versões.
  • A prévia e o app publicado usam o mesmo banco de dados. Um pedido que você faz testando a prévia também aparece no app no ar, e vice-versa. É por isso que uma linha de exemplo adicionada durante os testes aparece para os seus clientes.

Posso guardar os dados no meu próprio banco de dados?

Seção intitulada “Posso guardar os dados no meu próprio banco de dados?”

Sim. Em BackendNuvem, Onde este app armazena seus dados deixa você escolher:

  • Banco de dados do MonstarX — o padrão, sem nada para configurar.
  • Supabase (Postgres) — o seu próprio projeto Supabase. Postgres é um banco de dados popular que muitas equipes já usam. Veja Supabase.
  • Railway (Postgres) — o seu próprio banco de dados no Railway. Veja Railway.
  • Firestore (seu projeto Firebase) — os registros do app no Firebase. Veja Firebase.

O MonstarX copia as tabelas, as linhas e as contas e reescreve o app para usar o novo lugar. Depois, se quiser, você volta com Mover de volta. Quando os dados ficam no Firestore, Banco de dados mostra as suas coleções do Firestore em vez de tabelas (somente leitura; quem grava é o app).

Posso editar uma linha direto na seção Banco de dados?

Não, a seção Banco de dados só faz leitura. Edite os registros na aba Admin, que funciona como uma planilha simples com Desfazer, ou peça ao MonstarX no chat. Veja O painel Admin do seu app.

Por que o meu pedido de teste apareceu no app no ar?

A prévia e o app publicado compartilham o mesmo banco de dados, então tudo o que você adiciona durante os testes vira dado real. Quando terminar, exclua as linhas de teste na aba Admin.

Restaurar uma versão antiga apaga os meus dados?

Não. Restaurar uma versão substitui apenas o código. Todas as linhas do banco de dados continuam como estão.

Posso baixar os meus dados?

Você pode ler qualquer tabela com uma consulta SELECT e copiar o resultado, ou mover os dados para o seu próprio banco Postgres no Supabase ou no Railway, onde você tem acesso total a eles.

Que tipo de banco de dados é esse?

Um banco de dados SQL privado para cada app. SQL é a linguagem padrão de bancos de dados, então qualquer desenvolvedor consegue trabalhar com ele. Se preferir Postgres, mova os dados para o Supabase ou o Railway.

Por que aparece uma mensagem dizendo que o app foi importado?

O MonstarX não cria banco de dados para um app importado: os dados ficam onde o próprio código dele os guarda. As chaves que ele lê ficam em Segredos.