此页面由 Cloud Translation API 翻译。

创建读取副本

MySQL | PostgreSQL | SQL Server

本页介绍如何创建 Cloud SQL 实例的只读副本。

只读副本是主实例的副本，可几乎实时地反映主实例的更改。您可以使用只读副本从主实例中分流读取请求或分析流量。

此外，对于灾难恢复，您可以执行区域迁移。如果副本是跨区域副本，您可以执行故障切换到另一个区域；具体而言，您可以将副本提升为独立实例（在这种情况下，现有副本不会将该实例视为主实例）。

如需详细了解复制的工作原理，请参阅 Cloud SQL 中的复制。

准备工作

如果要为此实例创建第一个副本，请确保该实例满足主实例的要求。了解详情。

创建读取副本

以下是创建只读副本的步骤。

控制台

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

转到“Cloud SQL 实例”
找到您要为其创建副本的实例，然后打开列表旁边的 more actions 菜单。
选择创建只读副本。
如果您没有看到该选项，则表示此实例是副本；您无法创建副本的副本。
如果实例已启用备份和二进制日志记录功能，请继续执行下一步。否则，请选择自动备份和启用二进制日志记录功能，点击继续，然后点击保存并重启以重启实例。
启用二进制日志记录功能会导致实例重启。
在该页面的自定义实例部分中，更新副本的设置。首先点击显示配置选项以显示设置组。然后，展开所需设置组以查看和自定义设置。所有选定选项的摘要会显示在右侧。自定义这些设置是可选操作。系统会为没有进行自定义的所有设置分配默认值。

如需详细了解各项设置，请参阅实例设置简介页面。

例如，如需允许其他 Google Cloud 服务（例如 BigQuery）访问 Cloud SQL 中的数据，并通过内部连接对此数据进行查询，请展开连接组，然后取消选中公共 IP 复选框。
点击创建副本。
Cloud SQL 会根据需要创建备份，并创建副本。随后，您将返回到主实例的实例页面。

gcloud

检查主实例的状态：
```
gcloud sql instances describe PRIMARY_INSTANCE_NAME
      
```
如果 databaseReplicationEnabled 属性为 true，则表示此实例是副本；您无法为副本创建副本。
如果 backupConfiguration 下的 enabled 属性为 false，请立即为主实例启用备份：
```
gcloud sql instances patch PRIMARY_INSTANCE_NAME \
--backup-start-time=>HH:MM
      
```
backup-start-time 参数采用 UTC±00 时区的 24 小时制，用于指定一个 4 小时备份时段的开始时间。备份可在该时段内随时启动。
如果 binaryLogEnabled 属性为 false，请对主实例启用二进制日志：
```
gcloud sql instances patch PRIMARY_INSTANCE_NAME \
--enable-bin-log
```
启用二进制日志会导致实例重启。
创建副本：
```
gcloud sql instances create REPLICA_NAME \
--master-instance-name=PRIMARY_INSTANCE_NAME
```
如果需要，您可以使用 --tier 参数指定不同的层级大小。如果您要基于 MySQL 8.4 及更高版本的主实例创建副本，并且该实例的 Cloud SQL 版本为企业版或企业 Plus 版，则无需为此参数指定值。副本会继承主实例的机器类型。

您可以使用 --region 参数指定不同区域。

您可以为其他实例设置添加更多参数。如需了解详情，请参阅 gcloud sql instances create。

如果主实例只有内部 IP 地址，并且您想要允许其他 Google Cloud 服务（例如 BigQuery）访问 Cloud SQL 中的数据，并通过内部连接对此数据进行查询，请在该命令中添加 --enable-google-private-path 参数。

您必须在与主实例相同的 VPC 网络中创建副本。您还可以在该 VPC 网络中指定 allocated-ip-range-name。如果未指定范围，则副本将在随机范围内创建。

只读副本实例支持二进制日志记录功能（仅限 MySQL 5.7 及更高版本）。在旧版高可用性故障切换副本上不受支持）。使用相同的 gcloud CLI 命令对副本实例启用二进制日志记录功能，并使用副本实例名称而非主实例名称。
```
gcloud sql instances patch REPLICA_INSTANCE_NAME \
--enable-bin-log
    
```
您可以使用 sync_binlog 标志对副本实例（而非主实例）设置二进制日志记录持久性，该标志可控制 MySQL 服务器将二进制日志同步到磁盘的频率。
无法对副本实例启用备份，但与主实例不同，即使备份被停用，仍可以对副本实例启用二进制日志记录功能。

