共用方式為

為適用於 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. 變更應用程式中的 連接字串。

相關內容