Começar

Bancos de dados: PostgreSQL, MySQL e Valkey.

Bancos de dados gerenciados para o seu projeto: variáveis de conexão, restauração para qualquer minuto dos últimos 7 dias, alertas de disco, acesso externo, a aba Dados com tabelas, consultas, importação e exportação, e réplicas de leitura.

7 MIN DE LEITURA

Adicione um banco de dados a um projeto e o seu aplicativo se conecta a ele sozinho — sem senhas para copiar. Backups, restauração e alertas de disco ficam por nossa conta.

Visão geral → Serviços → Adicionar um serviço e escolha:

BancoPara
PostgreSQL 17a maioria dos aplicativos
MySQL 8.4aplicativos feitos para MySQL
Valkey 8um armazenamento compatível com Redis para filas, cache e sessões — Horizon, Celery, BullMQ, Sidekiq

Dê um nome a ele (por exemplo, db) e escolha os recursos. Um banco de dados novo começa com 1 GB de memória, 1 núcleo de CPU e 10 GB de disco — R$ 58,35 por mês. O preço segue o de qualquer serviço: R$ 35,01 por GB de memória, R$ 23,34 por núcleo, 10 GB de disco inclusos para cada GB de memória e depois R$ 0,88 por GB.

Conexão: nada para configurar

Os serviços do projeto acessam o banco de dados pela rede privada do projeto, pelo nome dele. Eles já recebem os dados de conexão como variáveis:

  • PostgreSQL / MySQL: DATABASE_URL, DB_CONNECTION, DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME, DB_PASSWORD; o PostgreSQL também PGHOST, PGPORT, PGDATABASE, PGUSER, PGPASSWORD.
  • Valkey: REDIS_URL, REDIS_HOST, REDIS_PORT, REDIS_PASSWORD, REDIS_CLIENT.
  • Todo banco de dados também fornece RIVERVO_<NAME>_URL — para um banco chamado db, RIVERVO_DB_URL.

Em Visão geral → Conexão do banco aparecem o host, a porta, o banco e o usuário, além da lista de Variáveis que o projeto recebe. O aplicativo passa a usar as variáveis no próximo deploy.

Um segundo banco de dados. Só o primeiro banco de cada tipo recebe os nomes de sempre. Se o projeto já tem um, o novo banco adiciona apenas a própria RIVERVO_<NAME>_URL, e o aplicativo continua usando o primeiro. Para trocar, defina DATABASE_URL e DB_* na aba Variáveis com os valores do novo banco.

Backups e restauração para qualquer minuto

O PostgreSQL e o MySQL têm backup contínuo: cada alteração é salva no momento em que acontece, então o banco pode voltar para qualquer minuto dos últimos 7 dias. Também é feita uma cópia completa todos os dias. Tudo é guardado criptografado, separado do banco de dados.

Para restaurar: aba Backups do banco → Restaurar para um momento, escolha a data e a hora (qualquer minuto desde o início do período até alguns minutos atrás) e clique em Restaurar para este momento. A lista logo abaixo traz as cópias diárias (e as feitas com Fazer backup agora); cada uma também pode ser restaurada.

Antes de qualquer restauração, fazemos primeiro um backup do estado atual, então uma restauração sempre pode ser desfeita. O banco fica indisponível por pouco tempo enquanto é restaurado; o painel mostra o andamento.

O Valkey tem backup diário; guardamos os últimos 7 dias e 4 semanas.

A restauração está disponível para o titular da conta e para os Administradores do aplicativo.

Backups do próprio aplicativo

O aplicativo principal tem uma aba Backups própria para os arquivos que ele guarda no disco (por exemplo, uploads ou um banco SQLite do Laravel). Eles têm backup diário e são guardados criptografados; mantemos os últimos 7 dias e 4 semanas. Fazer backup agora cria uma cópia extra a qualquer momento.

Disco: um limite fixo, com avisos

O disco de um banco de dados tem exatamente o tamanho que você escolheu. Avisamos por e-mail (e pelo Telegram, se você o conectou) quando ele chega a 80% e 90%, e de novo se ele encher. Um disco cheio não para o banco: ele continua respondendo, mas não consegue salvar dados novos até o disco ser aumentado.

Para aumentar o disco: Configurações → Recursos do banco, mova o controle Disco e clique em Aplicar. Leva só um instante e não exige reinicialização.

Acesso externo

Por padrão, só os serviços do projeto acessam um banco de dados. Para conectar a partir do seu computador, de uma ferramenta de BI ou de outro servidor, abra Visão geral → Acesso externo → Liberar acesso do banco:

  1. Adicione os endereços que podem se conectar — um único IP (203.0.113.7) ou uma rede (198.51.100.0/24). Adicionar meu endereço inclui o que você está usando agora.
  2. Salvar endereços. O painel mostra o host externo, a porta e uma String de conexão.