副本实例的 binlog 保留期限会自动设置为一天，与主实例的七天不同。

Terraform

如需创建读取副本，请使用 Terraform 资源。

resource "google_sql_database_instance" "read_replica" {
  name                 = "mysql-replica-instance-name"
  master_instance_name = google_sql_database_instance.primary.name
  region               = "europe-west4"
  database_version     = "MYSQL_8_0"

  replica_configuration {
    failover_target = false
  }

  settings {
    tier              = "db-n1-standard-2"
    availability_type = "ZONAL"
    disk_size         = "100"
  }
  # set `deletion_protection` to true, will ensure that one cannot accidentally delete this instance by
  # use of Terraform whereas `deletion_protection_enabled` flag protects this instance at the GCP level.
  deletion_protection = false
}

应用更改

如需在 Google Cloud 项目中应用 Terraform 配置，请完成以下部分中的步骤。

准备 Cloud Shell

启动 Cloud Shell。
设置要在其中应用 Terraform 配置的默认 Google Cloud 项目。

您只需为每个项目运行一次以下命令，即可在任何目录中运行它。
```
export GOOGLE_CLOUD_PROJECT=PROJECT_ID
```
如果您在 Terraform 配置文件中设置显式值，则环境变量会被替换。

准备目录

每个 Terraform 配置文件都必须有自己的目录（也称为“根模块”）。

在 Cloud Shell 中，创建一个目录，并在该目录中创建一个新文件。文件名必须具有 .tf 扩展名，例如 main.tf。在本教程中，该文件称为 main.tf。
```
mkdir DIRECTORY && cd DIRECTORY && touch main.tf
```
如果您按照教程进行操作，可以在每个部分或步骤中复制示例代码。

将示例代码复制到新创建的 main.tf 中。

（可选）从 GitHub 中复制代码。如果端到端解决方案包含 Terraform 代码段，则建议这样做。
查看和修改要应用到您的环境的示例参数。
保存更改。
初始化 Terraform。您只需为每个目录执行一次此操作。
```
terraform init
```
（可选）如需使用最新的 Google 提供程序版本，请添加 -upgrade 选项：
```
terraform init -upgrade
```

应用更改

查看配置并验证 Terraform 将创建或更新的资源是否符合您的预期：
```
terraform plan
```
根据需要更正配置。
通过运行以下命令并在提示符处输入 yes 来应用 Terraform 配置：
```
terraform apply
```
等待 Terraform 显示“应用完成！”消息。
打开您的 Google Cloud 项目以查看结果。在 Google Cloud 控制台的界面中找到资源，以确保 Terraform 已创建或更新它们。

删除更改

如需删除更改，请执行以下操作：

如需停用删除防护，请在 Terraform 配置文件中将 deletion_protection 参数设置为 false。
```
deletion_protection =  "false"
```
运行以下命令并在提示符处输入 yes，以应用更新后的 Terraform 配置：
```
terraform apply
```

运行以下命令并在提示符处输入 yes，以移除之前使用 Terraform 配置应用的资源：
```
terraform destroy
```

REST v1

获取当前备份配置
使用实例资源的 get 方法返回主实例的数据库版本和当前备份配置。

在使用任何请求数据之前，请先进行以下替换：
- project-id：项目 ID
- primary-instance-name：主实例的名称
HTTP 方法和网址：
```
GET https://sqladmin.googleapis.com/v1/projects/project-id/instances/primary-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/primary-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/primary-instance-name" | Select-Object -Expand Content
```
您应该收到类似以下内容的 JSON 响应：
响应
```
"backupConfiguration": {
    "kind": "sql#backupConfiguration",
    "startTime": "12:00",
    "enabled": false,
    "binaryLogEnabled": false
}
```
验证是否已设置复制字段
如果 enabled 或 pointInTimeEnabled 为 false，请使用实例资源的 patch 方法同时启用这两项。在请求中，指定您想要更改的备份配置的所有属性。

