升级数据库次要版本

MySQL   |  PostgreSQL   |  SQL Server

本页介绍如何升级 MySQL 实例的次要版本。如需了解受支持的版本，请参阅数据库版本及版本政策。

注意：如需升级数据库的主要版本，请参阅通过迁移数据升级数据库主要版本或就地升级数据库主要版本。

在每次发布新的次要版本时，数据库提供商都会在其中发布新功能、安全补丁程序、问题修复和性能改进。此外，Cloud SQL 会在维护期间定期为您更新次要版本。

但 MySQL 8.0 不支持降级。因此，其次要版本升级不会自动包含在例行维护中。您可以在创建实例时指定 Cloud SQL for MySQL 8.0 的次要版本，也可以通过后续的某次升级流程指定次要版本，本页面介绍了这两种方式。

在升级到新的 MySQL 8.0 次要版本之前，请先自行熟悉其中的变化。请参阅 MySQL 8.0 版本说明。如果您使用的是 Cloud SQL for MySQL 5.6 或 5.7，Cloud SQL 会自动管理实例的次要版本。在您预配新实例时，Cloud SQL 会自动使用最新可用数据库版本配置您的实例。在例行维护期间，Cloud SQL 会自动将您的实例升级到最新的受支持版本。

要升级 MySQL 8.0 实例的数据库次要版本，您需要使用首选次要版本更新实例，而且这个版本必须高于当前安装的次要版本。预配实例后，您就不能再还原到未指定的次要版本。

如果您运行的是 Cloud SQL 企业 Plus 版实例，则次要版本升级会在几乎没有停机时间的情况下完成。

升级之前

Cloud SQL 支持 MySQL 8.0 实例的次要版本升级。MySQL 8.0 不允许降级。因此，在升级主实例之前，请先执行以下步骤以确保数据安全。

1. 选择数据库的目标次要版本。

   gcloud

   如需了解如何安装和开始使用 gcloud CLI，请参阅安装 gcloud CLI。如需了解如何启动 Cloud Shell，请参阅使用 Cloud Shell。

   如需了解数据库的哪些次要版本可进行就地升级，请执行以下操作：

   1. 运行以下命令：

   gcloud sql instances describe INSTANCE_NAME
      

   将 INSTANCE_NAME 替换为实例名称。

   2. 在命令的输出中，找到标记为 upgradableDatabaseVersions 的部分。
   3. 每个子部分都会返回一个可升级的数据库版本。在每个子部分中，请查看以下字段。
   • name：数据库版本字符串，其中包含 Cloud SQL for MySQL 次要版本就地升级的数据库目标主要版本和次要版本。

   REST v1

   如需了解数据库的哪些次要版本可进行就地升级，请使用 Cloud SQL Admin API 的 instances.get 方法。

   在使用任何请求数据之前，请先进行以下替换：

   • INSTANCE_NAME：实例名称。

   HTTP 方法和网址：

   GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME

   如需发送您的请求，请展开以下选项之一：

   curl（Linux、macOS 或 Cloud Shell）

   注意：以下命令假定您已使用您的用户账号通过运行 gcloud init 或 gcloud auth login 登录 gcloud CLI，或者使用了 Cloud Shell，这会使您自动登录 gcloud CLI。您可以运行 gcloud auth list 来检查当前活跃的账号。

   执行以下命令：

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME"

   PowerShell (Windows)

   注意：以下命令假定您已使用您的用户账号通过运行 gcloud init 或 gcloud auth login 登录 gcloud CLI。您可以运行 gcloud auth list 来检查当前活跃的账号。

   执行以下命令：

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

   您应该收到类似以下内容的 JSON 响应：

   
   upgradableDatabaseVersions:
   
   {
     major_version: "MYSQL_8_0"
     name: "MYSQL_8_0_36"
     display_name: "MySQL 8.0.36"
   }
   
   

   REST v1beta4

   如需了解数据库的哪些次要版本可进行就地升级，请使用 Cloud SQL Admin API 的 instances.get 方法。

   在使用任何请求数据之前，请先进行以下替换：

   • INSTANCE_NAME：实例名称。

   HTTP 方法和网址：

   GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME

   如需发送您的请求，请展开以下选项之一：

   curl（Linux、macOS 或 Cloud Shell）

   注意：以下命令假定您已使用您的用户账号通过运行 gcloud init 或 gcloud auth login 登录 gcloud CLI，或者使用了 Cloud Shell，这会使您自动登录 gcloud CLI。您可以运行 gcloud auth list 来检查当前活跃的账号。

   执行以下命令：

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME"

   PowerShell (Windows)

   注意：以下命令假定您已使用您的用户账号通过运行 gcloud init 或 gcloud auth login 登录 gcloud CLI。您可以运行 gcloud auth list 来检查当前活跃的账号。

   执行以下命令：

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

   您应该收到类似以下内容的 JSON 响应：

   
   upgradableDatabaseVersions:
   
   {
     major_version: "MYSQL_8_0"
     name: "MYSQL_8_0_36"
     display_name: "MySQL 8.0.36"
   }
   
   

   如需查看 Cloud SQL 支持的数据库版本的完整列表，请参阅数据库版本和版本政策。

2. 在预演环境中对您的升级执行测试。

   1. 创建生产实例的克隆，用作预演实例。这将创建一个使用相同主要版本和次要版本的新数据库实例。

   2. 在预演实例上执行次要版本升级。

   3. 运行工作负载测试，以验证升级是否成功、应用是否按预期运行。在测试成功的情况下，继续升级您的读取副本实例。

