Обновление версии API учетной записи Azure Cosmos DB для MongoDB

  • Применяется к: ✅ MongoDB

ПРИМЕНЯЕТСЯ К: Mongodb

Important

Вы хотите перенести существующее приложение MongoDB или использовать функции языка запросов MongoDB (MQL)? Рассмотрим Azure DocumentDB.

Вы ищете решение для баз данных для крупномасштабных сценариев с соглашением об уровне обслуживания (SLA) с доступностью 99,999%, мгновенным автомасштабированием и автоматическим переключением на резервные ресурсы в нескольких регионах? Рассмотрим Azure Cosmos DB для NoSQL.

В этой статье описывается, как обновить версию API Azure Cosmos DB для учетной записи MongoDB. После обновления вы можете использовать последние функциональные возможности в API Azure Cosmos DB для MongoDB. Процесс обновления не влияет на доступность вашей учетной записи и не потребляет RU/с, а также ни в какой момент не уменьшает емкость базы данных. Этот процесс не влияет на существующие данные или индексы.

Выполняя обновление до новой версии API, начните с рабочих нагрузок разработки и тестирования, а затем приступайте к обновлению производственных рабочих нагрузок. Важно обновить клиенты до версии, совместимой с версией API, до обновления учетной записи Azure Cosmos DB для MongoDB.

Предупреждение

В настоящий момент до версии 3.6 или более высокой можно обновить только соответствующие требованиям учетные записи, использующие версию сервера 3.2. Если в вашей учетной записи не отображается параметр обновления, отправьте запрос в службу поддержки.

Обновление версии

  1. Войдите на портал Azure.

  2. Перейдите к учетной записи Azure Cosmos DB для MongoDB. Откройте панель Обзор и убедитесь, что в поле Версия сервера указано значение 3.2 или 3.6.

    Скриншот о том, как проверить текущую версию вашей учетной записи MongoDB на портале Azure.

  3. В меню слева откройте панель Features. На этой панели показаны функции на уровне учетной записи, которые доступны для вашей учетной записи базы данных.

  4. Выберите строку Upgrade MongoDB server version. Если этот параметр не отображается, для вашей учетной записи может быть недоступно это обновление. Отправьте запрос в службу поддержки, если это так.

    Снимок экрана: страница функций для обновления учетной записи.

  5. Ознакомьтесь со сведениями об обновлении. Выберите Set server version to 4.2 (или 3.6, или 4.0 в зависимости от используемой версии).

    Снимок экрана: руководство по обновлению и выбор параметра обновления.

  6. После запуска обновления меню "Функции" неактивно, и статус установлен на "Ожидание". Процедура обновления занимает около 15 минут. Этот процесс не влияет на существующие функциональные возможности или операции учетной записи базы данных. После завершения в состоянии обновления версии сервера MongoDB отобразится обновленная версия. Обратитесь в службу поддержки , если возникла проблема с обработкой запроса.

  7. Ниже описаны рекомендуемые действия после обновления учетной записи.

    1. Если вы выполнили обновление с версии 3.2, вернитесь к панели Обзор и скопируйте новую строку подключения для использования в приложении. Старая строка подключения для 3.2 не прерывается. Для обеспечения последовательного опыта все ваши приложения должны использовать новую конечную точку.

    2. При обновлении с версии 3.6 существующий строка подключения обновляется до указанной версии и продолжает использоваться.

Important

При обновлении с версии 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.1 до 3.2 и хотите вернуться к версии 3.2, переключитесь на использование вашей предыдущей строки подключения (3.2) с узлом accountname.documents.azure.com, которая остается активной после обновления до версии 3.2.

  2. Измените строка подключения в приложении.

Связанный контент

  • Last updated on