Nesta página, descrevemos as políticas de suporte à versão do banco de dados do Cloud SQL.
Versões de banco de dados compatíveis com o Cloud SQL
Os mecanismos de banco de dados compatíveis com o Cloud SQL incluem várias versões. As versões podem variar em recursos e nos tipos de problemas que surgem. Embora um upgrade possa afetar seus usuários, fornecer recursos atualizados do banco de dados e patches importantes também é fundamental. O Cloud SQL mantém as instâncias atualizadas automaticamente com patches e versões secundárias.
Versões principais e secundárias compatíveis com o Cloud SQL
O Cloud SQL é compatível com as seguintes versões de banco de dados.
| Versão principal | Versão secundária | Data de início do suporte regular | Data de início do suporte estendido | Data da suspensão do uso |
|---|---|---|---|---|
| PostgreSQL 18 (padrão) | 18,6 | 25 de setembro de 2025 | - | - |
| PostgreSQL 17 | 17.11 | 22 de outubro de 2024. | 1 de fevereiro de 2030 | 1 de fevereiro de 2033 |
| PostgreSQL 16 | 16.15 | 7 de junho de 2024 | 1 de fevereiro de 2029 | 1 de fevereiro de 2032 |
| PostgreSQL 15 | 15.19 | 24 de maio de 2023 | 1 de fevereiro de 2028 | 1 de fevereiro de 2031 |
| PostgreSQL 14 | 14.24 | 11 de novembro de 2021 | 1 de fevereiro de 2027 | 1 de fevereiro de 2030 |
| PostgreSQL 13 | 13,23 | 5 de novembro de 2020 | 1 de fevereiro de 2026 | 1 de fevereiro de 2029 |
| PostgreSQL 12 | 12,22 | 21 de maio de 2020 | 1º de fevereiro de 2025* | 1 de fevereiro de 2028 |
| PostgreSQL 11 | 11.22 | 27 de setembro de 2019 | 1º de fevereiro de 2025* | 1 de fevereiro de 2028 |
| PostgreSQL 10 | 10.23 | 27 de março de 2020 | 1º de fevereiro de 2025* | 1 de fevereiro de 2028 |
| PostgreSQL 9.6 | 9.6.24 | 1º de abril de 2018 | 1º de fevereiro de 2025* | 1 de fevereiro de 2028 |
Formato da versão do banco de dados do Cloud SQL
No PostgreSQL 9.6, o número da versão principal é composto pelos dois primeiros dígitos, e o último número é o da versão secundária. Por exemplo, na versão 9.6.1, o Cloud SQL usa a versão 9.6 como versão principal e 1 como versão secundária. No PostgreSQL 10 e versões mais recentes, o primeiro número é o da versão principal. Por exemplo, na versão 10.1, 10 é o número da versão principal, e 1 é o número da versão secundária.
Como identificar a versão do banco de dados da sua instância do Cloud SQL
Você especifica a versão do banco de dados ao criar uma instância do Cloud SQL. Se você não especificar uma versão do banco de dados, o Cloud SQL usará a versão padrão.
É possível verificar a versão do banco de dados de uma única instância do Cloud SQL ou encontrar instâncias por versão em um projeto, uma pasta ou uma organização do Google Cloud usando o console do Google Cloud ou a gcloud CLI.
Console
Para uma única instância
-
No console do Google Cloud , acesse a página Instâncias do Cloud SQL.
- Para abrir a página Visão geral de uma instância, clique no nome dela.
- No card Configuração, confira a Versão do banco de dados.
Em um único projeto
-
No console do Google Cloud , acesse a página Instâncias do Cloud SQL.
- No campo Filtro, selecione Tipo. As versões do banco de dados no seu projeto são listadas.
- Selecione uma versão do banco de dados para filtrar as instâncias no seu projeto.
Em uma organização, pasta ou projeto
Para ver as instâncias do Cloud SQL e as versões de banco de dados delas em uma
organização ou pasta na
Central de bancos de dados, verifique
se você tem o papel de Leitor da Central de bancos de dados
(roles/databasecenter.viewer) do Identity and Access Management (IAM) nessa
organização ou pasta. Para mais informações, consulte
Configurar a
Central do banco de dados.
-
No console do Google Cloud , acesse a página Database Center.
- No seletor de projetos na barra de menus do console do Google Cloud , selecione sua organização, pasta ou projeto do Google Cloud .
- Clique em Todos os recursos e use o filtro Produtos e versões para selecionar as versões do Cloud SQL que você quer inspecionar.
- Opcional: para fazer o download do inventário de frota filtrado em um arquivo CSV, clique em Exportar CSV. Para mais informações, consulte Filtrar recursos e exportar informações de inventário da frota.
gcloud
Para informações sobre como instalar e dar os primeiros passos com a CLI gcloud, consulte Instalar a CLI gcloud. Para mais informações sobre como iniciar o Cloud Shell, consulte Usar o Cloud Shell.
Em um único projeto
Para listar as instâncias do Cloud SQL e as versões de banco de dados delas em um único projeto, use o comando gcloud sql instances
list:
gcloud sql instances list --project=PROJECT_ID
Substitua PROJECT_ID pelo ID do seu projeto doGoogle Cloud . Para filtrar por mecanismo ou versão principal, adicione
--filter="databaseVersion:VERSION_PREFIX*", em que
VERSION_PREFIX é um prefixo de tipo enumerado da API, como
POSTGRES ou POSTGRES_17.
Em uma organização, pasta ou projeto
Para listar instâncias do Cloud SQL em uma organização ou pasta usando gcloud asset
list, verifique se a API Inventário de recursos do Cloud está ativada no projeto de cota e se você tem o papel do IAM de Leitor de recursos do Cloud (roles/cloudasset.viewer) na organização, pasta ou projeto. Para mais informações, consulte Papéis e permissões.
gcloud asset list \
--organization=ORGANIZATION_ID \
--asset-types="sqladmin.googleapis.com/Instance" \
--content-type=resource \
--filter="resource.data.databaseVersion:VERSION_PREFIX*" \
--format="table(
resource.data.project,
resource.data.name,
resource.data.databaseVersion,
resource.data.state,
resource.data.settings.activationPolicy,
resource.data.region
)"
Substitua:
ORGANIZATION_ID: o ID numérico da sua organização. Para consultar uma pasta ou um único projeto, substitua--organization=ORGANIZATION_IDpor--folder=FOLDER_IDou--project=PROJECT_ID.VERSION_PREFIX: o mecanismo de banco de dados ou o prefixo da versão principal no formatosqladmin.googleapis.com/Instance: especifiquePOSTGRESpara listar todas as instâncias do Cloud SQL para PostgreSQL ou especifiquePOSTGRES_MAJOR_VERSIONcom pontos substituídos por sublinhados (por exemplo,POSTGRES_14ouPOSTGRES_17) para corresponder a uma versão principal específica. Para strings de tipo enumerado de API compatíveis, consulteSqlDatabaseVersion.
A saída inclui as instâncias em execução
(activationPolicy: ALWAYS) e as instâncias interrompidas
(activationPolicy: NEVER), além do ID do projeto, do nome da instância,
da versão completa do banco de dados, do estado e da região.
Ciclo de vida da versão principal
Nesta seção, descrevemos o ciclo de vida do suporte para as versões principais do Cloud SQL.
Suporte regular
O Cloud SQL é compatível com as novas versões principais em até 90 dias após o lançamento da disponibilidade geral pela comunidade de desenvolvedores do mecanismo de banco de dados. A primeira fase é o suporte regular. Durante o suporte regular, o Cloud SQL oferece atualizações de versões secundárias e de manutenção para o mecanismo de banco de dados. O Cloud SQL também aplica correções de segurança às instâncias. O Cloud SQL oferece suporte regular a uma versão principal desde que a comunidade de desenvolvedores do mecanismo de banco de dados também ofereça. Depois que a versão principal atinge o fim da vida útil (EOL, na sigla em inglês) pela comunidade, ela entra no suporte estendido do Cloud SQL.Suporte estendido
Para as versões principais do Cloud SQL para PostgreSQL que chegaram ao fim da vida útil, o Cloud SQL oferece suporte estendido. Com o suporte estendido, será possível continuar executando as instâncias do Cloud SQL por três anos, mesmo depois que a comunidade de desenvolvedores pare de oferecer suporte às versões principais em que as instâncias estão em execução. O suporte estendido é oferecido por três anos. É possível usar esse tempo para planejar, testar e fazer o upgrade das instâncias para uma versão principal com suporte regular. Para mais informações sobre como realizar um upgrade da versão principal, consulte Fazer upgrade da versão principal do banco de dados no local e Fazer upgrade da versão principal do banco de dados migrando dados.
Para mais informações sobre o suporte estendido, consulte Suporte estendido no Cloud SQL.
Descontinuação
Depois que o suporte estendido de uma versão principal específica é encerrado, o Cloud SQL descontinua essa versão. Uma instância em execução em uma versão principal descontinuada é atualizada automaticamente para a versão principal e secundária padrão do mecanismo de banco de dados. O Cloud SQL envia um aviso de descontinuação aos proprietários dos projetos pelo menos 12 meses antes da data de descontinuação.
Para as versões principais do Cloud SQL para PostgreSQL, os proprietários dos projetos recebem um aviso de descontinuação no final do segundo ano de suporte estendido.
Suporte à versão secundária
O Cloud SQL aceita novas versões secundárias em até 30 dias após o lançamento da disponibilidade geral pela comunidade de desenvolvedores do mecanismo de banco de dados. Depois que o Cloud SQL aceita uma nova versão secundária, ele provisiona novas instâncias na nova versão automaticamente. Durante o próximo lançamento de manutenção programada, o Cloud SQL atualiza as instâncias atuais para a nova versão.O Cloud SQL determina a versão secundária de destino para cada mecanismo de banco de dados. Quando a versão secundária de destino é diferente da versão secundária de uma instância do Cloud SQL, o upgrade dessa versão é feito durante o próximo ciclo de manutenção do Cloud SQL. É possível controlar o dia e a hora em que as reiniciações de manutenção ocorrem. Basta definir a janela de manutenção da instância.