快速入门指南:全球集群 - Amazon DocumentDB
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

快速入门指南:全球集群

配置

Amazon DocumentDB 全局集群跨越至少两个Amazon Web Services 区域. 主区域支持具有一个主(写入)实例和最多十五个副本实例的集群,而辅助区域运行的只读集群最多由十六个副本实例组成。每个全局集群最多可以有五个辅助区域。该表列出了全局集群中允许的集群、实例和副本的最大数量。

描述 主 Amazon Web Services 区域 辅助 Amazon Web Services 区域
集群 1 5(最大值)
写入器实例 1 0
每个集群的只读实例(Amazon DocumentDB 副本) 15(最大值) 16(合计)
只读实例(允许的最大值,辅助区域的指定实际数量) 15 - s s = 辅助 Amazon Web Services 区域 的总数

集群有以下特定要求:

  • 数据库实例类要求— 您只能使用db.r5db.r6实例类。

  • Amazon Web Services 区域要求— 主集群必须位于一个区域,并且至少有一个辅助集群必须位于同一账户的不同区域。您最多可以创建五个辅助(只读)集群,它们必须各在不同的区域中。换句话说,没有两个集群可位于同一个区域中。

  • 命名要求— 为每个集群选择的名称在所有区域中必须唯一。即使不同的集群位于不同的区域中,也不能对它们使用相同的名称。

创建Amazon DocumentDB 全局集群

你准备好建立你的第一个全球集群了吗? 在本节中,我们将说明如何使用新的数据库集群和实例创建一个全新的全局集群,使用以下任一方法Amazon Web Services Management Console要么Amazon CLI按照以下说明进行操作。

  1. 在里面Amazon Web Services Management Console,导航到Amazon DocumentDB.

  2. 当您进入Amazon DocumentDB B 控制台时,选择集群.

  3. 选择Create(创建)。

  4. 填写配置该部分的创建Amazon DocumentDB相应地形成:

    • 集群标识符:您可以输入此实例的唯一标识符,也可以允许 Amazon DocumentDB 根据集群标识符提供实例标识符。

    • 引擎版本:选择4.0.0

    • 实例类:选择db.r5.large

    • 实例数:选择3.

  5. 在里面身份验证部分,填写主用户名和主密码。

  6. 选择显示高级设置.

  7. 在里面网络设置“”

    • 保留默认选项虚拟私有云子网组.

    • 对于VPC 安全组,默认 VPC应该已经添加了。

    • 类型DocDB进入VPC 安全组字段并选择入站 DOCDB (VPC).

  8. 对于集群选项南美洲ncryption-at-rest,保留默认选项。

  9. 对于备份日志导出,保留默认选项。

  10. 对于维护,标签删除保护,保留默认选择。

  11. 现在点击上面写着的按钮Create.

要创建 Amazon DocumentDB 区域集群,请调用create-db-cluster Amazon CLI. 以下Amazon CLI命令创建一个名为 Amazon DocumentDB 集群global-cluster-id. 有关删除保护的更多信息,请参见删除 Amazon DocumentDB 集群.

以及--engine-version是一个可选参数,默认为最新的主引擎版本。当前的主要引擎版本是4.0.0. 发布新的主要引擎版本时,的默认引擎版本--engine-version将进行更新以反映最新的主要引擎版本。因此,对于生产工作负载,尤其是那些依赖脚本编写、自动化或Amazon CloudFormation模板,我们建议您明确指定--engine-version到预期的主版本。

如果 adb-subnet-group-name要么vpc-security-group-id未指定,Amazon DocumentDB 将使用给定区域的默认子网组和 Amazon VPC 安全组。

在以下示例中,将每个用户输入占位符替换为您自己的信息。

对于 Linux、macOS 或 Unix:

aws docdb create-db-cluster \ --global-cluster-identifier global-cluster-id \ --source-db-cluster-identifier arn:aws:rds:us-east-1:111122223333:cluster-id

对于 Windows:

aws docdb create-db-cluster ^ --global-cluster-identifier global-cluster-id ^ --source-db-cluster-identifier arn:aws:rds:us-east-1:111122223333:cluster-id

此操作的输出将类似于下文(JSON 格式)。

