Обновление версии API учетной записи Azure Cosmos DB для MongoDB
Область применения: 
MongoDB
В этой статье описывается, как обновить версию API Azure Cosmos DB для учетной записи MongoDB. После обновления вы можете использовать последние функциональные возможности в API Azure Cosmos DB для MongoDB. Обновление не влияет на доступность вашей учетной записи, не потребляет пропускную способность (ЕЗ/с) и не уменьшает емкость базы данных. Этот процесс не влияет на существующие данные или индексы.
Выполняя обновление до новой версии API, начните с рабочих нагрузок разработки и тестирования, а затем приступайте к обновлению производственных рабочих нагрузок. Важно обновить клиенты до версии, совместимой с версией API, до обновления учетной записи Azure Cosmos DB для MongoDB.
Предупреждение
В настоящий момент до версии 3.6 или более высокой можно обновить только соответствующие требованиям учетные записи, использующие версию сервера 3.2. Если в вашей учетной записи не отображается параметр обновления, отправьте запрос в службу поддержки.
Обновление версии
Войдите на портал Azure.
Перейдите к учетной записи Azure Cosmos DB для MongoDB. Откройте панель Обзор и убедитесь, что в поле Версия сервера указано значение 3.2 или 3.6.
В меню слева откройте панель
Features. На панели отображаются функции учетной записи, доступные для вашей учетной записи базы данных.Выберите строку
Upgrade MongoDB server version. Если этот параметр не отображается, для вашей учетной записи может быть недоступно это обновление. Отправьте запрос в службу поддержки, если это так.
Ознакомьтесь со сведениями об обновлении. Выберите
Set server version to 4.2(или 3.6, или 4.0 в зависимости от используемой версии).
После запуска обновления меню "Функция " неактивна, и для состояния задано значение "Ожидание". Процедура обновления занимает около 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, переключитесь на использование предыдущей версии (3.2) строка подключения с узлом
accountname.documents.azure.com, которая остается активной после обновления версии 3.2.Измените строка подключения в приложении.