3. 升级您的读取副本实例。

   1. 将数据库中的所有读取副本升级到目标次要版本。

   2. 验证您的应用是否按预期工作。

4. 备份您的主实例。

   请备份您的主实例，就像执行任何重大数据库更新时一样。

升级次要版本

您可以使用 gcloud 或 REST API 指定一个现有实例的次要版本。在不使用数据库的时候执行次要版本升级。如果您的实例需要重启，那么您的实例会出现一些停机时间。Cloud SQL 企业 Plus 版实例的停机时间几乎为零。如果安装的版本高于所请求的版本，则请求会被拒绝。

注意：升级数据库次要版本时，不允许进行并发更新，例如更新实例的磁盘大小或内存。

gcloud

使用带有 --database-version 标志的 gcloud sql instances patch 命令。

在运行命令之前替换以下变量：

• INSTANCE_NAME：实例的名称。
• DATABASE_VERSION：实例的数据库版本。如果您未指定此标志，则系统使用默认主要版本。

gcloud sql instances patch INSTANCE_NAME \
   --database-version=DATABASE_VERSION

REST v1

将 PATCH 请求与 instances:patch 方法和 databaseVersion 标志结合使用。

在使用任何请求数据之前，请先进行以下替换：

• PROJECT_ID：项目 ID
• INSTANCE_ID：实例 ID
• DATABASE_VERSION：要升级到的数据库版本。

HTTP 方法和网址：

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID

请求 JSON 正文：

{
  "databaseVersion": "DATABASE_VERSION"
}

如需发送您的请求，请展开以下选项之一：

curl（Linux、macOS 或 Cloud Shell）

注意：以下命令假定您已使用您的用户账号通过运行 gcloud init 或 gcloud auth login 登录 gcloud CLI，或者使用了 Cloud Shell，这会使您自动登录 gcloud CLI。您可以运行 gcloud auth list 来检查当前活跃的账号。

将请求正文保存在名为 request.json 的文件中，然后执行以下命令：

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID"

PowerShell (Windows)

注意：以下命令假定您已使用您的用户账号通过运行 gcloud init 或 gcloud auth login 登录 gcloud CLI。您可以运行 gcloud auth list 来检查当前活跃的账号。

将请求正文保存在名为 request.json 的文件中，然后执行以下命令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

您应该收到类似以下内容的 JSON 响应：

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "[e-mail]",
  "insertTime": "2022-07-17T20:23:15.540Z",
  "operationType": "UPDATE",
  "name": "fa3f7304-ccf6-4d2f-a6f5-24df00000032",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/fa3f7304-ccf6-4d2f-a6f5-24df00000032",
  "targetProject": "PROJECT_ID"
}

REST v1beta4

将 PATCH 请求与 instances:patch 方法和 databaseVersion 标志结合使用。

在使用任何请求数据之前，请先进行以下替换：

• PROJECT_ID：项目 ID
• INSTANCE_ID：实例 ID
• DATABASE_VERSION：要升级到的数据库版本。

HTTP 方法和网址：

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT-ID/instances/INSTANCE_ID

请求 JSON 正文：

{
  "databaseVersion": "DATABASE_VERSION"
}

如需发送您的请求，请展开以下选项之一：

curl（Linux、macOS 或 Cloud Shell）

注意：以下命令假定您已使用您的用户账号通过运行 gcloud init 或 gcloud auth login 登录 gcloud CLI，或者使用了 Cloud Shell，这会使您自动登录 gcloud CLI。您可以运行 gcloud auth list 来检查当前活跃的账号。

将请求正文保存在名为 request.json 的文件中，然后执行以下命令：

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT-ID/instances/INSTANCE_ID"

PowerShell (Windows)

注意：以下命令假定您已使用您的用户账号通过运行 gcloud init 或 gcloud auth login 登录 gcloud CLI。您可以运行 gcloud auth list 来检查当前活跃的账号。

将请求正文保存在名为 request.json 的文件中，然后执行以下命令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT-ID/instances/INSTANCE_ID" | Select-Object -Expand Content

您应该收到类似以下内容的 JSON 响应：

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "[e-mail]",
  "insertTime": "2022-07-17T20:23:15.540Z",
  "operationType": "UPDATE",
  "name": "fa3f7304-ccf6-4d2f-a6f5-24df00000032",
  "targetId": "INSTANCE-ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/fa3f7304-ccf6-4d2f-a6f5-24df00000032",
  "targetProject": "PROJECT_ID"
}

检查数据库次要安装版本

查看实例摘要信息时，数据库次要安装版本会显示在“配置”部分中。

回滚升级

如果您在测试升级时发现存在问题，则可能需要回滚数据库，以恢复运行先前次要版本的数据库实例。

如需恢复升级前的备份，请完成以下步骤：

1. 预配使用先前的次要版本的恢复数据库实例。
2. 将该恢复数据库实例上的设置配置为升级前状态。
3. 恢复您存储到恢复实例的升级前备份。

注意：在从备份恢复实例，以恢复到目标实例时，系统会将已安装的备份版本与目标数据库实例的安装版本进行比较。由于 MySQL 8.0 不允许降级，如果已安装的备份版本高于目标版本，恢复请求将被拒绝。

作为恢复备份的替代方案，您可以执行时间点恢复并创建新实例。