Обновление версии API учетной записи Azure Cosmos DB для MongoDB
ПРИМЕНИМО К: 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 с ограниченным доступом.
Обновление
Войдите на портал 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, существующая строка подключения будет обновлена до указанного уровня и ее можно продолжать использовать.
Как перейти на использование более ранней версии
При необходимости вы можете вернуться с версии 4.0 на 3.6, выполнив действия из раздела "Обновление".
Если вы выполнили обновление с версии 3.2 до более новой, а теперь хотите вернуться к версии 3.2, просто используйте старую версию (3.2) строки подключения для узла accountname.documents.azure.com
, который остается активным даже после обновления версии 3.2.
Дальнейшие действия
- Изучите сведения о поддерживаемых и неподдерживаемых функциях MongoDB версии 4.2.
- Сведения о поддерживаемых и неподдерживаемых функциях MongoDB версии 4.0.
- Сведения о поддерживаемых и неподдерживаемых функциях MongoDB версии 3.6.
- Дополнительные сведения см. в статье о функциях в версии Mongo 3.6.
- Пытаетесь выполнить планирование ресурсов для миграции в Azure Cosmos DB? Можете использовать для этого сведения о существующем кластере базы данных.
- Если вам известно только количество виртуальных ядер и серверов в существующем кластере баз данных, прочитайте об оценке единиц запроса на основе этих данных.
- Если вам известна стандартная частота запросов для текущей рабочей нагрузки базы данных, ознакомьтесь со статьей о расчете единиц запросов с помощью планировщика ресурсов Azure Cosmos DB