Google 会使用 AI 技术将内容翻译成您偏好的语言。AI 翻译可能包含错误。

就地升级

MySQL | PostgreSQL | SQL Server

本页面介绍了如何对 Cloud SQL 实例执行就地升级和降级。

对 Cloud SQL 实例进行就地更改

您可以使用就地更改来升级或降级 Cloud SQL 实例的版本、机器类型、存储类型或数据库版本。进行就地更改是重新配置实例的最简单且最不容易出错的方式。

准备工作

确保您的实例在 PostgreSQL 12 或更高版本上运行。

如果您的实例使用的是早期版本的 PostgreSQL，则必须升级到 PostgreSQL 12 或更高版本。如需了解详情，请参阅就地升级数据库主要版本。

注意与机器类型相关的潜在存储空间更改

不同版本支持使用不同存储选项的不同机器类型。高性能 C4 和 C4A 机器类型使用 Hyperdisk Balanced 存储空间，而不是旧机器类型使用的永久性磁盘选项之一。

当您更改所使用的版本或机器类型时，存储类型也可能会发生变化，这可能会导致一些停机时间和存储费用变化。迁移到 Google Cloud Hyperdisk Balanced 时，您可以指定其他配置选项。如需了解详情，请参阅存储空间更改。

注意 PITR 事务日志存储空间更改

如果您要升级的 Cloud SQL 企业版实例将用于 PITR 的预写式日志存储在磁盘上，请注意，升级到 Cloud SQL 企业 Plus 版的过程会将这些日志的存储位置从磁盘移到 Cloud Storage。如需确定实例的 PITR 预写式日志的当前位置，请参阅检查用于 PITR 的事务日志的存储位置。

如需全面了解就地升级如何影响预写式日志的位置，请参阅 PITR 的预写式日志的存储位置变化。

就地更改实例的版本

本部分介绍了如何将 Cloud SQL 实例的版本就地更改为 Cloud SQL 企业 Plus 版或从 Cloud SQL 企业 Plus 版更改为其他版本。Cloud SQL 企业 Plus 版提供了一些 Cloud SQL 企业版不具备的优势和性能增强功能。如需详细了解 Cloud SQL 版本，请参阅 Cloud SQL 版本概览。

升级到 Cloud SQL 企业 Plus 版需要几分钟才能完成，停机时间接近于零。切换回 Cloud SQL 企业版会导致停机时间更长。这两个过程都不需要更改应用所连接的端点。

按照本部分中的过程将 Cloud SQL 企业版实例升级到 Cloud SQL 企业 Plus 版，或将 Cloud SQL 企业 Plus 版实例降级到 Cloud SQL 企业版。

控制台

在 Google Cloud 控制台中，前往 Cloud SQL 实例页面。

