<\> Casa do Dev
Notícias abrir
Ferramentas abrir
Vagas abrir
Aprender abrir
Comunidade abrir
Guia de Compras abrir

Clones instantâneos de banco no PostgreSQL 18: copie produção em segundos no CI

DA

4 min

Entusiasta das Tecnologias

Clones instantâneos de banco no PostgreSQL 18: copie produção em segundos no CI

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.

Neste artigo

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.

Produtos relacionados

Este conteúdo tem links de afiliado: se você comprar por eles, podemos receber uma comissão sem custo extra para você. A escolha dos produtos segue critérios próprios e não é influenciada por comissão.

O que você achou deste artigo?

Responda a Pergunta do Dia Teste seu conhecimento e mantenha sua streak. Crie seu Dev Card público Perfil dev compartilhável em um único link.

Depois dessa formação...

Veja vagas em tecnologia →

Vagas relacionadas

Ver todas as vagas →
DA

Escrito por

Dagmar Cirino

Entusiasta das Tecnologias

Atualizado em 09/11/2026 •

Sou o Cirino, e desenvolvo soluções e produtos utilizando linguagens de programação e ferramentas de analytics e monitoração baseadas em Cloud. Trabalho com tecnologia desde 2010,...

Ver perfil do autor

COMPARTILHAR