Pular para o conteúdo

Bancos pelo painel

Tudo o que um banco gerenciado precisa cabe na aba Bancos do projeto: criar, conectar a um serviço, ver as credenciais, explorar tabelas, fazer backup, restaurar e apagar com lixeira de 30 dias. Esta página mostra o caminho pelo painel; para automatizar, veja PostgreSQL, MariaDB e SQLite.

  • Você precisa de um projeto e de um papel de membro ou superior para criar banco, fazer backup, restaurar, rotacionar e mover para a lixeira. Quem tem papel menor só vê.
  • Ver a senha do banco exige papel de administrador do time. Os demais membros usam a referência no app ou o explorador de dados.
  • O limite de bancos depende do seu plano. Veja Limites e cotas.
  1. Abra o projeto e entre na aba Bancos.
  2. Clique em Criar banco (ou Criar o primeiro banco, se a lista estiver vazia).
  3. Em Nome do banco, escreva um nome com minúsculas, números e hífen, começando por letra (ex.: db). Ele também vira o nome do serviço no grupo e o prefixo das referências, como ${{db.DATABASE_URL}}.
  4. Em Motor, escolha PostgreSQL, MariaDB ou SQLite (libSQL).
  5. Em Cota (MB), deixe 1024 ou informe outro valor. Passou da cota, o banco fica somente leitura até o uso baixar.
  6. Clique em Criar banco.

O painel avisa “Banco X sendo criado. As credenciais ficam disponíveis como variáveis do grupo.” O cartão do banco mostra Criando e passa para Pronto em instantes.

Motor Use quando
PostgreSQL É a escolha comum para apps novos (Node, Go, Rust, Python, Rails).
MariaDB O app ou a ferramenta pede MySQL ou MariaDB, como o WordPress.
SQLite (libSQL) O app já usa SQLite e você quer um banco gerenciado, com endereço e token, em vez de um arquivo em disco.

Você não copia a senha. O serviço recebe o valor por referência, resolvida a cada deploy.

  1. Abra o serviço (site) que vai usar o banco.
  2. Na área de variáveis, crie a variável que o app lê, por exemplo DATABASE_URL, com o valor ${{db.DATABASE_URL}}, trocando db pelo nome do seu banco.
  3. Faça deploy do serviço.

As referências de cada motor estão em Conexão e referências. Se você tiver um app com driver de banco e nenhum banco ligado, o painel pode sugerir esse caminho sozinho: veja Sugestões de persistência.

Clique no nome do banco no cartão para abrir o detalhe.

  • Uso mostra “N MB de M MB” com uma barra. A barra avisa a partir de 80% e marca cheio em 100%.
  • Endereço mostra host:porta e informa que o TLS é obrigatório. Quando disponível, mostra também o número de conexões.
  • Credenciais lembra a referência ${{nome.DATABASE_URL}}.

Para ver os valores reais, clique em Revelar credenciais e confirme sua identidade (Confirmação de identidade). Cada valor tem o botão Copiar. Os valores somem sozinhos em 1 minuto, ou na hora com Ocultar agora.

O banco só aceita conexões vindas de dentro da plataforma, então um cliente no seu computador é recusado mesmo com a senha certa. Para consultar dados sem montar nada, use o explorador abaixo.

No cartão do banco, clique em Abrir dados. A tela “Dados” tem a lista de tabelas à esquerda e três abas à direita.

Aba O que faz
Dados Mostra as linhas da tabela, 50, 100 ou 200 por página, com ordenação ao clicar no cabeçalho. A contagem total é uma estimativa. Há Exportar página (CSV) e Exportar página (JSON), que levam só a página atual.
Estrutura Lista colunas, tipo, se aceita nulo e a chave primária.
SQL Roda uma consulta. O modo Somente leitura é o padrão.

O modo Escrita da aba SQL altera o banco de verdade e só funciona para administradores e proprietários. O painel pede confirmação e a confirmação de identidade, e responde só quantas linhas foram afetadas, sem mostrar linhas. Um DROP ou DELETE não tem desfazer: faça um backup antes.

O histórico da aba SQL guarda só o texto das últimas 20 consultas, no seu navegador. Não escreva senhas no SQL.

Cada banco tem backup diário automático e backup manual. A política, o passo a passo de restaurar e o que fazer quando algo falha estão em Backup e restore.

  1. No detalhe do banco, clique em Rotacionar credenciais.
  2. Leia o aviso: a senha antiga deixa de funcionar e as conexões abertas são encerradas.
  3. Clique em Rotacionar e confirme sua identidade.
  4. Faça deploy dos serviços que usam o banco: eles ficam marcados como “precisa de redeploy”.
  1. No detalhe do banco, clique em Mover para a lixeira.
  2. Leia o aviso do prazo e dos efeitos e clique em Mover para a lixeira. Confirme sua identidade por e-mail ou passkey.

O painel faz um backup final antes de parar o banco. Se o backup falhar, nada muda. O banco fica suspenso, os serviços que dependem dele falham até você restaurar, e você tem 30 dias para desfazer.

Para desfazer, abra a Lixeira do time, aba Bancos, e clique em Restaurar na linha do banco. O banco volta com uma credencial nova, então os serviços dependentes precisam de redeploy. Depois de 30 dias o banco é apagado de vez. Veja Lixeira.

No menu lateral, Databases lista os bancos de todos os projetos do time, em abas por motor (PostgreSQL, MariaDB, SQLite), com projeto, estado, uso e host. Um alerta de Cota cheia ou Perto do limite aparece quando o uso aperta.

Estado Significado
Criando O banco ainda está sendo preparado.
Pronto Funcionando.
Somente leitura Passou da cota. Apague dados ou aumente a cota; ele volta sozinho ao ficar abaixo do limite.
Apagando Em remoção.
Com erro Algo falhou. Tente de novo e, se persistir, fale com o suporte.

O painel não tem campo para mudar a cota de um banco já criado. Isso é feito pela API (PostgreSQL, cota) ou por um agent.

Sintoma O que fazer
Não aparece o botão Criar banco Seu papel é só de leitura. Peça a um membro ou administrador.
Criar banco falha por limite O time atingiu o número de bancos do plano. Apague um banco não usado ou veja Limites e cotas.
Banco em Somente leitura Reduza o uso ou aumente a cota pela API.
Não vejo o botão Revelar credenciais A senha só é revelada para administradores. Use a referência no app ou Abrir dados.
App não conecta depois de rotacionar Faça deploy do app para ele ler a senha nova.