快速入门指南：全局集群 - Amazon DocumentDB
配置创建全局集群将区域添加到全局集群使用快照
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅中国的 Amazon Web Services 服务入门。

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

快速入门指南：全局集群

Configuration

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

说明 Primary Amazon 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使用以下说明。

  1. 在Amazon Web Services Management Console中，导航到Amazon DocumentDB。

  2. 当您访问 Amazon DocumentDB 控制台时，选择集群。

  3. 选择创建。

  4. 填写配置的 部分创建 Amazon DocumentDB 集群相应形式：

    • ​集群标识​符：您可以输入此实例的唯一标识符，或允许 Amazon DocumentDB 基于集群标识符提供实例标识符。

    • 引擎版本：选择4.0.0

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

    • 实例数：选择3。

  5. 在身份验证部分中，填写主用户名和主密码。

  6. 选择显示高级设置。

  7. 在网络设置部分:

    • 保留默认选项Virtual Private Cloud和子网组。

    • 适用于VPC 安全组、默认 VPC应该已经添加。

    • 类型DocDB添加到VPC 安全组字段并选择入站文档 (VPC)。

  8. 适用于集群选项和静态加密，保留默认选择。

  9. 适用于备份和日志导出，保留默认选择。

  10. 适用于维护、标签和删除保护中，保留默认选择。

  11. 现在点击显示的按钮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 全局集群

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

  1. 登录到Amazon Web Services Management Console并打开 Amazon DocumentDB 控制台。

  2. 在导航窗格中，选择 Clusters。

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

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

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

  6. 在新区域中填写辅助集群的其余字段，然后选择创建集群。完成添加区域的操作后，它会出现在集群中的Amazon Web Services Management Console。

  • 使用create-db-cluster命令名为(--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 集群的快照，以作为全局集群的起点。为此，您必须恢复快照并创建新集群。这将作为您的全局集群的主集群。然后，您可以向恢复的群集添加另一个区域，从而将其转换为全局群集。