管理 Amazon DocumentDB 彈性叢集

若要管理 Amazon DocumentDB 彈性叢集，您必須擁有具有適當 Amazon DocumentDB 控制平面許可的 IAM 政策。這些許可可讓您建立、修改和刪除叢集。Amazon DocumentDBFullAccess 政策提供管理 Amazon DocumentDB 彈性叢集的所有必要許可。

下列主題顯示如何在使用 Amazon DocumentDB 彈性叢集時執行各種任務。

主題

修改彈性叢集組態

在本節中，我們將說明如何使用 AWS Management Console 或 AWS CLI 搭配下列指示來修改彈性叢集。

修改叢集的主要用途是增加或減少碎片計數和/或碎片運算容量，以擴展碎片。

Using the AWS Management Console

若要使用修改彈性叢集組態 AWS Management Console：

登入 AWS Management Console並開啟 Amazon DocumentDB 主控台。
在導覽窗格中，選擇叢集。

提示
如果您在畫面左側沒有看到導覽窗格，請選擇導覽窗格左上角的選單圖示。
在叢集識別符欄中選擇您要修改的叢集名稱。
選擇 Modify (修改)。
編輯您要變更的欄位，然後選取修改叢集。

注意

或者，您可以前往叢集頁面，勾選叢集旁的方塊，選擇動作，然後選擇修改，以存取修改叢集對話方塊。

Using the AWS CLI

若要使用修改彈性叢集組態 AWS CLI，請使用 update-cluster操作搭配下列參數：

--cluster-arn - 必要項目。您要修改之叢集的 ARN 識別符。
--shard-capacity- 選用。指派給每個碎片vCPUs 數量。上限為 64。允許的值為 2、4、8、16、32、64。
--shard-count- 選用。指派給叢集的碎片數量。上限為 32。
--shard-instance-count - 選用。套用至此叢集中所有碎片的複本執行個體數目。上限為 16。
--auth-type- 選用。用來決定在何處擷取用於存取彈性叢集之密碼的身分驗證類型。有效類型為 PLAIN_TEXT或 SECRET_ARN。
--admin-user-password- 選用。與管理員使用者相關聯的密碼。
--vpc-security-group-ids- 選用。設定 Amazon EC2 和 Amazon Virtual Private Cloud (VPC) 安全群組的清單，以與此叢集建立關聯。
--preferred-maintenance-window- 選用。以國際標準時間 (UTC) 設定系統維護可以發生的每週時間範圍

格式為：ddd:hh24:mi-ddd:hh24:mi。有效日（日）：週一、週二、週三、週四、週五、週六、週日

預設值為從每個 Amazon Web Services 區域的 8 小時時段中隨機選取的 30 分鐘時段，該時段發生在一週的隨機日期。

最短 30 分鐘時段。
--subnet-ids- 選用。設定網路子網路 ID。

在下列範例中，將每個使用者輸入預留位置取代為您自己的資訊。

若為 Linux、macOS 或 Unix：


aws docdb-elastic update-cluster \
    --cluster-arn arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2 \
    --shard-capacity 8 \
    --shard-count 4 \
    --shard-instance-count 3 \
    --admin-user-password testPassword \
    --vpc-security-group-ids ec-65f40350 \
    --subnet-ids subnet-9253c6a3, subnet-9f1b5af9

針對 Windows：


aws docdb-elastic update-cluster ^
    --cluster-arn arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2 ^
    --shard-capacity 8 ^
    --shard-count 4 ^
    --shard-instance-count 3 ^
    --admin-user-password testPassword ^
    --vpc-security-group-ids ec-65f40350 ^
    --subnet-ids subnet-9253c6a3, subnet-9f1b5af9

若要在修改後監控彈性叢集的狀態，請參閱監控彈性叢集。

監控彈性叢集

在本節中，我們會說明如何使用 AWS Management Console 或 AWS CLI 搭配下列指示來監控您的彈性叢集。

Using the AWS Management Console

若要使用監控彈性叢集組態 AWS Management Console：

登入 AWS Management Console並開啟 Amazon DocumentDB 主控台。
在導覽窗格中，選擇叢集。

提示
如果您在畫面左側沒有看到導覽窗格，請選擇導覽窗格左上角的選單圖示。
在叢集識別符欄中選擇您要監控的叢集名稱。
選擇 Monitoring (監控) 索引標籤。

下列監控類別會顯示來自 Amazon CloudWatch 的許多圖表：

資源使用率
輸送量
Latency (延遲)
作業
系統

您也可以透過存取 Amazon CloudWatch AWS Management Console ，為彈性叢集設定自己的監控環境。

Using the AWS CLI

若要使用監控特定彈性叢集組態 AWS CLI，請使用 get-cluster操作搭配下列參數：

--cluster-arn - 必要項目。您想要其資訊的叢集 ARN 識別符。

在下列範例中，將每個使用者輸入預留位置取代為您自己的資訊。

若為 Linux、macOS 或 Unix：


aws docdb-elastic get-cluster \
    --cluster-arn arn:aws:docdb-elastic:us-west-2:123456789012:cluster:/68ffcdf8-e3af-40a3-91e4-24736f2dacc9

針對 Windows：


aws docdb-elastic get-cluster ^
    --cluster-arn arn:aws:docdb:-elastic:us-west-2:123456789012:cluster:/68ffcdf8-e3af-40a3-91e4-24736f2dacc9

此操作的輸出如下所示：


