快速入門指南：全域叢集

主題

組態
建立全域叢集
將區域新增至全域叢集
使用快照

組態

Amazon DocumentDB 全球叢集至少涵蓋兩個。AWS 區域主要區域支援具有一個主要 (寫入器) 執行個體和最多十五個複本執行個體的叢集，而次要區域則執行完全由十六個複本執行個體組成的唯讀叢集。全域叢集最多可以有五個次要區域。此表格列出全域叢集中允許的叢集、執行處理和複本上限。

描述	主要 AWS 區域	次要 AWS 區域
叢集	1	5 (最大值)
寫入器執行個體	1	0
每個叢集的唯讀執行個體 (Amazon DocumentDB 複本)	15 (上限)	16 (總計)
唯讀執行個體 (允許的上限，給定的次要區域的實際數量)	15 - s	s = 次要 AWS 區域的總數

叢集具有下列特定需求：

資料庫執行個體類別需求 — 您只能使用db.r5和db.r6執行個體類別。
AWS 區域需求 — 主要叢集必須位於一個區域中，且至少一個次要叢集必須位於同一帳戶的不同區域中。您最多可以建立五個次要 (唯讀) 叢集，而且每個叢集都必須位於不同的區域。換句話說，沒有兩個叢集可以位於同一個區域。
命名需求 — 您為每個叢集選擇的名稱在所有區域中都必須是唯一的。您不能為不同的叢集使用相同的名稱，即使它們位於不同的區域。

建立 Amazon DocumentDB 全域叢集

您準備好建立第一個全域叢集了嗎？在本節中，我們將說明如何使用AWS Management Console或AWS CLI與下列指示建立具有新資料庫叢集和執行個體的全新全域叢集。

在中AWS Management Console，導覽至 Amazon DocumentDB。
當您進入 Amazon DocumentDB 主控台時，請選擇 [叢集]。
選擇建立。
相應地填寫建立 Amazon DocumentDB 叢集表單的組態區段：
- 叢集識別碼：您可以為此執行個體輸入唯一識別碼，或允許 Amazon DocumentDB 根據叢集識別碼提供執行個體識別碼。
- 引擎版本：選擇 4.0.0
- 執行個體類別：選擇資料庫 .r5. 大
- 執行個體數目：選擇 3。
在「驗證」區段中，填入主要使用者名稱和主密碼。
選擇「顯示進階設定」。
在「網路設定」區段中：
- 保留虛擬私有雲和子網路群組的預設選項。
- 對於 VPC 安全群組，應該已新增預設 VPC。
- 在「VPC 安全群組」欄位DocDB中輸入，然後選取「文件資料庫入埠 (VPC)」。
對於「叢集選項」和「E」ncryption-at-rest，請保留預設選項。
對於「Backup」和「記錄匯出」，請保留預設選項。
對於維護、標籤和刪除保護，請保留預設選項。
現在，單擊顯示「創建」的按鈕。

若要建立 Amazon DocumentDB 區域叢集，請呼叫. create-db-cluster AWS CLI 下列AWS CLI命令會建立名為的 Amazon DocumentDB 叢集。global-cluster-id如需刪除保護的詳細資訊，請參閱刪除 Amazon DocumentDB 集群。

此外，這--engine-version是一個可選參數，默認為最新的主要引擎版本。目前的主要引擎版本為4.0.0。當新的主要引擎版本發行時，的預設引擎版本--engine-version將會更新，以反映持續的主要引擎版本。因此，對於生產工作負載，尤其是依賴指令碼、自動化或AWS CloudFormation範本的工作負載，我們建議您明確指定--engine-version預期的主要版本。

如果未指定db-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"
    }
}

建立叢集需要幾分鐘才能完成。您可以使用AWS Management Console或 AWS CLI 監控叢集的狀態。如需詳細資訊，請參閱監控 Amazon DocumentDB 集群的狀態。

重要

當您使用建立 Amazon DocumentDB 區域叢集時，不會建立任何執行個體。AWS CLI因此，您必須明確建立主要執行個體，以及您需要的任何複本執行個體。您可以使用主控台或 AWS CLI 建立執行個體。如需詳細資訊，請參閱 Amazon DocumentDB API 參考CreateDBCluster中的將 Amazon DocumentDB 執行個體新增至叢集和。

當您的地區叢集可用時，您可以依照下列指示在其他區域新增次要叢集：新增AWS 區域至 Amazon DocumentDB 全域叢集當您新增區域時，您的地區叢集會成為您的主要叢集，而您在選擇的區域中有一個新的次要叢集。

新增AWS 區域至 Amazon DocumentDB 全域叢集

全域叢集在與主要叢集不同的區域中至少需要一個次要叢集，而且您最多可以新增五個次要叢集。請注意，對於您新增的每個次要叢集，您必須將主要叢集中允許的複本數目減少一個。例如，如果您的全域叢集有五個次要區域，則主要叢集只能有十個 (而非十五個) 複本。如需詳細資訊，請參閱 Amazon DocumentDB 全域叢集的組態需求。

登入AWS Management Console並開啟 Amazon DocumentDB 主控台。
在導覽窗格中，選擇叢集。
選擇您要新增次要叢集的叢集。請確定叢集為Available。
選取「作業」的下拉式功能表，然後選擇「新增區域」。
在「新增區域」頁面上，選擇次要區域。請注意，您無法為同一個全域叢集選擇已有次要叢集的區域。此外，它不能與主要叢集位於同一個區域。如果這是您要新增的第一個區域，您也必須指定您選擇的全域叢集識別碼。
完成新區域中次要叢集的其餘欄位，然後選取建立叢集。完成新增區域之後，您可以在中的叢集清單中看到它AWS Management Console。

使用 create-db-cluster CLI 命令搭配全域叢集(--global-cluster-identifier)的名稱。對於其他參數，請執行下列動作：
- 對於--region，請選擇與您主要區域AWS 區域不同的區域。
- 請選擇 --engine 和 --engine-version 參數的特定值。
- 對於加密叢集，請指定主要 AWS 區域作為要加密的 --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 \
    --engine docdb

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 ^
    --engine docdb

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 叢集的快照，以做為全域叢集的起點使用。若要這麼做，您必須還原快照並建立新叢集。這將作為全域叢集的主要叢集。然後，您可以將另一個區域新增至還原的叢集，從而將其轉換為全域叢集。

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

全域叢集

管理全域叢集