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.
Antes de começar
Seção intitulada “Antes de começar”- 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.
Criar um banco
Seção intitulada “Criar um banco”- Abra o projeto e entre na aba Bancos.
- Clique em Criar banco (ou Criar o primeiro banco, se a lista estiver vazia).
- 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}}. - Em Motor, escolha PostgreSQL, MariaDB ou SQLite (libSQL).
- Em Cota (MB), deixe 1024 ou informe outro valor. Passou da cota, o banco fica somente leitura até o uso baixar.
- 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.
Qual motor escolher
Seção intitulada “Qual motor escolher”| 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. |
Conectar o banco a um serviço
Seção intitulada “Conectar o banco a um serviço”Você não copia a senha. O serviço recebe o valor por referência, resolvida a cada deploy.
- Abra o serviço (site) que vai usar o banco.
- Na área de variáveis, crie a variável que o app lê, por exemplo
DATABASE_URL, com o valor${{db.DATABASE_URL}}, trocandodbpelo nome do seu banco. - 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.
Ver a conexão e as credenciais
Seção intitulada “Ver a conexão e as credenciais”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:portae 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.
Explorar tabelas e linhas
Seção intitulada “Explorar tabelas e linhas”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.
Backups e restauração
Seção intitulada “Backups e restauração”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.
Trocar a senha (rotacionar credenciais)
Seção intitulada “Trocar a senha (rotacionar credenciais)”- No detalhe do banco, clique em Rotacionar credenciais.
- Leia o aviso: a senha antiga deixa de funcionar e as conexões abertas são encerradas.
- Clique em Rotacionar e confirme sua identidade.
- Faça deploy dos serviços que usam o banco: eles ficam marcados como “precisa de redeploy”.
Apagar com backup final e lixeira
Seção intitulada “Apagar com backup final e lixeira”- No detalhe do banco, clique em Mover para a lixeira.
- 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.
Ver todos os bancos do time
Seção intitulada “Ver todos os bancos do time”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.
Estados do banco
Seção intitulada “Estados do banco”| 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.
Se algo der errado
Seção intitulada “Se algo der errado”| 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. |