Neste artigo
- Clones instantâneos de banco no PostgreSQL 18: copie produção em segundos no CI
- O que mudou no PostgreSQL 18
- Onde o clone funciona
- Passo a passo: clonar o banco de produção para teste
- Por que isso muda o CI
- Limites que você precisa saber
- O PostgreSQL 18 já está disponível?
- Clone de banco ocupa quanto espaço em disco?
- Dá para clonar com banco em produção ouverte?
- Funciona no Docker em qualquer lugar?
- Clone substitui backup?
- Teste seu banco com clones instantâneos agora
Clones instantâneos de banco no PostgreSQL 18: copie produção em segundos no CI
Os clones instantâneos do PostgreSQL 18 copiam um banco de produção em segundos, sem ocupar espaço extra, com `file_copy_method = clone` em filesystem com reflink.
O benchmark do boringSQL de 22 de dezembro de 2025 mostra a diferença: copiar um banco de 6 GB com o método antigo `WAL_LOG` levou 67 segundos (67.000 ms), enquanto o clone copia na hora.
Este tutorial mostra o passo a passo para usar clones em ambientes de teste e no seu pipeline de CI.
O que mudou no PostgreSQL 18
O PostgreSQL 18 foi lançado em 25 de setembro de 2025, segundo as notas oficiais de release (postgresql.org/docs/18/release-18.html). Nela entrou a variável de servidor `file_copy_method`, que controla se o `CREATE DATABASE ... STRATEGY=FILE_COPY` faz cópia física ou clone (contribuição de Nazir Bilal Yavuz).
O padrão continua `copy`. Para ativar o clone, ajuste no postgresql.conf e recarregue:
- `file_copy_method = clone`
- `SHOW file_copy_method;` deve retornar `clone`
Onde o clone funciona
O clone usa copy-on-write do filesystem, então só funciona em:
- Linux com XFS com reflinks ou ZFS
- macOS com APFS
- FreeBSD com ZFS
Em ext4 comum o PostgreSQL cai de volta para a cópia física sem avisar. Verifique o filesystem do diretório de dados antes de contar com a velocidade.
Passo a passo: clonar o banco de produção para teste
Com o cluster do PostgreSQL 18+ no filesystem certo e `file_copy_method = clone`:
- congele um template: `CREATE DATABASE teste_template TEMPLATE producao STRATEGY=FILE_COPY;` (o banco de origem não pode ter conexões ativas durante o clone)
- para cada teste, crie um clone novo a partir do template
- ao terminar o teste, drope o clone: `DROP DATABASE teste_1;`
No CI, o fluxo vira: build sobe Postgres 18 em container com volume XFS/ZFS, gera o template uma vez e cada job de teste recebe um clone próprio em segundos.
Por que isso muda o CI
Antes, cada suite de teste restaurava um `pg_dump`, o que em banco grande levava minutos. Com clone, cada job roda isolado contra uma cópia idêntica da produção.
O boringSQL mediu 67 segundos para 6 GB com `WAL_LOG`. Com clone a mesma operação é quase instantânea e não consome disco adicional até alguém escrever nos blocos.
O `pg_upgrade` do PostgreSQL 18 também ganhou `--jobs` para paralelizar e `--swap` para trocar diretórios em vez de copiar, o que deixa upgrades grandes mais rápidos.
Limites que você precisa saber
- O banco usado como template não pode ter conexões ativas no momento do `CREATE DATABASE`.
- Clone é copy-on-write: o espaço só cresce quando os dados divergem. Se o teste escreve muito, o consumo de disco acompanha.
- Não use clone como backup: ele compartilha blocos físicos com a origem. Backup continua sendo `pg_basebackup`.
- Em filesystem sem suporte a reflink, o comando cai para cópia física sem erro.
Perguntas frequentes
O PostgreSQL 18 já está disponível?
Sim. Foi lançado em 25 de setembro de 2025, conforme as notas oficiais de release do projeto.
Clone de banco ocupa quanto espaço em disco?
Quase nada no início: é copy-on-write. O espaço só é consumido quando os blocos são modificados, seja na origem seja no clone.
Dá para clonar com banco em produção ouverte?
Não. O `CREATE DATABASE ... TEMPLATE` exige que o banco de origem não tenha conexões ativas durante a cópia. Faça o clone a partir de um template preparado com antecedência.
Funciona no Docker em qualquer lugar?
Só se o volume do container estiver em XFS com reflinks, ZFS ou APFS. Em overlay2 padrão do Docker, cai para cópia física.
Clone substitui backup?
Não. Clone compartilha blocos com a origem. Para backup use `pg_basebackup` ou cópias lógicas com `pg_dump`.
Teste seu banco com clones instantâneos agora
Monte um ambiente de homologação com PostgreSQL 18 em XFS e rode o primeiro clone hoje. Quem trabalha com dados pode ver as vagas de TI abertas em times que usam pipeline de teste automatizado.
Acesse a editoria de programação para mais tutoriais de banco, as trilhas de estudo do portal e pese o projeto na calculadora CLT × PJ. Comece com um banco pequeno e meça o tempo do seu primeiro clone.
Dados conforme as notas oficiais de release do PostgreSQL 18 (postgresql.org/docs/18/release-18.html, release de 25/09/2025) e o artigo "Instant database clones with PostgreSQL 18" do boringSQL (boringsql.com/posts/instant-database-clones/, Radim Marek, 22/12/2025), acessados em 7 de novembro de 2026.