本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

Amazon DocumentDB 就地主要版本升級

Amazon DocumentDB 只有在經過廣泛測試之後，才能使用新版本的資料庫引擎。您可以選擇將 Amazon DocumentDB 叢集升級到新版本的方式和時機。

目前，Amazon DocumentDB 支持三個主要版本：Amazon DocumentDB 3.6，4.0 和 5.0。您可以執行資料庫的就地主要版本升級 (MVU)，同時保留叢集的相同端點、儲存區和標籤，並且可以繼續使用您的應用程式而無需進行任何修改。此功能在提供 Amazon DocumentDB 5.0 的所有區域均可免費使用。

MVU先決條件和限制

以下是您在執行升級之前可能需要瞭解並採取行動的就地主要版本升級的先決條件和限制：

就地主要版本升級的最佳作法

使用複製的叢集就地測試主要版本升級

在就地主要版本升級之前

在就地主要版本升級期間

您可以透過訂閱叢集維護事件來監視就地主要版本升級的進度。升級完成後，您會收到「資料庫叢集主要版本已升級」事件。升級期間發生的這個事件和其他事件會出現在 Amazon DocumentDB 主控台中叢集詳細資料頁面的「事件和標籤」區段中。然後，叢集狀態會從「升級」變更為「可用」。

從中CLI，您可以執行aws docdb create-event-subscription以建立事件並監視aws docdb describe-events進度。您也可以將上述事件的事件通知設定 Amazon SNS 透過電子郵件、推送訊息和其他方法通知的目標。如需詳細資訊，請參閱訂閱 Amazon DocumentDB 事件。

就地主要版本升級會在升級期間產生下列事件：

事件也會顯示在主控台的「事件」(E vents) 頁面下方：

在中 AWS CLI，您可以使用下列指令來追蹤進度：

aws docdb describe-events --source-identifier $CLUSTER_NAME --source-type db-cluster
{
    "Events": [
        {
            "SourceIdentifier": "mycluster",
            "SourceType": "db-cluster",
            "Message": "Database cluster engine version upgrade started.",
            "EventCategories": [
                "maintenance"
            ],
            "Date": "2023-07-11T23:20:32.444000+00:00",
            "SourceArn": "arn:aws:rds:us-east-1:xxxx:cluster:mycluster"
        }
    ]
}

在就地主要版本升級之後

對於 Amazon DocumentDB 3.6，請在叢集中新增一個標籤，以區分叢集已從 Amazon DocumentDB 3.6 升級到 Amazon DocumentDB 5.0，而不是新建立的 Amazon DocumentDB 5.0 叢集。請參閱有關已升級的 Amazon DocumentDB 5.0 叢集和新的 Amazon DocumentDB 5.0 叢集之間的差異章節。

如果您需要還原至升級後狀態，請在就地主要版本升級完成後建立手動快照。一旦就地主要版本升級完成，自動快照集程序將會繼續執行。只要手動快照在保留期間內，就不會產生任何費用。

若要使用與 Amazon DocumentDB 5.0 相關聯的新功能 (例如用戶端欄位層級加密)，建議您將驅動程式版本升級至 MongoDB 5.0 版本。API如需詳細資訊，請參Amazon DocumentDB 5.0 中的新功能閱以取得 Amazon DocumentDB 5.0 功能的清單。

完整測試升級後的 Amazon DocumentDB 5.0 叢集，確保一切正常運作。

執行就地主要版本升級

Using the AWS Management Console

若要使用下列項目執行就地主要版本升級 AWS Management Console：

1. 登入AWS Management Console並開啟 Amazon DocumentDB 主控台。

2. 在「叢集」表格中，選取來源叢集，按一下動作，然後按一下修改。

   

3. 在 [叢集規格] 區段的 [修改叢集] 對話方塊中，從 [引擎版本] 下拉式功能表中選擇目標資料庫版本 (5.0)。

   

4. 在 [叢集選項] 區段中，選擇適當的叢集參數群組 (default.docdb5.0) 或自訂建立的參數群組。

   

5. 完成後，向下捲動並選擇「繼續」。

6. 在「排定修改」區段中，選擇您偏好的排程計劃：立即套用或在下一個維護時段套用。

   然後選擇 Modify cluster (修改叢集)。

   

7. 在叢集表格中，記下叢集升級時的狀態：

   

Using the AWS CLI

使用所需modify-db-clusterAPI的引擎版本和allow-major-version-upgrade標誌集：

aws docdb modify-db-cluster \
 ‐‐db-cluster-identifier $CLUSTER_NAME \
 ‐‐allow-major-version-upgrade \
 ‐‐engine-version 5.0 \
 ‐‐apply-immediately \
 ‐‐cluster-parameter-group $PARAMETER_GROUP \
 ‐‐region $REGION

Amazon DocumentDB 3.6/4.0 到 5.0 升級的集群和新的 Amazon DocumentDB 5.0 集群之間的差異

就地主要版本升級的疑難排解