转到“Cloud SQL 实例”
如需打开实例的概览页面，请点击实例名称。
点击修改。
在 选择 Cloud SQL 版本 部分中，如果您的实例使用的是 Cloud SQL 企业版，请点击升级；如果您的实例使用的是 Cloud SQL 企业 Plus 版，请点击 切换到企业版 。
使用打开的面板，指定使用新版本的实例的配置。请参阅 [进行就地更改时的选项](#change-options)。
输入您的实例 ID 以确认这些选择，然后点击 升级版本 或 切换版本 ，具体取决于您是升级还是降级。

如果您在实例的操作列中选择修改，也可以在实例页面中开始版本更改。

此外，如果您的实例使用的是 Cloud SQL 企业版，您还可以点击实例页面的配置部分中版本字段旁边的升级链接来开始升级。

gcloud

以下 [`gcloud sql instance patch`](/sdk/gcloud/reference/sql/instances/patch) 代码示例演示了如何将实例升级到 Cloud SQL 企业 Plus 版：

gcloud sql instances patch INSTANCE_ID \
  --edition=enterprise-plus \
  --tier=MACHINE_TYPE \
  --project=PROJECT_ID

可选：您还可以添加 --enable-data-cache 标志，为您的实例启用数据缓存。

替换以下内容：

PROJECT_ID：要升级的实例的项目 ID。
INSTANCE_ID：要升级的实例的名称。
MACHINE_TYPE：要升级到的实例机器类型。如需详细了解 Cloud SQL 企业 Plus 版的机器类型，请参阅 Cloud SQL 企业 Plus 版的实例的机器类型。

REST

以下命令会将您的实例升级到 Cloud SQL 企业 Plus 版并触发重启操作。

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

PROJECT_ID：要升级的实例的项目 ID。
INSTANCE_ID：要升级的实例的 ID。
MACHINE_TYPE：要升级到的实例机器类型。如需详细了解 Cloud SQL 企业 Plus 版的机器类型，请参阅 Cloud SQL 企业 Plus 版的实例的机器类型。

可选：您可以通过将 dataCacheEnabled 参数设置为 true 来启用数据缓存。

HTTP 方法和网址：

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

请求 JSON 正文：

{
  "settings": {
      "tier": "MACHINE_TYPE",
      "edition": "ENTERPRISE_PLUS",
      "dataCacheConfig": {
        "dataCacheEnabled": true
      },
  }
}

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

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": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta4

以下命令会将您的实例升级到 Cloud SQL 企业 Plus 版并触发重启操作。

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

PROJECT_ID：要升级的实例的项目 ID。
INSTANCE_ID：要升级的实例的 ID。
MACHINE_TYPE：要升级到的实例机器类型。如需详细了解 Cloud SQL 企业 Plus 版的机器类型，请参阅 Cloud SQL 企业 Plus 版的实例的机器类型。

可选：您可以通过将 dataCacheEnabled 参数设置为 true 来启用数据缓存。

HTTP 方法和网址：

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

请求 JSON 正文：

{
  "settings": {
      "tier": "MACHINE_TYPE",
      "edition": "ENTERPRISE_PLUS",
      "dataCacheConfig": {
        "dataCacheEnabled": true
      },
  }
}

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

curl（Linux、macOS 或 Cloud Shell）

将请求正文保存在名为 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/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/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

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

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

就地更改的选项

更改 Cloud SQL 实例的版本可能需要更改其机器系列，这反过来会影响其存储类型。

机器更改

更改版本时，您还必须更改机器类型。如需详细了解 Cloud SQL 支持的机器系列，请参阅选择机器系列。

从 Cloud SQL 企业版升级到 Cloud SQL 企业 Plus 版时，您可以在 N2、 C4A和 C4机器系列之间进行选择。

从 Cloud SQL 企业 Plus 版降级到 Cloud SQL 企业版时，您可以在通用型专用核心和 N4 机器系列之间进行选择。

您还可以在不更改版本的情况下更改机器类型。选择修改实例后，前往自定义实例 区域中的机器配置 的机器子部分。使用下拉菜单，您可以选择其他机器类型。您还可以选择其他数量的 vCPU，并根据需要启用或停用数据缓存。

如需了解更多一般信息，另请参阅 N2、 C4A、 C4和 N4机器系列的 Compute Engine 文档。

存储空间更改

如果您要从通用型或 N2 机器系列更改为 N4, C4A 或 C4 机器系列，您的存储空间将从固态硬盘 (SSD) 迁移到 Google Cloud Hyperdisk Balanced 存储空间。此升级通常需要极少的停机时间。

Google Cloud Hyperdisk Balanced 存储空间可以通过设置以下内容进行自定义，以满足您的使用场景：

存储空间容量
预配的 IOPS
预配的吞吐量

Google Cloud Hyperdisk Balanced 会根据您的实例配置（包括机器类型和存储空间容量）设置默认的 IOPS 和吞吐量值及限制。存储空间容量会限制默认值，而机器类型则设定了 IOPS 和吞吐量值的上限。如需了解详情，请参阅选择存储方案。

PITR 的预写式日志的位置变化

如果您的 Cloud SQL 企业版实例将 PITR 的事务日志存储在磁盘上，则开始升级到 Cloud SQL 企业 Plus 版的过程会将这些日志的存储位置切换为 Cloud Storage。

以下条件适用于位置更改：

该过程大约需要 transactionLogRetentionDays PITR 配置设置的时长，才能完成切换为 Cloud Storage。
在切换到 Cloud Storage 期间，我们建议您不要修改 transactionLogRetentionDays PITR 配置设置。即使您增加 transactionLogRetentionDays，预写式日志在磁盘上保留的时间也不会超过 Cloud SQL 企业版实例的 7 天默认值。

Cloud SQL 企业 Plus 版备份和日志存储默认设置

更改为 Cloud SQL 企业版并不会切换用于 PITR 的事务日志的存储位置。如果您的 Cloud SQL 企业 Plus 版实例将其 PITR 事务日志存储在 Cloud Storage 中，则日志会保留在 Cloud Storage 中。但是，用于 PITR 的事务日志默认保留时长已从 14 天更改为 7 天。备份配置不会更改。

就地升级 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

对 Cloud SQL 实例进行就地更改

准备工作

注意与机器类型相关的潜在存储空间更改

注意 PITR 事务日志存储空间更改

就地更改实例的版本

控制台

gcloud

REST

curl（Linux、macOS 或 Cloud Shell）

PowerShell (Windows)

REST v1beta4

curl（Linux、macOS 或 Cloud Shell）

PowerShell (Windows)

就地更改的选项

机器更改

存储空间更改

PITR 的预写式日志的位置变化

Cloud SQL 企业 Plus 版备份和日志存储默认设置

就地升级