- Documentação
- Catálogo — Ferramentas de Banco e Streaming
- PostgreSQL Gerenciado — Backups, Restauração e Alta Disponibilidade
Última atualização: 15 de novembro de 2026
PostgreSQL Gerenciado
Os bancos PostgreSQL do catálogo rodam como bancos gerenciados: a plataforma faz backup contínuo, mantém uma standby opcional pronta para assumir e instala atualizações na janela que você escolher.
Versões
Estão disponíveis o PostgreSQL 15, 16, 17 e 18. Todas as imagens gerenciadas incluem o binário do pgvector; a extensão vector é ativada por banco. As versões com PostGIS e TimescaleDB continuam no catálogo e usam os backups por snapshot descritos na visão geral do catálogo.
Extensões
Abra Configurações → Extensões do Postgres e ative pgvector. A plataforma instala vector no banco atual sem recriar o serviço nem reiniciar o PostgreSQL. O status mostra se a extensão está disponível, ativada ou ainda sendo aplicada. A mesma operação está disponível pela CLI com guara db extensions enable vector --service <nome> e guara db extensions disable vector --service <nome>; guara db extensions --service <nome> mostra o status. Na API, use PUT /api/v1/projects/:projectId/catalog-services/:serviceId/managed-database/extensions com { "name": "vector", "enabled": true } ou false para desativar. O MCP oferece db_extensions, db_extensions_enable e db_extensions_disable.
Para desativar, remova antes colunas, índices ou outros objetos que dependam de vector. A plataforma não exclui esses objetos automaticamente; a remoção da extensão permanece pendente enquanto houver dependências. Em bancos no engine legado Alpine, abra Configurações → Migrar para o Postgres gerenciado e conclua a migração antes de usar este controle.
Backups e a janela de recuperação
Dois tipos de backup trabalham juntos, ambos guardados fora do cluster:
| Backup | Quando |
|---|---|
| Backup contínuo | Cada alteração, copiada em minutos |
| Backup diário | Uma cópia completa por dia, e quando você clica em Fazer backup agora |
Juntos, eles permitem restaurar para qualquer momento dentro da janela de recuperação. O tamanho da janela depende do seu plano:
| Recurso | Starter | Pro | Max | Business | Enterprise |
|---|---|---|---|---|---|
| Janela de recuperação do PostgreSQL | 3 dias | 3 dias | 7 dias | 7 dias | 14 dias |
A aba Backups mostra a janela como uma linha do tempo, com uma marca para cada backup diário.
Restaurar em um novo banco
A restauração nunca sobrescreve o banco de origem. Abra Backups → Restaurar em novo banco, dê um nome ao novo banco e escolha:
- Mais recente — tudo o que já tem backup.
- Um momento específico — qualquer data e hora dentro da janela de recuperação, no seu fuso horário. Use para desfazer uma migração ruim ou um
DELETEacidental.
O novo banco recebe credenciais próprias. Aponte sua aplicação para ele depois de conferir os dados e exclua a cópia que não precisar mais.
Instância standby (alta disponibilidade)
Ative Configurações → Disponibilidade → Instância standby para manter uma cópia sincronizada do banco. Se a primária parar de responder, a standby assume automaticamente e sua string de conexão continua funcionando.
A standby usa a mesma CPU, memória e armazenamento da primária, contados no seu plano.
Janela de manutenção
Atualizações menores do PostgreSQL (correções de segurança e de bugs) são instaladas automaticamente em uma janela semanal de uma hora. Escolha o dia e a hora em Configurações → Janela de manutenção, ou instale uma atualização pendente na hora com Instalar agora. Com standby, a troca leva segundos; sem standby, espere um reinício rápido.
Atualização de versão principal
Configurações → Versão → Atualizar leva o banco para uma versão principal mais nova no próprio lugar. A plataforma faz um backup antes. O banco fica indisponível durante a atualização, normalmente por alguns minutos, e ela não pode ser desfeita. Se algo der errado, restaure o backup anterior à atualização em um novo banco.
Pool de conexões
As aplicações se conectam por um pool de conexões, no mesmo endereço e porta de sempre. Em Configurações → Pool de conexões você pode mudar para o modo sessão (necessário para prepared statements fora de transações e LISTEN/NOTIFY) e ajustar o número de conexões dentro dos limites do seu plano.
Permissões do usuário do banco
O usuário do banco da sua aplicação é dono do banco, mas não é superusuário, para que os backups, a standby e as atualizações da plataforma continuem funcionando. Três permissões extras começam desligadas em bancos novos. Ative-as em Configurações → Permissões do usuário do banco:
| Permissão | Atributo | O que o usuário pode fazer |
|---|---|---|
| Criar roles | CREATEROLE | Criar roles e gerenciar os que ele criou, como fazem muitas migrações. Disponível a partir do PostgreSQL 16. |
| Criar bancos | CREATEDB | Criar outros bancos no mesmo servidor. Eles usam o mesmo armazenamento e os mesmos backups, e se conectam pelo mesmo pool. |
| Ignorar segurança por linha (RLS) | BYPASSRLS | Ignorar políticas por linha, inclusive FORCE ROW LEVEL SECURITY, em todos os bancos deste servidor. Disponível em todas as versões do PostgreSQL gerenciado. |
As mudanças valem sem reiniciar o banco. Desligar uma permissão mantém o que o usuário já criou: os roles existentes continuam, mas o usuário não consegue mais alterá-los nem removê-los até você ligar Criar roles de novo.
Uma cópia restaurada (veja Restaurar em um novo banco) mantém as permissões do banco de origem. Um banco migrado do engine anterior começa com Criar roles e Criar bancos ligados (só Criar bancos no PostgreSQL 15), já que lá o usuário era superusuário. Ignorar segurança por linha começa desligado, inclusive após uma migração. Bancos existentes também mantêm essa opção desligada até você ativá-la explicitamente.
Ignorar segurança por linha atende aplicações que controlam o acesso aos dados sem depender de RLS. Essa opção não concede superusuário nem permissões de acesso às tabelas, não remove políticas e não desliga RLS para outros usuários. Ela vale para o usuário do banco deste serviço, inclusive nas conexões pelo pool. Se a aplicação conecta ou troca para outro role, valem os atributos desse outro role.
Ao desligar, o usuário volta às regras normais de RLS; donos de tabelas continuam ignorando RLS a menos que haja FORCE ROW LEVEL SECURITY. No PostgreSQL 16+, um usuário com CREATEROLE e BYPASSRLS pode criar outros roles com BYPASSRLS. Desligar esta opção não revoga esse atributo dos outros roles.
Pela CLI, use guara db privileges, guara db privileges enable --create-role --create-db, guara db privileges enable --bypass-rls e guara db privileges disable --bypass-rls. Veja os comandos da CLI.
Acesso público
Por padrão, o banco só é acessível de dentro do seu projeto. Para conectar de fora do Guara Cloud — do seu computador, de um CI ou de uma ferramenta de BI — ative o acesso público na aba Conexão do serviço, em Acesso público. O acesso público está disponível em todos os planos.
- Conexão com TLS obrigatória. Use a string de conexão pública mostrada no painel, com
sslmode=require. - Clientes com libpq 14 ou mais novo (ferramentas do PostgreSQL 14+). Versões anteriores não enviam o nome do host que a plataforma usa para rotear a conexão.
- Endereços permitidos. Limite o acesso a endereços IPv4 ou faixas CIDR específicas. Com a lista vazia, qualquer endereço pode tentar se conectar, mas só entra quem tem a senha do banco.
- Limite de conexões. O painel mostra quantas conexões de fora o banco aceita ao mesmo tempo.
Desativar o acesso público, ou remover um endereço da lista, recusa novas conexões na hora. Sessões já abertas continuam até o cliente desconectar; reiniciar o banco encerra todas.
Pela CLI, use guara db public, guara db public enable --allow <endereço> e guara db public disable. Veja os comandos da CLI.