# 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](/bancos/postgres/), [MariaDB](/bancos/mariadb/) e [SQLite](/bancos/sqlite/).

## 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](/operacao/limites-e-cotas/).

## Criar um banco

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.

### 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

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](/bancos/conexao-e-referencias/). 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](/conectados/sugestoes-de-persistencia/).

## 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: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](/seguranca/confirmacao-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

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

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](/bancos/backup-restore/).

## Trocar a senha (rotacionar credenciais)

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".

## Apagar com backup final e lixeira

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](/operacao/lixeira/).

## 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

| 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](/bancos/postgres/#4-cota)) ou por um agent.

## 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](/operacao/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. |

## Próximos passos

- [Backup e restore](/bancos/backup-restore/)
- [Conexão e referências](/bancos/conexao-e-referencias/)
- [Sugestões de persistência](/conectados/sugestoes-de-persistencia/)
- [Lixeira](/operacao/lixeira/)