{ "DBCluster": { "StorageEncrypted": false, "DBClusterMembers": [], "Engine": "docdb", "DeletionProtection" : "enabled", "ClusterCreateTime": "2018-11-26T17:15:19.885Z", "DBSubnetGroup": "default", "EngineVersion": "4.0.0", "MasterUsername": "masteruser", "BackupRetentionPeriod": 1, "DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:cluster-id", "DBClusterIdentifier": "cluster-id", "MultiAZ": false, "DBClusterParameterGroup": "default.docdb4.0", "PreferredBackupWindow": "09:12-09:42", "DbClusterResourceId": "cluster-KQSGI4MHU4NTDDRVNLNTU7XVAY", "PreferredMaintenanceWindow": "tue:04:17-tue:04:47", "Port": 27017, "Status": "creating", "ReaderEndpoint": "cluster-id.cluster-ro-sfcrlcjcoroz.us-east-1.docdb.amazonaws.com", "AssociatedRoles": [], "HostedZoneId": "ZNKXTT8WH85VW", "VpcSecurityGroups": [ { "VpcSecurityGroupId": "sg-77186e0d", "Status": "active" } ], "AvailabilityZones": [ "us-east-1a", "us-east-1c", "us-east-1e" ], "Endpoint": "cluster-id.cluster-sfcrlcjcoroz.us-east-1.docdb.amazonaws.com" } }

创建集群需要几分钟时间。您可以使用 Amazon Web Services Management Console或 Amazon CLI 监控集群的状态。有关更多信息,请参阅 监控 Amazon DocumentDB 集群的状态

重要

当您使用以下应用程序时:Amazon CLI要创建 Amazon DocumentDB 区域集群,不创建任何实例。因此,您必须显式创建主实例和所需的任何副本实例。您可以使用控制台或 Amazon CLI 来创建实例。有关更多信息,请参阅 。将 Amazon DocumentDB 实例添加到集群CreateDBClusterAmazon DocumentDB API 参考中。

您的区域集群可用后,您可以按照以下说明在其他区域添加辅助集群:添加Amazon Web Services 区域到Amazon DocumentDB B 全球集群. 当您添加区域时,您的区域集群将成为您的主集群,并且您在所选区域中有一个新的辅助集群。

添加Amazon Web Services 区域到Amazon DocumentDB B 全球集群

一个全局集群需要在与主集群不同的区域中至少有一个辅助集群,并且您最多可以添加五个辅助集群。请注意,对于添加的每个辅助集群,必须将主集群中允许的副本数量减少一个。例如,如果您的全局集群有五个辅助区域,则主集群只能有十个(而不是十五个)副本。有关更多信息,请参阅 。Amazon DocumentDB 全局集群的配置要求.

  1. 登录Amazon Web Services Management Console然后打开Amazon DocumentDB B 控制台。

  2. 在导航窗格中,选择 Clusters

  3. 选择要向其中添加辅助集群的集群。确保集群是Available.

  4. 选择下拉菜单操作然后选择添加区域.

  5. 添加区域页面上,选择辅助区域。请注意,您不能为同一个全局集群选择在该区域中已有辅助集群的区域。此外,该区域也不能是主集群所在的同一个区域。如果这是您要添加的第一个区域,则还必须指定您选择的全局集群标识符。

  6. 在新区域中填写辅助集群的其余字段,然后选择创建集群. 完成添加区域后,它会出现在以下列表中:集群在里面Amazon Web Services Management Console.

  • 使用create-db-cluster带有名称的 CLI 命令(--global-cluster-identifier)您的全局集群。对于其他参数,请执行以下操作:

    • 对于--region,请选择不同的Amazon Web Services 区域而不是你的主要地区。

    • 为以下项选择特定的值--engine--engine-version参数。

    • 对于加密集群,请将主 Amazon Web Services 区域 指定为 --source-region 以进行加密。

以下示例创建了一个新 Amazon DocumentDB 集群,并将其作为只读辅助集群挂载到全局集群。在最后一步中,实例将添加到新集群。

在以下示例中,将每个用户输入占位符替换为您自己的信息。

对于 Linux、macOS 或 Unix:

aws docdb --region secondary-region-id \ create-db-cluster \ --db-cluster-identifier cluster-id \ --global-cluster-identifier global-cluster-id \ --engine-version version aws docdb --region secondary-region-id \ create-db-instance \ --db-cluster-identifier cluster-id \ --global-cluster-identifier global-cluster-id \ --engine-version version \ --engine docdb

对于 Windows:

aws docdb --region secondary-region-id ^ create-db-cluster ^ --db-cluster-identifier cluster-id ^ --global-cluster-identifier global-cluster-id ^ --engine-version version aws docdb --region secondary-region-id ^ create-db-instance ^ --db-cluster-identifier cluster-id ^ --global-cluster-identifier global-cluster-id ^ --engine-version version ^ --engine docdb

对 Amazon DocumentDB 全局集群使用快照

您可以还原 Amazon DocumentDB 集群的快照以作为全局集群的起点。为此,您必须还原快照并创建新集群。这将作为您的全局集群的主集群。然后,您可以向恢复的集群添加另一个区域,从而将其转换为全局集群。