共用方式為


為適用於 MongoDB 的 Azure Cosmos DB for MongoDB 帳戶升級 API 版本

適用於: MongoDB

本文說明如何為適用於 MongoDB 的 Azure Cosmos DB API 帳戶升級 API 版本。 升級之後,您可以在適用於 MongoDB 的 Azure Cosmos DB API 中使用最新的功能。 升級程序不會中斷帳戶的可用性,也不會取用 RU/秒,或在任何時間點減少資料庫的容量。 此程式不會影響現有的數據或索引。

升級至新的 API 版本時,請先從開發/測試工作負載開始,再升級生產工作負載。 在升級適用於 MongoDB 的 Azure Cosmos DB 帳戶之前,請務必將客戶端升級至與您升級的 API 版本相容的版本。

警告

目前,只有使用伺服器 3.2 版的合格帳戶才能升級至 3.6 或更新版本。 如果您的帳戶未顯示升級選項,請提出支援票證

升級您的版本

  1. 登入 Azure 入口網站

  2. 導覽至 Azure Cosmos DB for MongoDB 帳戶。 開啟 [概觀] 窗格,並確認您目前的伺服器版本是 3.2 或 3.6。

    如何從 Azure 入口網站 檢查目前 MongoDB 帳戶版本的螢幕快照。

  3. 從左側功能表開啟 Features 窗格。 窗格會顯示您的資料庫帳戶可用的帳戶層級功能。

  4. 選取 Upgrade MongoDB server version 資料列。 若未看到此選項,表示您的帳戶可能不符合這項升級的資格。 如果是這種情況,請提出 支援票證

    要升級帳戶的功能頁面螢幕快照。

  5. 檢閱顯示的升級相關資訊。 選取 Set server version to 4.2 (或依據您目前的版本選取 4.0 或 3.6)。

    升級指引和選取升級選項的螢幕快照。

  6. 開始升級之後,[ 功能 ] 功能表會呈現灰色,狀態會設定為 [擱置]。 完成升級通常約需要 15 分鐘。 此程式不會影響資料庫帳戶的現有功能或作業。 完成之後,更新 MongoDB 伺服器版本的狀態會顯示升級後的版本。 如果處理您的要求時發生問題,請連絡支持人員

  7. 以下是升級帳戶之後需要考量的事項:

    1. 如果您是從 3.2 升級,請返回 [概觀] 窗格,並複製新的連接字串以用於您的應用程式。 執行 3.2 的舊 連接字串 不會中斷。 為了確保一致的體驗,您的所有應用程式都必須使用新的端點。

    2. 如果您從 3.6 升級,現有的 連接字串 會升級至指定的版本,而且應該繼續使用。

重要

從 3.2 升級時,資料庫帳戶端點後綴會更新為下列格式: <your_database_account_name>.mongo.cosmos.azure.com。 如果您的帳戶是在主權、政府或受限制的 Azure 雲端中建立,此端點可能會有輕微的差異。

如果您要從 3.2 版升級,必須先取代應用程式和驅動程式中與此資料庫帳戶連線的現有端點。 只有使用新端點的連線才能存取新 API 版本中的功能。 先前的 3.2 端點應具有尾碼 .documents.azure.com。 從 3.2 升級到較新版本時,現在需要複合索引來對多個欄位執行排序作業,以確保這些查詢穩定且高效能。 確定這些複合索引已建立,讓您的多欄位排序可以順利進行。

降級您的版本

您也可以透過升級您的版本一節中的相同步驟,將您的帳戶降級為 4.0 或 3.6。

  1. 如果您從 3.2 升級至 ,且想要降級回 3.2,請切換回使用先前的 (3.2) 連接字串 主機accountname.documents.azure.com,其在執行 3.2 版后仍為作用中。

  2. 變更應用程式中的 連接字串。