如需启用备份，请将 enabled 设置为 true，并将 startTime 设置为 HH:MM 格式的时间。startTime 参数采用 UTC±00 时区的 24 小时制，用于指定一个 4 小时备份时段的开始时间。备份可在该时段内随时启动。

如需启用时间点恢复，请将 pointInTimeEnabled 设置为 true。

在使用任何请求数据之前，请先进行以下替换：
- PROJECT_ID：包含实例的 Google Cloud 项目的 ID 或项目编号
- INSTANCE_NAME：您为实现高可用性而配置的主实例或读取副本实例的名称
- START_TIME：时间（以小时和分钟为单位）
HTTP 方法和网址：
```
PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME
```
请求 JSON 正文：
```
{
  "settings":
  {
    "backupConfiguration":
    {
      "startTime": "START_TIME",
      "enabled": true,
      "binaryLogEnabled": 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_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": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}
```
创建只读副本
使用实例资源的 insert 方法创建只读副本。databaseVersion 属性必须与主实例相同。如果主实例使用内部 IP 地址，您可以使用与创建主实例相同的方式指定 allocatedIpRange。如果未指定范围，则副本将在随机范围内创建。对于跨区域只读副本，请指定主实例所在区域以外的一个区域。

在使用任何请求数据之前，请先进行以下替换：
- project-id：项目 ID
- database-version：Enum 版本字符串（例如 MYSQL_8_0）
- primary-instance-name：主实例的名称
- primary-instance-region：主实例的区域
- replica-region：副本实例的区域
- replica-name：副本实例的名称
- machine-type：机器类型的枚举字符串。例如：“db-custom-1-3840”
- private-network：您要添加或选择以创建专用连接的已获授权的网络。
将 ipv4Enabled 参数的值设置为 false，因为您希望 Cloud SQL 实例与专用 IP 地址（而不是与公共 IP 地址）相关联。

HTTP 方法和网址：
```
POST https://sqladmin.googleapis.com/v1/projects/project-id/instances
```
请求 JSON 正文：
```
{
  "masterInstanceName": "primary-instance-name",
  "project": "project-id",
  "databaseVersion": "database-version",
  "name": "replica-name",
  "region": "replica-region",
  "settings":
  {
    "tier": "machine-type",
    "settingsVersion": 0,
    "ipConfiguration": {
    object (IpConfiguration)
  },
  {
  "ipv4Enabled": false,
  "privateNetwork": private-network,
  "requireSsl": boolean,
  "authorizedNetworks": [
    {
      object (AclEntry)
    }
  ],
  "allocatedIpRange": string
    }
  }
}
```
如需发送您的请求，请展开以下选项之一：
curl（Linux、macOS 或 Cloud Shell）

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

