Políticas da versão do banco de dados

Nesta página, descrevemos as políticas de suporte a versões de banco de dados do AlloyDB para PostgreSQL.

Políticas de versão do AlloyDB e do AlloyDB Omni

O AlloyDB para PostgreSQL, que é executado no Google Cloud, e o AlloyDB Omni, que você instala e executa no seu próprio ambiente de computação, têm políticas de controle de versões relacionadas, mas distintas, conforme descrito nesta seção.

Políticas de versão do AlloyDB

As instâncias do AlloyDB executam um servidor de banco de dados criado e mantido pelo Google, que é totalmente compatível com o PostgreSQL. Você controla com qual versão principal do PostgreSQL suas instâncias são compatíveis. O AlloyDB mantém a compatibilidade de versão secundária das instâncias atualizada automaticamente.

Cada cluster do AlloyDB é compatível com uma versão principal específica do PostgreSQL, por exemplo, o PostgreSQL 16. Você escolhe a versão principal ao criar o cluster. Depois de escolher uma versão principal, o cluster vai manter essa versão durante todo o ciclo de vida, a menos que você inicie um upgrade de versão principal. É possível fazer upgrade de um cluster realizando um upgrade da versão principal no local ou migrando os dados do cluster para um novo cluster.

Cada instância do AlloyDB executa um serviço de banco de dados compatível com uma versão secundária específica do PostgreSQL, por exemplo, 16.3. O AlloyDB lança atualizações de compatibilidade de versão secundária várias vezes por ano e aplica essas atualizações automaticamente às instâncias. Essas atualizações mantêm todas as instâncias atualizadas com as correções de bugs e patches de segurança mais recentes disponíveis para a versão principal.

Políticas de versão do AlloyDB Omni

Cada versão do AlloyDB Omni é compatível com uma versão específica do PostgreSQL, conforme detalhado na Política de lançamento de compatibilidade de versões principais.

Como o AlloyDB Omni é um software que você instala e executa, também é sua responsabilidade atualizar regularmente a instalação do AlloyDB Omni conforme necessário. A disponibilidade de novas versões do AlloyDB Omni é anunciada nas notas da versão do AlloyDB para PostgreSQL.

Suporte a versões principais e secundárias

O AlloyDB é compatível com as seguintes versões do banco de dados PostgreSQL:

Versão compatível com PostgreSQL	AlloyDB	AlloyDB Omni
PostgreSQL 17 (pré-lançamento)	17,5	Não relevante
PostgreSQL 16 (padrão)	16.3	16.3
PostgreSQL 15	15.7	15.7 15.5 15,4 15.2
PostgreSQL 14	14.12	Não relevante

Compatibilidade com o PostgreSQL 17

Antes de usar o PostgreSQL 17 como versão do banco de dados, considere o seguinte:

O Google oferece compatibilidade com o PostgreSQL 17 como um recurso de prévia. Como acontece com qualquer recurso em pré-lançamento, não recomendamos que você aplique esse recurso a clusters que processam cargas de trabalho de produção.

Antes de usar o PostgreSQL 17 como versão do banco de dados, considere o seguinte:

• O PostgreSQL 17 não está disponível com o AlloyDB Omni.
• A replicação lógica do servidor em espera não é compatível.
• O Database Migration Service para PostgreSQL 17 para AlloyDB não é compatível.

Compatibilidade com o PostgreSQL 16

Antes de usar o PostgreSQL 16 como versão do banco de dados, considere o seguinte:

• A replicação lógica do servidor em espera não é compatível.
• As extensões pgrouting e pg_squeeze não são compatíveis.

Cronograma de suporte à versão principal

A tabela a seguir mostra as datas em que o suporte do AlloyDB para versões compatíveis foi disponibilizado para todos os usuários (GA):

Versão compatível com PostgreSQL	Data de disponibilidade geral do suporte à versão do AlloyDB	Data de disponibilidade geral do suporte à versão do AlloyDB Omni
PostgreSQL 16	23 de outubro de 2024	8 de abril de 2025
PostgreSQL 15	19 de janeiro de 2024	11 de outubro de 2023
PostgreSQL 14	12 de dezembro de 2022	Não relevante

Política de lançamento de compatibilidade de versão principal

Nosso objetivo é oferecer suporte oportuno à compatibilidade do AlloyDB com novas versões principais do PostgreSQL. O tempo específico depende do produto do AlloyDB:

• AlloyDB para PostgreSQL: nosso objetivo é oferecer compatibilidade com uma nova versão principal do PostgreSQL em até oito meses após o lançamento do PostgreSQL número MAJOR_VERSION.1.

  Planejamos oferecer suporte à compatibilidade do AlloyDB para PostgreSQL com qualquer versão principal do PostgreSQL por pelo menos o mesmo tempo que a comunidade do PostgreSQL oferece suporte a essa versão principal, ou seja, no mínimo cinco anos.