"cluster": {
        ...
        "clusterArn": "arn:aws:docdb-elastic:us-west-2:123456789012:cluster:/68ffcdf8-e3af-40a3-91e4-24736f2dacc9",
        "clusterEndpoint": "stretch-11-477568257630.us-east-1.docdb-elastic.amazonaws.com",
        "readerEndpoint": "stretch-11-477568257630-ro.us-east-1.docdb-elastic.amazonaws.com",
        "clusterName": "stretch-11",     
        "shardCapacity": 2,
        "shardCount": 3,
        "shardInstanceCount: 5,
        "status": "ACTIVE",
        ...
 }

如需詳細資訊，請參閱《Amazon DocumentDB Resource Management API 參考DescribeClusterSnapshot》中的。

若要使用檢視所有彈性叢集的詳細資訊 AWS CLI，請使用 list-clusters操作搭配下列參數：

--next-token- 選用。如果項目輸出數量 (--max-results) 少於基礎 API 呼叫傳回的項目總數，則輸出會包含一個 NextToken，提供您在後續命令中傳送以擷取下一組項目。
--max-results- 選用。要在命令輸出中傳回的總項目數。如果存在的結果超過指定的max-results值，回應中會包含分頁字符 (next-token)，以便擷取剩餘的結果。
- 預設：100
- 最小值 20，最大值 100

在下列範例中，將每個使用者輸入預留位置取代為您自己的資訊。

若為 Linux、macOS 或 Unix：


aws docdb-elastic list-clusters \
    --next-token eyJNYXJrZXIiOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQiOiAxfQ== \
    --max-results 2

針對 Windows：


aws docdb-elastic list-clusters ^
    --next-token eyJNYXJrZXIiOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQiOiAxfQ== ^
    --max-results 2

此操作的輸出如下所示：


{
   "Clusters": [
      {
         "ClusterIdentifier":"mycluster-1",
         "ClusterArn":"arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster"
         "Status":"available",
         "ClusterEndpoint":"sample-cluster.sharded-cluster-corcjozrlsfc.us-west-2.docdb.amazonaws.com"
       }
       {
         "ClusterIdentifier":"mycluster-2",
         "ClusterArn":"arn:aws:docdb:us-west-2:987654321098:sharded-cluster:sample-cluster"
         "Status":"available",
         "ClusterEndpoint":"sample-cluster2.sharded-cluster-corcjozrlsfc.us-west-2.docdb.amazonaws.com"
       }
   ] 
}

刪除彈性叢集

在本節中，我們將說明如何使用 AWS Management Console 或 AWS CLI 搭配下列指示來刪除彈性叢集。

Using the AWS Management Console

若要使用刪除彈性叢集組態 AWS Management Console：

登入 AWS Management Console並開啟 Amazon DocumentDB 主控台。
在導覽窗格中，選擇叢集。

提示
如果您在畫面左側沒有看到導覽窗格，請選擇導覽窗格左上角的選單圖示。
在叢集清單資料表中，選取您要刪除之叢集名稱左側的核取方塊，然後選擇動作。從下拉式選單中選擇 Detete (刪除)。
在刪除「叢集名稱」彈性叢集？對話方塊中，選擇刪除。

刪除叢集需要幾分鐘的時間。若要監控叢集的狀態，請參閱監控 Amazon DocumentDB 叢集的狀態。

Using the AWS CLI

若要使用刪除彈性叢集 AWS CLI，請使用 delete-cluster操作搭配下列參數：

--cluster-arn - 必要項目。您要刪除之叢集的 ARN 識別符。
--no-skip-final-backup- 選用。如果您想要最終備份，您必須將此參數包含最終備份的名稱。您必須包含 --final-backup-identifier 或 --skip-final-backup。
--skip-final-backup- 選用。只有在您不想在刪除叢集之前進行最終備份時，才使用此參數。預設設定是建立最後的快照。

下列 AWS CLI 程式碼範例會刪除 ARN 為 arn：aws：docdb：us-west-2：123456789012：sharded-cluster：sample-cluster 且具有最終備份的叢集。

在下列範例中，將每個使用者輸入預留位置取代為您自己的資訊。

若為 Linux、macOS 或 Unix：


aws docdb-elastic delete-cluster \
    --cluster-arn arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster \
    --no-skip-final-backup \
    --final-backup-identifier finalArnBU-arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster

針對 Windows：


aws docdb-elastic delete-cluster ^
    --cluster-arn arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster ^
    --no-skip-final-backup ^
    --final-backup-identifier finalArnBU-arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster

下列 AWS CLI 程式碼範例會刪除 ARN 為 arn：aws：docdb：us-west-2：123456789012：sharded-cluster：sample-cluster 的叢集，無需進行最終備份。

在下列範例中，將每個使用者輸入預留位置取代為您自己的資訊。

若為 Linux、macOS 或 Unix：


aws docdb-elastic delete-cluster \
    --cluster-arn arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster \
    --skip-final-backup \

針對 Windows：


aws docdb-elastic delete-cluster ^
    --cluster-arn arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster ^
    --skip-final-backup ^

delete-cluster 操作的輸出是您正在刪除的叢集的顯示。

刪除叢集需要幾分鐘的時間。若要監控叢集的狀態，請參閱監控 Amazon DocumentDB 叢集的狀態。

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

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

文件慣用形式

最佳實務

管理彈性叢集快照

管理 Amazon DocumentDB 彈性叢集

主題

修改彈性叢集組態

提示

注意

監控彈性叢集

提示

刪除彈性叢集

提示