将请求正文保存在名为 request.json 的文件中，然后执行以下命令：
```
curl -X POST \
     -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"
```
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 POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/project-id/instances" | 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-21T22:43:37.981Z",
  "operationType": "CREATE_REPLICA",
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}
```

REST v1beta4

获取当前备份配置
使用实例资源的 get 方法返回主实例的数据库版本和当前备份配置。

在使用任何请求数据之前，请先进行以下替换：
- project-id：项目 ID
- primary-instance-name：主实例的名称
HTTP 方法和网址：
```
GET https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/primary-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/primary-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/primary-instance-name" | Select-Object -Expand Content
```
您应该收到类似以下内容的 JSON 响应：
响应
```
"backupConfiguration": {
    "kind": "sql#backupConfiguration",
    "startTime": "12:00",
    "enabled": false,
    "binaryLogEnabled": false
}
```
验证是否已设置复制字段
如果在主实例上 enabled 或 binaryLogEnabled 为 false，请使用实例资源的 patch 方法同时启用这两项。在请求中，指定您想要更改的备份配置的所有属性。

如需启用备份，请将 enabled 设置为 true，并将 startTime 设置为 HH:MM 格式的时间。startTime 参数采用 UTC±00 时区的 24 小时制，用于指定一个 4 小时备份时段的开始时间。备份可在该时段内随时启动。

如需启用时间点恢复，请在主实例上将 binaryLogEnabled 设置为 true。

只读副本实例支持二进制日志记录功能（仅限 MySQL 5.7 及更高版本）。使用相同的 API 对副本实例启用二进制日志记录功能，并使用副本实例 ID 而非主实例 ID。
您可以使用 sync_binlog 标志对副本实例（而非主实例）设置二进制日志记录持久性，该标志可控制 MySQL 服务器将二进制日志同步到磁盘的频率。
无法对副本实例启用备份，但与主实例不同，即使备份被停用，仍可以对副本实例启用二进制日志记录功能。
在使用任何请求数据之前，请先进行以下替换：
- PROJECT_ID：包含实例的 Google Cloud 项目的 ID 或项目编号
- INSTANCE_NAME：您为实现高可用性而配置的主实例或读取副本实例的名称
- START_TIME：时间（以小时和分钟为单位）
HTTP 方法和网址：
```
PATCH https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME
```
请求 JSON 正文：
```
{
  "settings":
  {
    "backupConfiguration":
    {
      "startTime": "START_TIME",
      "enabled": true,
      "binaryLogEnabled": 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/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/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content
```
您应该收到类似以下内容的 JSON 响应：
响应
```
{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}
```
创建只读副本
使用实例资源的 insert 方法创建只读副本。databaseVersion 属性必须与主实例相同。如果主实例使用内部 IP 地址，您可以使用与创建主实例相同的方式指定 allocatedIpRange。对于跨区域只读副本，请指定主实例所在区域以外的一个区域。

在使用任何请求数据之前，请先进行以下替换：
- project-id：项目 ID
- database-version：Enum 版本字符串（例如 MYSQL_8_0）
- primary-instance-name：主实例的名称
- primary-instance-region：主实例的区域
- replica-region：副本实例的区域
- replica-name：副本实例的名称
- machine-type：机器类型的枚举字符串。例如：“db-custom-1-3840”
- private-network：您要添加或选择以创建专用连接的已获授权的网络。
将 ipv4Enabled 参数的值设置为 false，因为您希望 Cloud SQL 实例与专用 IP 地址（而不是与公共 IP 地址）相关联。

HTTP 方法和网址：
```
POST https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances
```
请求 JSON 正文：
```
{
  "masterInstanceName": "primary-instance-name",
  "project": "project-id",
  "databaseVersion": "database-version",
  "name": "replica-name",
  "region": "replica-region",
  "settings":
  {
    "tier": "machine-type",
    "settingsVersion": 0,
    
    "ipConfiguration": {
    object (IpConfiguration)
  },
  {
  "ipv4Enabled": false,
  "privateNetwork": private-network,
  "requireSsl": boolean,
  "authorizedNetworks": [
    {
      object (AclEntry)
    }
  ],
  "allocatedIpRange": string
    }
    
  }
}
```
如需发送您的请求，请展开以下选项之一：
curl（Linux、macOS 或 Cloud Shell）

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

将请求正文保存在名为 request.json 的文件中，然后执行以下命令：
```
curl -X POST \
     -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"
```
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 POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances" | Select-Object -Expand Content
```
您应该收到类似以下内容的 JSON 响应：
响应
```
{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "CREATE_REPLICA",
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}
```

创建启用了 Private Service Connect 的实例的读取副本

如需创建启用了 Private Service Connect 的实例的读取副本，请使用 gcloud CLI 或 API。您可以在与主实例相同的区域中创建此副本，也可以在与主实例不同的区域中创建此副本（跨区域读取副本）。

读取副本无法从使用其他连接类型的实例进行复制。例如，启用了 Private Service Connect 的实例只能从另一个 Private Service Connect 实例复制。它也无法从支持外部 IP 连接的实例或配置了专用服务访问通道的实例进行复制。

gcloud

如需创建实例的读取副本，请使用 gcloud sql instances create 命令：

gcloud sql instances create REPLICA_INSTANCE_NAME \
--master-instance-name=PRIMARY_INSTANCE_NAME \
--project=PROJECT_ID \
--region=REGION_NAME \
--enable-private-service-connect \
--allowed-psc-projects=ALLOWED_PROJECTS \
--availability-type=AVAILABILITY_TYPE \
--no-assign-ip

进行以下替换：

REPLICA_INSTANCE_NAME：副本实例的名称。
PRIMARY_INSTANCE_NAME：主实例的名称。
PROJECT_ID：包含实例的 Google Cloud 项目的 ID 或项目编号。
REGION_NAME：副本实例的区域名称。
ALLOWED_PROJECTS：允许的项目 ID 或编号列表（以英文逗号分隔）。如果某个项目未包含在此列表中，您无法使用它来创建实例并为其启用 Private Service Connect。

Cloud SQL 不会将主实例允许的项目复制到副本。您必须为每个副本创建一个 Private Service Connect 端点。如果您使用的是 Cloud SQL Auth 代理或 Cloud SQL 语言连接器，请为副本创建 DNS 区域和 DNS 记录。
AVAILABILITY_TYPE：为实例启用高可用性。对于此参数，请指定以下值之一：
- REGIONAL：启用高可用性，建议用于生产实例。实例会故障切换到所选区域内的另一个可用区。
- ZONAL：不提供故障切换功能。此设置为默认值。
如需详细了解如何为实例设置和移除高可用性，请参阅配置现有实例以实现高可用性和为实例停用高可用性。

REST v1

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

PRIMARY_INSTANCE_NAME：主实例的名称。
PROJECT_ID：包含实例的 Google Cloud 项目的 ID 或项目编号。
REPLICA_INSTANCE_NAME：副本实例的名称。
REGION_NAME：副本实例的区域名称。
MACHINE_TYPE：实例的机器类型。
AVAILABILITY_TYPE：为实例启用高可用性。对于此参数，请指定以下值之一：
- REGIONAL：启用高可用性，建议用于生产实例。实例会故障切换到所选区域内的另一个可用区。
- ZONAL：不提供故障切换功能。此设置为默认值。
如需详细了解如何为实例设置和移除高可用性，请参阅配置现有实例以实现高可用性和为实例停用高可用性。
ALLOWED_PROJECTS：允许的项目 ID 或编号列表（以英文逗号分隔）。如果某个项目未包含在此列表中，您无法使用它来创建实例并为其启用 Private Service Connect。

Cloud SQL 不会将主实例允许的项目复制到副本。您必须为每个副本创建一个 Private Service Connect 端点。如果您使用的是 Cloud SQL Auth 代理或 Cloud SQL 语言连接器，则必须为副本创建 DNS 区域和 DNS 记录。

HTTP 方法和网址：

POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances

请求 JSON 正文：

{
  "masterInstanceName": "PRIMARY_INSTANCE_NAME",
  "project": "PROJECT_ID",
  "databaseVersion": "MYSQL_8_0",
  "name": "REPLICA_INSTANCE_NAME",
  "region": "REGION_NAME",
  "kind": "sql#instance",
  "settings":
  {
    "tier": "MACHINE_TYPE",
    "availabilityType": "AVAILABILITY_TYPE",
    "settingsVersion": 0,
    "ipConfiguration": {
      "ipv4Enabled": false,
      "pscConfig": {
        "allowedConsumerProjects": [ALLOWED_PROJECTS],
        "pscEnabled": true
      }
    },
    "kind": "sql#settings",
    "pricingPlan": "PER_USE",
    "replicationType": "ASYNCHRONOUS",
    "tier": "MACHINE_TYPE"
  }
}

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

curl（Linux、macOS 或 Cloud Shell）

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

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

curl -X POST \
     -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"

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 POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances" | Select-Object -Expand Content

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

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

REST v1beta4

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

PRIMARY_INSTANCE_NAME：主实例的名称。
PROJECT_ID：包含实例的 Google Cloud 项目的 ID 或项目编号。
REPLICA_INSTANCE_NAME：副本实例的名称。
REGION_NAME：副本实例的区域名称。
MACHINE_TYPE：实例的机器类型。
AVAILABILITY_TYPE：为实例启用高可用性。对于此参数，请指定以下值之一：
- REGIONAL：启用高可用性，建议用于生产实例。实例会故障切换到所选区域内的另一个可用区。
- ZONAL：不提供故障切换功能。此设置为默认值。
如需详细了解如何为实例设置和移除高可用性，请参阅配置现有实例以实现高可用性和为实例停用高可用性。
ALLOWED_PROJECTS：允许的项目 ID 或编号列表（以英文逗号分隔）。如果某个项目未包含在此列表中，您无法使用它来创建实例并为其启用 Private Service Connect。

Cloud SQL 不会将主实例允许的项目复制到副本。您必须为每个副本创建一个 Private Service Connect 端点。如果您使用的是 Cloud SQL Auth 代理或 Cloud SQL 语言连接器，则必须为副本创建 DNS 区域和 DNS 记录。

HTTP 方法和网址：

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

请求 JSON 正文：

{
  "masterInstanceName": "PRIMARY_INSTANCE_NAME",
  "project": "PROJECT_ID",
  "databaseVersion": "MYSQL_8_0",
  "name": "REPLICA_INSTANCE_NAME",
  "region": "REGION_NAME",
  "kind": "sql#instance",
  "settings":
  {
    "tier": "MACHINE_TYPE",
    "availabilityType": "AVAILABILITY_TYPE",
    "settingsVersion": 0,
    "ipConfiguration": {
      "ipv4Enabled": false,
      "pscConfig": {
        "allowedConsumerProjects": [ALLOWED_PROJECTS],  
        "pscEnabled": true
      }
    },
    "kind": "sql#settings",
    "pricingPlan": "PER_USE",
    "replicationType": "ASYNCHRONOUS",
    "tier": "MACHINE_TYPE"
  }
}

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

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/sql/v1beta4/projects/PROJECT_ID/instances"

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

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

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

为 IAM 数据库身份验证配置只读副本

只读副本在主实例上启用时不会自动启用 cloudsql_iam_authentication 标志。

如需为 IAM 数据库身份验证配置只读副本，请执行以下操作：

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

转到“Cloud SQL 实例”
如需打开实例的概览页面，请点击实例名称。
在“配置”图块中，查找 cloudsql_iam_authentication 标志。如果列表中没有该标志，则无需在只读副本中启用该标志。如果列表包含该标志，则必须在读取副本中启用该标志。如果您需要在只读副本中启用该标志，请继续执行下一步。
从 SQL 导航菜单中选择副本。
点击要修改的副本的名称。
点击修改。
在配置选项部分，展开标志。
选择 + 添加项。
输入 cloudsql_iam_authentication 作为标志名称。确保为此标志选择开启。
点击保存。

创建级联副本

本部分介绍了如何创建和管理级联副本。

如需了解级联副本的工作原理，请参阅级联副本。

创建级联副本的步骤

控制台

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

转到“Cloud SQL 实例”
对于 MySQL 5.7 或更高版本，启用复制功能。
点击将充当您要创建的副本的父级副本相应的副本标签页。
点击创建副本。
在创建读取副本页面上，更新实例 ID 和任何其他配置选项，包括名称、区域和可用区。
点击创建。
Cloud SQL 会创建一个副本。随后，您将返回到父级副本的实例页面。
对于要创建的每个新级联副本，请按照步骤 4-6 执行操作。

gcloud

如果您使用的是 MySQL 5.7 版或更高版本，请为新副本的主实例启用 binlog：
```
gcloud sql instances patch --enable-bin-log PARENT_REPLICA_NAME
```
将 PARENT_REPLICA_NAME 替换为父级副本的名称。
使用 --master-instance-name 标志将主副本指定为主实例来创建新副本：

gcloud sql instances create REPLICA_NAME \
      --master-instance-name=PARENT_REPLICA_NAME \

REPLICA_NAME：您要创建的副本的唯一 ID
PARENT_REPLICA_NAME：父级副本的名称

创建级联副本后，您可以看到对主实例所做的更改已通过级联副本链中的所有副本进行复制。

curl

如果您使用的是 MySQL 5.7 版或更高版本，请启用二进制日志记录功能：

如需启用二进制日志记录功能，请将以下 JSON 保存在名为 request.JSON 的文件中，然后调用 curl 命令来启用二进制日志记录功能。
```
{
  "settings":
  {
    "backupConfiguration":
    {
      "enabled": false,
      "binaryLogEnabled": true
    }
  }
}
```

如需在父级副本下创建副本，请修改以下 JSON 代码示例并将其保存到名为 request.json 的文件中：

{
  "masterInstanceName": "PARENT_REPLICA_NAME",
  "project": "PROJECT_ID",
  "name": "REPLICA_NAME",
  "region": "REPLICA_REGION",
  "settings":
    {
      "tier": "MACHINE_TYPE",
    }
}

运行以下命令：

curl -X POST
-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"

问题排查

问题	问题排查
创建时读取副本未开始复制。	日志文件中可能有更具体的错误信息。在 Cloud Logging 中查看日志以找到实际错误。
无法创建只读副本 - invalidFlagValue 错误	请求中的某个标志无效。它可能是您明确提供的标志，也可能是设置为默认值的标志。首先，检查 `max_connections` 标志的值是否大于或等于主实例上的值。如果 `max_connections` 标志设置正确，请在 Cloud Logging 中检查日志以找出实际错误。
无法创建只读副本 - 未知错误。	日志文件中可能有更具体的错误信息。在 Cloud Logging 中查看日志以找到实际错误。如果错误为 `set Service Networking service account as servicenetworking.serviceAgent role on consumer project`，则停用 `Service Networking API`，然后重新启用。此操作会创建继续执行该过程所需的服务账号。
磁盘已满。	主实例磁盘大小可能在副本创建期间变满。修改主实例以将其升级为更大的磁盘。
副本实例占用的内存过多。	副本使用临时内存来缓存经常请求的读取操作，这可能会导致其占用的内存多于主实例。重启副本实例以收回临时内存空间。
已停止复制。	已达到存储空间上限，且未启用存储空间自动扩容功能。修改实例以启用 `automatic storage increase`。
复制延迟一直很高。	写入负载过高，副本无法处理。当副本上的 SQL 线程无法与 IO 线程保持同步时，会发生复制延迟。某些类型的查询和工作负载会导致指定架构出现暂时性或永久性的高复制延迟。下面列出了复制延迟的部分常见原因：对副本的查询速度较慢。找到这些查询并进行修复。所有表都必须具有唯一键/主键。每次更新此类没有唯一键/主键的表都会导致对副本进行全表扫描。由于大量更新堆积在副本上，因此 `DELETE ... WHERE field < 50000000` 等查询会导致基于行的复制出现复制延迟。以下是一些可行的解决方案：配置并行复制。将只读副本上的 innodb_flush_log_at_trx_commit 标志设置为 2。如需详细了解此标志，请参阅关于使用标志的提示。修改实例以增加副本的大小。减少数据库的负载。将读取流量发送到读取副本。将表编入索引。识别并修复速度缓慢的写入查询。重新创建副本。
复制延迟时间突然激增。	这是因为长时间运行的事务导致。当事务（单语句或多语句）在源实例上提交时，事务的开始时间记录在二进制日志中。当副本收到此 binlog 事件时，会将该时间戳与当前时间戳进行比较，以计算复制延迟时间。因此，来源上的长时间运行的事务将导致副本的复制延迟时间大幅度增加。如果事务中的行更改量很大，则副本还会花费很长时间来执行它。在此期间，复制延迟时间不断增加。一旦副本完成此事务，同步周期将取决于来源上的写入工作负载以及副本的处理速度。为了避免长时间运行的事务，可以考虑一些可能的解决方案，包括：将事务拆分为多个小事务将单个大型写入查询分成较小的批次尝试将长时间运行的 SELECT 查询与混合 DML 的事务分开
更改并行复制标志会导致错误。	一个或多个这些标志的值设置错误。在显示错误消息的主实例上，设置并行复制标志：修改 `binlog_transaction_dependency_tracking` 和 `transaction_write_set_extraction` 标志： `binlog_transaction_dependency_tracking=COMMIT_ORDER` `transaction_write_set_extraction=OFF` 添加 `slave_pending_jobs_size_max` 标志： `slave_pending_jobs_size_max=33554432` 修改 `transaction_write_set_extraction` 标志： `transaction_write_set_extraction=XXHASH64` 修改 `binlog_transaction_dependency_tracking` 标志： `binlog_transaction_dependency_tracking=WRITESET`
副本创建失败并超时。	主实例上长时间运行的未提交事务可能会导致只读副本创建失败。停止所有正在运行的查询后重新创建副本。

后续步骤

了解如何管理副本。
了解跨区域副本。