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

Статья
06/01/2023

ПРИМЕНИМО К: Mongodb

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

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

Примечание

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

Обновление до версии 4.2, 4.0 или 3.6

Преимущества обновления до версии 4.2

Несколько важных усовершенствований в конвейере агрегирования, например поддержка $merge, тригонометрических и арифметических выражений, и многое другое.
Поддержка шифрования полей на стороне клиента, что дополнительно защищает базу данных, позволяя выборочно шифровать отдельные поля и поддерживать недоступность зашифрованных данных для пользователей базы данных и поставщиков услуг размещения.

Преимущества обновления до версии 4.0

Ниже перечислены новые возможности, реализованные в версии 4.0:

поддержка операций над несколькими документами в несегментированных коллекциях;
новые операторы агрегирования;
повышенная производительность сканирования;
более быстрое и эффективное хранилище.

Преимущества обновления до версии 3.6

Ниже перечислены новые возможности, реализованные в версии 3.6.

Повышение производительности и стабильности
Поддержка новых команд базы данных
Поддержка конвейера агрегирования по умолчанию и новых этапов агрегирования
Поддержка потоков изменений
Поддержка составных индексов
Поддержка выполнения по нескольким разделам для следующих операций: обновление, удаление, вычисление и сортировка
Улучшена производительность следующих операций агрегирования: $count, $skip, $limit и $group
Сейчас поддерживается индексирование с использованием подстановочных знаков

Изменения по сравнению с версией 3.2

По умолчанию функция повторной попытки на стороне сервера (SSR) включена, поэтому запросы от клиентского приложения не будут возвращать ошибки 16500. Вместо этого запросы будут возобновлены до завершения или истечения времени ожидания (60 секунд).
Время ожидания каждого запроса составляет 60 секунд.
В коллекциях MongoDB, создаваемых в новой версии протокола коммуникации, будет по умолчанию индексироваться только свойство _id.

Действия, необходимые при обновлении с версии 3.2

При обновлении с версии 3.2 суффикс конечной точки учетной записи базы данных будет иметь следующий формат:

<your_database_account_name>.mongo.cosmos.azure.com

При обновлении с версии 3.2 необходимо заменить существующую конечную точку в приложениях и драйверах, которые подключаются к этой учетной записи базы данных. Только подключения, использующие новую конечную точку, будут иметь доступ к функциям новой версии API. Предыдущая конечная точка версии 3.2 должна иметь суффикс .documents.azure.com.

После обновления с версии 3.2 до более новой версии теперь требуются составные индексы для выполнения операций сортировки по нескольким полям, чтобы обеспечить стабильную и высокую производительность таких запросов. Обязательно создайте такие составные индексы для успешной сортировки по нескольким полям.

Примечание

Эта конечная точка может иметь небольшие отличия, если ваша учетная запись была создана в национальном, государственном облаке или в облаке Azure с ограниченным доступом.