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 |
|---|---|---|---|---|
| MySQL 9.7 | 9.7.2 | 6 de agosto de 2026 | Não relevante | Não relevante |
| MySQL 8.4 (padrão) | 8.4.11 | 1° de outubro de 2024 | Não relevante | Não relevante |
| MySQL 8.0 | 8.0.46 (padrão) 8.0.45 8.0.44 8.0.43 8.0.42 8.0.41 8.0.40 8.0.39 8.0.37 8.0.36 8.0.35 8.0.34 8.0.33 8.0.32 8.0.31 8.0.30 8.0.28 8.0.27 8.0.26 8.0.18 |
30 de agosto de 2020 | 1º de janeiro de 2027 | 1º Julho de 2029 |
| 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 |
Formato da versão do banco de dados do Cloud SQL
No MySQL, os dois primeiros dígitos da versão formam a versão principal, e o último número é a versão secundária. Por exemplo, na versão 5.7.13, o Cloud SQL usa 5.7 como a versão principal e 13 como a versão secundária.
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 Cloud de Confiance usando o console do Cloud de Confiance ou a gcloud CLI.
Console
Para uma única instância
-
No console do Cloud de Confiance , 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 Cloud de Confiance , 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 Cloud de Confiance , acesse a página Database Center.
- No seletor de projetos na barra de menus do console do Cloud de Confiance , selecione sua organização, pasta ou projeto do Cloud de Confiance .
- 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 doCloud de Confiance . 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
MYSQL_8_4 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: especifiqueMYSQLouPOSTGRESpara listar todas as instâncias desse mecanismo de banco de dados ou adicione a versão principal com pontos substituídos por sublinhados (por exemplo,MYSQL_8_4ouPOSTGRES_17) para corresponder a uma versão principal específica.
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é cinco meses depois do 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 MySQL e 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 MySQL e 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 dentro de três meses de versão de 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. Uma exceção a essa política é o Cloud SQL para MySQL 8.0, que provisiona novas instâncias na versão secundária padrão e só faz upgrade das versões secundárias de instâncias que estão ativadas para o upgrade automático de versão secundária. Para mais informações, consulte MySQL 8.0.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.
MySQL 8.0
O Cloud SQL provisiona instâncias do MySQL 8.0 na versão secundária padrão, que é uma versão secundária anterior à versão secundária mais recente.
O Cloud SQL oferece suporte ao upgrade automático de versão secundária das instâncias do Cloud SQL para MySQL 8.0 que executam a versão 8.0.35 ou mais recente do MySQL.
Por padrão, quando você cria uma instância do MySQL 8.0 sem especificar uma versão secundária, ela é ativada para upgrade automático de versão secundária. Se a instância do Cloud SQL para MySQL estiver executando a versão 8.0.35 ou posterior, será possível configurar a instância para ativar o upgrade automático de versões secundárias.
Quando o upgrade automático de versão secundária está ativado para sua instância, sua instância do Cloud SQL para MySQL é atualizada automaticamente para a versão secundária padrão do Cloud SQL para MySQL 8.0 durante a atualização de manutenção programada regular. Os upgrades ocorrem apenas durante eventos de manutenção programados, não durante a manutenção de autoatendimento.
Se a instância estiver executando o Cloud SQL para MySQL versão 8.0.34 ou anterior, faça upgrade manual da versão secundária do Cloud SQL para MySQL 8.0 para uma versão secundária mais recente. Para mais informações, consulte Fazer upgrade da versão secundária do banco de dados. Depois de fazer upgrade manual da instância para o Cloud SQL para MySQL versão 8.0.35 ou mais recente, será possível ativar o upgrade automático de versão secundária.