修改实例

MySQL   |  PostgreSQL   |  SQL Server

本页介绍如何修改现有 Cloud SQL 实例。

创建实例后，您可以在实例运行时对其进行修改以更改其设置。如需了解实例设置以及更改此类设置对实例的影响，请参阅实例设置。

注意：此过程会重启实例。 请参阅重启期间实例关停多久？

修改实例

大多数修改都只能应用于运行中的实例。

控制台

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

   转到“Cloud SQL 实例”

2. 如需打开实例的概览页面，请点击实例名称。
3. 点击修改。
4. 在自定义实例部分中，如果系统显示显示配置选项菜单，则点击该菜单。

5. 更新实例的所有可编辑设置。

   详细了解实例设置。

6. 点击保存。

gcloud

此命令会修改备份开始时间。

gcloud sql instances patch INSTANCE_NAME \
--backup-start-time 16:00

此命令允许其他 Google Cloud 服务（例如 BigQuery）访问 Cloud SQL 中的数据，并通过内部连接对此数据进行查询。

gcloud sql instances patch INSTANCE_NAME \
--enable-google-private-path

通过此命令，您可以更新 Cloud SQL 实例，使其可以与 Vertex AI 集成。通过使用此集成，您可以将托管在 Vertex AI 中的大语言模型 (LLM) 应用于 Cloud SQL for PostgreSQL 数据库。

gcloud sql instances patch INSTANCE_NAME \
--enable-google-ml-integration \
--database-flags cloudsql.enable_google_ml_integration=on

如果补丁修改的值需要重启实例，系统将提示您继续进行更改或取消操作。

如需详细了解实例配置标志，请参阅 gcloud sql instances patch。

REST v1

通过使用此命令，您可以完成以下操作：

• 修改实例，使其可以与 Vertex AI 集成。借助此集成，您可以将托管在 Vertex AI 中的大语言模型 (LLM) 应用于 Cloud SQL for PostgreSQL 数据库。
• 修改备份开始时间。
• 允许其他 Google Cloud 服务（例如 BigQuery）访问 Cloud SQL 中的数据，并通过内部连接对此数据进行查询。

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

• PROJECT_ID：项目 ID
• INSTANCE_ID：实例 ID
• PRIVATE_NETWORK：您要添加或选择以创建专用连接的网络

HTTP 方法和网址：

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

请求 JSON 正文：

