使用就地升级将实例升级到 Cloud SQL 企业 Plus 版

MySQL | PostgreSQL | SQL Server

本页面介绍如何使用就地升级方法将 Cloud SQL 企业版实例升级到 Cloud SQL 企业 Plus 版。此外，还介绍了将 Cloud SQL 企业 Plus 版实例降级为 Cloud SQL 企业版的过程。

升级到 Cloud SQL 企业 Plus 版可为您带来多项优势和增强的性能。如需了解详情，请参阅 Cloud SQL for SQL Server 版本简介。

如需为现有 Cloud SQL 企业版实例启用这些增强功能，您必须将其升级到 Cloud SQL 企业 Plus 版。升级过程需要几分钟才能完成。此外，此过程不需要您的应用更改它们连接到的端点。

准备工作

确保您在 SQL Server Enterprise 2019 或 SQL Server Enterprise 2022 上运行 Cloud SQL Enterprise 版本实例。

注意：如果您设置了 max server memory (mb) 标志，我们建议您在将实例升级到 Cloud SQL 企业 Plus 版后移除该标志。这样，Cloud SQL 就可以自动管理该标志的值。但是，如果您希望设置该值，可以在升级实例后重新访问该标志值，并根据虚拟机的大小调整该值。

将实例升级到 Cloud SQL 企业 Plus 版

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

控制台

在 Google Cloud 控制台中，转到 Cloud SQL 实例页面。

转到“Cloud SQL 实例”
如需打开实例的概览页面，请点击实例名称。
点击修改。
在选择 Cloud SQL 版本部分中，点击升级。
在升级到企业 Plus 版面板中，输入您的实例 ID，然后点击升级版本。

或者，您也可以通过点击实例概览页面的配置部分中的升级来升级实例。

gcloud

以下代码示例演示了如何将实例升级到 Cloud SQL 企业 Plus 版：


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

替换以下内容：

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

REST

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

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

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

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 企业版并触发重启操作。

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

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

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 企业版

控制台

在 Google Cloud 控制台中，转到 Cloud SQL 实例页面。

转到“Cloud SQL 实例”
如需打开实例的概览页面，请点击实例名称。
点击修改。
在选择 Cloud SQL 版本部分中，点击切换到企业版。
在切换到企业版面板中，输入您的实例 ID，然后点击切换版本。

或者，您也可以通过点击实例概览页面的配置部分中的更改为企业版来切换到 Cloud SQL 企业版。

gcloud

以下代码示例显示如何将实例更改为 Cloud SQL 企业版：

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

请替换以下内容：

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

REST

以下命令会将您的实例更改为 Cloud SQL 企业版并触发重启操作。

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

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

HTTP 方法和网址：

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

请求 JSON 正文：

{
  "settings": {
      "tier": "MACHINE_TYPE",
      "edition": "ENTERPRISE"
  }
}

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

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/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 企业版并触发重启操作。

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

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

HTTP 方法和网址：

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

请求 JSON 正文：

{
  "settings": {
      "tier": "MACHINE_TYPE",
      "edition": "ENTERPRISE"
  }
}

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

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 企业 Plus 版。