• AlloyDB Omni: nosso objetivo é oferecer suporte à compatibilidade com uma nova versão principal do PostgreSQL em até oito meses após o lançamento do PostgreSQL número MAJOR_VERSION.1.

  O número da versão dos lançamentos do AlloyDB Omni reflete a versão do suporte do PostgreSQL. Os números de versão do AlloyDB Omni usam o seguinte formato:

  MAJOR_VERSION.MINOR_VERSION.OMNI_VERSION
  

  Por exemplo, a versão 15.4.2 do AlloyDB Omni representa a versão 2 do lançamento do AlloyDB Omni que oferece suporte à compatibilidade com a versão 15.4 do PostgreSQL.

  Planejamos oferecer suporte à compatibilidade do AlloyDB Omni com qualquer versão principal do PostgreSQL por pelo menos o mesmo período em que a comunidade do PostgreSQL oferece suporte a essa versão principal, ou seja, no mínimo cinco anos.

• AlloyDB no Google Distributed Cloud: nosso objetivo é oferecer suporte à compatibilidade com uma nova versão principal do PostgreSQL em até quatro meses após a disponibilidade dessa versão principal no AlloyDB Omni.

Estas são diretrizes gerais. Os horários reais de lançamento de qualquer nova versão podem variar.

Plano de suspensão de uso da versão principal

O Google usa o cronograma de fim da vida útil da comunidade do PostgreSQL ao planejar o fim do suporte do AlloyDB para compatibilidade com qualquer versão principal do PostgreSQL.

Quando o Google pretende encerrar o suporte de compatibilidade para uma versão principal específica do PostgreSQL, oferecemos o seguinte aos proprietários de projetos:

• Avisos de fim de suporte, enviados com pelo menos 12 meses de antecedência.
• Ferramentas e documentação para minimizar a interrupção do upgrade, conforme necessário.

Ao final do período de 12 meses, será feito upgrade automático de qualquer cluster do AlloyDB que ainda estiver executando a versão principal descontinuada do banco de dados.

Dependências de versão para recursos do AlloyDB

Alguns recursos do AlloyDB podem exigir uma versão principal de compatibilidade com o PostgreSQL para serem executados em uma instância do AlloyDB. Qualquer recurso com esse requisito mínimo é indicado na documentação dele.

Suporte à versão secundária

O AlloyDB, o AlloyDB Omni e o AlloyDB na nuvem distribuída têm como objetivo lançar suporte de compatibilidade para uma nova versão secundária do PostgreSQL a cada trimestre. Essas atualizações incluem correções de bugs e de segurança. O cronograma pode variar dependendo da necessidade de correções de bugs adicionais.

Depois que o AlloyDB lança suporte para uma nova versão secundária do PostgreSQL, o Google aplica automaticamente essa atualização a todas as instâncias. Essas atualizações são propagadas durante um lançamento de manutenção subsequente. Para mais informações sobre a manutenção automática do AlloyDB, consulte Sobre a manutenção.

Por exemplo, se o AlloyDB lançar suporte para uma nova versão secundária do PostgreSQL 16, todas as instâncias de um cluster configurado com compatibilidade com o Postgres 16 serão atualizadas para essa nova versão secundária durante uma operação de manutenção programada subsequente.

Ao criar uma instância do AlloyDB, ela executa a versão secundária mais recente compatível na versão principal do PostgreSQL.

Para o AlloyDB Omni, faça o download e instale os binários que incluem compatibilidade com versões secundárias atualizadas do PostgreSQL.

Algumas versões do AlloyDB Omni são atualizações do próprio AlloyDB Omni, independentemente das atualizações de suporte ao PostgreSQL. Essas versões incluem correções de bugs e atualizações de segurança, e são refletidas por um incremento na última parte do número da versão.

Versão da CLI do AlloyDB Omni

A CLI do AlloyDB Omni usa um esquema de controle de versões MAJOR.MINOR que indica apenas a versão da própria CLI. Os números de versão e o cronograma de controle de versões existem independentemente do AlloyDB Omni.

A versão principal da CLI do AlloyDB Omni é incrementada apenas quando são introduzidas mudanças incompatíveis com a versão anterior da CLI.

Atualizações de segurança

Quando a comunidade PostgreSQL lança versões secundárias com correções de segurança, a equipe de segurança do AlloyDB as analisa para verificar a gravidade e o impacto.

No AlloyDB para PostgreSQL, as correções críticas são portadas para versões anteriores, e os clusters são atualizados como parte de um lançamento de manutenção subsequente. Nosso objetivo é aplicar patches críticos em um mês.

As correções menos graves são incluídas em upgrades futuros da versão secundária. Isso garante que seus clusters estejam sempre atualizados com as correções de segurança mais recentes e protegidos contra possíveis ataques.

Para o AlloyDB Omni, lançamos um novo binário com a correção e a nova versão secundária em até um mês após o lançamento da comunidade PostgreSQL.