快速入门指南：全球群集

主题

配置
创建全局集群
将区域添加到全局集群
使用快照

配置

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

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

这些集群有以下特定要求：

数据库实例类要求— 您只能使用db.r5实例类。
Amazon Web Services 区域要求— 主群集必须位于一个区域中，并且必须至少有一个辅助群集位于同一账户的不同区域中。您最多可以创建五个辅助（只读）集群，每个集群必须位于不同的区域中。换句话说，同一个区域中没有两个集群可位于同一个区域中。
命名要求— 您为每个集群选择的名称在所有区域中必须唯一。即使不同的集群位于不同的区域中，也不能对它们使用相同的名称。

创建 Amazon DocumentDB 全局集群

准备好构建第一个全球集群了吗？在本节中，我们将解释如何使用Amazon Web Services Management Console要么Amazon CLI以下说明进行操作。

在Amazon Web Services Management Console，导航到Amazon DocumentDB.
当您进入 Amazon DocumentDB 控制台时，选择集群.
选择 Create (创建)。
填写配置的部分创建 Amazon DocumentDB 集群相应地形成：
- 集群标识符：您可以输入此实例的唯一标识符，或允许 Amazon DocumentDB 基于集群标识符提供实例标识符。
- 引擎版本：选择4.0.0
- 实例类：选择db.r5.large
- 实例的数量：选择3.
在身份验证部分中，填写主用户名和主密码。
选择显示高级设置.
在网络设置部分:
- 保留默认选项Virtual Private Cloud和子网组.
- 适用于VPC 安全组、默认 VPC应该已将其添加到。
- 类型DocDB进入VPC 安全组字段然后选择docDB-入站 (VPC).
适用于集群选项和静态加密，保留默认选择。
适用于备份和日志导出，保留默认选择。
适用于维护、标签和删除保护中，保留默认选择。
现在点击显示的按钮Create.

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

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

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

对于 Linux、macOS 或 Unix：


aws docdb create-db-cluster \
      --db-cluster-identifier sample-cluster \
      --engine docdb \
      --engine-version 4.0.0 \
      --deletion-protection \
      --master-username masteruser \
      --master-user-password password

对于 Windows：


aws docdb create-db-cluster ^
      --db-cluster-identifier sample-cluster ^
      --engine docdb ^
      --engine-version 4.0.0 ^
      --deletion-protection ^
      --master-username masteruser ^
      --master-user-password password

此操作的输出将类似于下文（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:sample-cluster",
        "DBClusterIdentifier": "sample-cluster",
        "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": "sample-cluster.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": "sample-cluster.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 实例添加到集群和CreateDBCluster在 Amazon DocumentDB API 参考中。

当您的区域集群可用后，您可以使用以下说明在另一个区域中添加辅助集群：添加Amazon Web Services 区域转到 Amazon DocumentDB 全球群集. 添加区域时，您的区域集群将成为主集群，并且您选择的区域中有一个新的辅助集群。

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

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

登录到Amazon Web Services Management Console然后打开 Amazon DocumentDB 控制台。
在导航窗格中，选择 Clusters。
选择要将辅助集群添加到的集群。确保集群是Available.
选择下拉菜单操作然后选择添加区域.
在存储库的添加区域页面中，选择辅助区域。请注意，您不能为同一个全局集群选择已有辅助集群的区域。此外，该区域也不能是主集群所在的同一个区域。如果这是您要添加的第一个区域，则还必须指定自己选择的全局集群标识符。
在新区域中填写辅助集群的其余字段，然后选择创建集群. 在您完成区域添加后，您可以在集群中的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 \
  create-db-cluster \
    --db-cluster-identifier secondary_cluster_id \
    --global-cluster-identifier global_database_id \
    --engine-version version

aws docdb --region secondary_region \
  create-db-instance \
    --db-instance-class instance_class \
    --db-cluster-identifier secondary_cluster_id \
    --db-instance-identifier db_instance_id \

对于 Windows：


aws docdb --region secondary_region ^
  create-db-cluster ^
    --db-cluster-identifier secondary_cluster_id ^
    --global-cluster-identifier global_database_id_id ^
    --engine-version version

aws docdb --region secondary_region ^
  create-db-instance ^
    --db-instance-class instance_class ^
    --db-cluster-identifier secondary_cluster_id ^
    --db-instance-identifier db_instance_id ^

对 Amazon DocumentDB 全局集群使用快照

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

Javascript 在您的浏览器中被禁用或不可用。

要使用 Amazon Web Services 文档，必须启用 Javascript。请参阅浏览器的帮助页面以了解相关说明。

全球群集

管理全局集群