As conexões externas são criptografadas com um certificado para o próprio endereço do banco:

  • O PostgreSQL só aceita conexões externas criptografadas.
  • O Valkey só as aceita por TLS.
  • O MySQL oferece criptografia — ative-a no seu cliente (modo SSL «required»).

Bloquear acesso encerra as conexões externas na hora; os serviços do projeto continuam funcionando como antes. Liberar e bloquear o acesso está disponível para o titular da conta e para os Administradores do aplicativo.

A aba Dados

Todo banco de dados tem uma aba Dados, para você ver e trabalhar com os seus dados sem instalar nada.

Tabelas e consultas (PostgreSQL, MySQL)

  • Tabelas — navegue por qualquer tabela, 50 linhas por página, somente leitura. Buscar uma tabela filtra a lista.
  • Editor SQL — execute consultas com o usuário do próprio banco. Consultas de leitura rodam na hora; comandos que alteram dados pedem confirmação. Até 30 segundos e 1.000 linhas por consulta.

Chaves e comandos (Valkey)

Navegue pelas chaves por padrão (por exemplo, user:*) e veja os valores delas; execute um comando por vez na sintaxe normal do Valkey. Comandos que alteram dados pedem confirmação. FLUSHALL, FLUSHDB, CONFIG, SHUTDOWN, DEBUG e scripts não estão disponíveis aqui.

Importação

Dados → Importação e exportação → Importar dados, a partir de uma de três origens:

  • De um arquivo — .sql ou .sql.gz; para PostgreSQL, também um arquivo pg_dump -Fc (.dump). Até 2 GB (e não mais do que o disco do banco); mantenha a página aberta até o upload terminar.
  • De um link — um link para o arquivo de dump que abra sem login, como um link temporário do seu armazenamento. Dumps grandes são transferidos em fluxo contínuo, então funciona qualquer tamanho que caiba no disco.
  • De outro banco de dados — outro banco do mesmo tipo acessível pela internet: PostgreSQL para PostgreSQL, MySQL ou MariaDB para MySQL. Primeiro verificamos a conexão e depois copiamos os dados direto para cá. A senha é usada só para essa cópia e não fica guardada.

Antes de cada importação, salvamos um backup dos dados atuais, então eles sempre podem ser restaurados na aba Backups. Tabelas e outros objetos da importação substituem os que têm o mesmo nome; todo o resto continua como está. Enquanto isso, o banco continua funcionando, e você pode sair da página.

Exportação

Exportar → Criar uma cópia prepara uma cópia atualizada: um arquivo do PostgreSQL (.dump, restaure com pg_restore) ou um arquivo SQL compactado (.sql.gz) para MySQL. O link de download aparece quando a cópia fica pronta e funciona por 24 horas.

Quem pode fazer o quê

A aba Dados — ver os dados, alterá-los no editor, importar e exportar — está disponível para o titular da conta e para quem tem o papel de Desenvolvedor ou Administrador no aplicativo. O papel Leitor não vê os dados. Veja Acesso a um aplicativo.

Réplicas de leitura (PostgreSQL, MySQL)

Uma réplica de leitura é uma cópia do banco de dados que acompanha cada alteração em segundos. Mande para ela relatórios, análises, exportações e outras leituras pesadas, e o banco principal continua rápido para as gravações.

Visão geral do banco → Réplicas de leitura → Adicionar uma réplica de leitura. Até 2 réplicas por banco de dados.

  • A réplica guarda uma cópia completa dos dados, então o disco dela é pelo menos do tamanho do disco do principal.
  • O projeto recebe a variável própria da réplica, RIVERVO_<NAME>_URL (pelo nome da réplica); a DATABASE_URL continua no principal.
  • A primeira cópia leva alguns minutos, conforme o tamanho dos dados; enquanto isso, o principal continua funcionando.
  • A réplica aceita só consultas de leitura. Os backups e a restauração para um momento ficam com o principal.
  • O painel mostra quanto ela está atrasada (Atualizada ou o atraso em segundos). Se ela ficar mais de um minuto atrasada por 5 minutos, avisamos você e verificamos o problema nós mesmos.

Uma réplica é cobrada como qualquer serviço, pelos próprios recursos.

Promover uma réplica

Configurações da réplica → Promover. Ela deixa de acompanhar o principal de vez, passa a aceitar gravações e ganha backups próprios. Isso leva cerca de um minuto. O projeto mantém a DATABASE_URL no banco original; para levar o aplicativo para o banco promovido, altere DATABASE_URL e DB_* na aba Variáveis.

Ainda com dúvidas?

Fale com a gente no chat — a AI responde na hora e um engenheiro entra quando é preciso, a qualquer hora do dia.

Falar com o suporte