{
  "settings": {
    "enableGoogleMlIntegration": true,
    "databaseFlags":
    [
      {
        "name": "cloudsql.enable_google_ml_integration",
        "value": "on"
      }
    ]
    "backupConfiguration": {
      "startTime": "16:00",
      "enabled": true,
      "binaryLogEnabled": true
    }
  }
    "ipConfiguration": {
      "privateNetwork": "PRIVATE_NETWORK",
      "authorizedNetworks": [],
      "ipv4Enabled": false,
      "enablePrivatePathForGoogleCloudServices": 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": "[e-mail]",
  "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 API 请求，请参阅 instances:patch 页面上的 API Explorer。

REST v1beta4

通过使用此命令，您可以完成以下操作：

• 修改实例，使其可以与 Vertex AI 集成。借助此集成，您可以将托管在 Vertex AI 中的大语言模型 (LLM) 应用于 Cloud SQL for PostgreSQL 数据库。
• 修改备份开始时间。
• 允许其他 Google Cloud 服务（例如 BigQuery）访问 Cloud SQL 中的数据，并通过内部连接对此数据进行查询。

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

• PROJECT_ID：项目 ID
• INSTANCE_ID：实例 ID
• PRIVATE_NETWORK：您要添加或选择以创建专用连接的网络

HTTP 方法和网址：

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

请求 JSON 正文：

{
  "settings": {
    "enableGoogleMlIntegration": true,
    "databaseFlags":
    [
      {
        "name": "cloudsql.enable_google_ml_integration",
        "value": "on"
      }
    ]
    "backupConfiguration": {
      "startTime": "16:00",
      "enabled": true,
      "binaryLogEnabled": true
    }
  }
    "ipConfiguration": {
      "privateNetwork": "PRIVATE_NETWORK",
      "authorizedNetworks": [],
      "ipv4Enabled": false,
      "enablePrivatePathForGoogleCloudServices": 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/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": "2020-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

如果补丁程序修改的值需要重启实例，系统将提示您继续进行更改或取消操作。

如需了解如何为此任务构建底层 REST API 请求，请参阅 instances:patch 页面上的 API Explorer。

编辑启用了 Private Service Connect 的实例

gcloud CLI 或 API 更新启用了 Private Service Connect 的实例。例如，您可以出于以下目的更新与实例关联的项目：

• 允许从 Private Service Connect 端点连接到 Cloud SQL 实例。
• 从允许的项目列表中移除项目。对于任何已移除的项目，与任何现有 Private Service Connect 端点的连接将继续有效，但不接受新端点。

注意：修改启用了 Private Service Connect 的实例存在一些限制。如需了解详情，请参阅限制。

gcloud

如需更新可以使用 Private Service Connect 的项目，请使用 gcloud sql instances patch 命令：

gcloud sql instances patch INSTANCE_NAME \
--project=PROJECT_ID \
--allowed-psc-projects=ALLOWED_PROJECTS

进行以下替换：

• INSTANCE_NAME：VPC 网络中的 Private Service Connect 端点可以连接到的 Cloud SQL 实例的名称。
• PROJECT_ID：Google Cloud 项目的 ID 或项目编号，该项目包含 VPC 网络中的 Private Service Connect 端点可以连接到的实例。
• ALLOWED_PROJECTS：允许的项目 ID 或编号列表（以英文逗号分隔）。这些项目会替换已配置为使用 Private Service Connect 的项目。如果某个项目未包含在此列表中，您无法使用它来创建实例并为其启用 Private Service Connect。

以下示例允许两个项目（98765 和 87654）从 Private Service Connect 端点连接到 12345 项目中包含的 myinstance Cloud SQL 实例：

gcloud sql instances patch myinstance \
--project=12345 \
--allowed-psc-projects='98765','87654'

如需移除所有允许的项目，请使用 gcloud sql instances patch 命令和
--clear-allowed-psc-projects 标志：

gcloud sql instances patch INSTANCE_NAME \
--project=PROJECT_ID \
--clear-allowed-psc-projects

此标志可确保没有项目被意外允许。

REST v1

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

• PROJECT_ID：Google Cloud 项目的 ID 或项目编号，该项目包含 VPC 网络中的 Private Service Connect 端点可以连接到的实例。
• INSTANCE_NAME：VPC 网络中的 Private Service Connect 端点可以连接到的 Cloud SQL 实例的名称。
• ALLOWED_PROJECTS：允许的项目 ID 或编号列表（以英文逗号分隔）。这些项目会替换已配置为使用 Private Service Connect 的项目。如果某个项目未包含在此列表中，您无法使用它来创建实例并为其启用 Private Service Connect。

HTTP 方法和网址：

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

请求 JSON 正文：

{
  "kind": "sql#instance",
  "name": "INSTANCE_NAME",
  "project": "PROJECT_ID",
  "settings": {
    "ipConfiguration": {
      "pscConfig": {
        "allowedConsumerProjects": [ALLOWED_PROJECTS]
      }
    },
    "kind": "sql#settings"
  }
}

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

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_NAME"

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_NAME" | Select-Object -Expand Content

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

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME",
  "status": "PENDING",
  "user": "[e-mail]",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

如需移除所有允许的项目，请使用 clear-allowed-psc-projects 标志。此标志可确保没有项目被意外允许。

如需了解如何为此任务构建底层 REST API 请求，请参阅 instances:patch 页面上的 API Explorer。

REST v1beta4

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

• PROJECT_ID：Google Cloud 项目的 ID 或项目编号，该项目包含 VPC 网络中的 Private Service Connect 端点可以连接到的实例。
• INSTANCE_NAME：VPC 网络中的 Private Service Connect 端点可以连接到的 Cloud SQL 实例的名称。
• ALLOWED_PROJECTS：允许的项目 ID 或编号列表（以英文逗号分隔）。这些项目会替换已配置为使用 Private Service Connect 的项目。如果某个项目未包含在此列表中，您无法使用它来创建实例并为其启用 Private Service Connect。

HTTP 方法和网址：

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

请求 JSON 正文：

{
  "kind": "sql#instance",
  "name": "INSTANCE_NAME",
  "project": "PROJECT_ID",
  "settings": {
    "ipConfiguration": {
      "pscConfig": {
        "allowedConsumerProjects": [ALLOWED_PROJECTS]
      }
    },
    "kind": "sql#settings"
  }
}

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

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_NAME"

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_NAME" | Select-Object -Expand Content

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

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

如需移除所有允许的项目，请使用 clear-allowed-psc-projects 标志。此标志可确保没有项目被意外允许。

如需了解如何为此任务构建底层 REST API 请求，请参阅 instances:patch 页面上的 API Explorer。