為適用於 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 或更新版本。 如果您的帳戶未顯示升級選項,請提出支援票證。
升級您的版本
登入 Azure 入口網站。
導覽至 Azure Cosmos DB for MongoDB 帳戶。 開啟 [概觀] 窗格,並確認您目前的伺服器版本是 3.2 或 3.6。
從左側功能表開啟
Features
窗格。 窗格會顯示您的資料庫帳戶可用的帳戶層級功能。選取
Upgrade MongoDB server version
資料列。 若未看到此選項,表示您的帳戶可能不符合這項升級的資格。 如果是這種情況,請提出 支援票證 。檢閱顯示的升級相關資訊。 選取
Set server version to 4.2
(或依據您目前的版本選取 4.0 或 3.6)。開始升級之後,[ 功能 ] 功能表會呈現灰色,狀態會設定為 [擱置]。 完成升級通常約需要 15 分鐘。 此程式不會影響資料庫帳戶的現有功能或作業。 完成之後,更新 MongoDB 伺服器版本的狀態會顯示升級後的版本。 如果處理您的要求時發生問題,請連絡支持人員 。
以下是升級帳戶之後需要考量的事項:
如果您是從 3.2 升級,請返回 [概觀] 窗格,並複製新的連接字串以用於您的應用程式。 執行 3.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。
如果您從 3.2 升級至 ,且想要降級回 3.2,請切換回使用先前的 (3.2) 連接字串 主機
accountname.documents.azure.com
,其在執行 3.2 版后仍為作用中。變更應用程式中的 連接字串。