Spring Data Azure Cosmos DB версии 5 для API для NoSQL: заметки о выпуске и ресурсы

Статья
07/28/2023

ОБЛАСТЬ ПРИМЕНЕНИЯ: NoSQL

Spring Data Azure Cosmos DB версии 5 для NoSQL позволяет разработчикам использовать Azure Cosmos DB в приложениях Spring. Spring Data Azure Cosmos DB предоставляет интерфейс Spring Data для управления базами данных и коллекциями, работы с документами и выдачи запросов. Как синхронные, так и асинхронные (реактивные) API поддерживаются в одном и том же артефакте Maven.

Spring Framework — это модель программирования и конфигурации, которая упрощает разработку приложений Java. Spring упрощает "коммуникацию" приложений с помощью внедрения зависимостей. Многие разработчики предпочитают Spring, поскольку это значительно упрощает создание и тестирование приложений. Spring Boot расширяет возможности такой обработки коммуникации за счет направленности на разработку веб-приложений и микрослужб. Spring Data — это модель программирования и платформа для доступа к хранилищам данных, таким как Azure Cosmos DB, из контекста приложения Spring или Spring Boot.

Можно использовать Spring Data Azure Cosmos DB в своих приложениях, размещенных в Azure Spring Apps.

Политика поддержки версий

Поддержка версии Spring Boot

Этот проект поддерживает несколько версий Spring Boot. Дополнительные сведения см. на странице политики поддержки Spring Boot. Пользователи Maven могут использовать наследование от проекта spring-boot-starter-parent, чтобы получить раздел управления зависимостями, позволяющий Spring управлять версиями для зависимостей. Дополнительные сведения см. на странице поддержки версий Spring Boot.

Поддержка версии Spring Data

Этот проект поддерживает несколько версий spring-data-commons. Дополнительные сведения см. на странице поддержки версий Spring Data.

Какая версия Azure Spring Data Azure Cosmos DB должна использоваться

Библиотека Azure Spring Data Azure Cosmos DB поддерживает несколько версий Spring Boot или Spring Cloud. Дополнительные сведения о том, какая версия Azure Spring Data Azure Cosmos DB используется с spring Boot или Spring Cloud, см. в статье azure Spring Data Azure Cosmos DB.

Важно!

Эти заметки о выпуске предназначены для spring Data Azure Cosmos DB версии 5.

Пакет SDK Azure Spring Data Azure Cosmos DB зависит от платформы Spring Data и поддерживает только API для NoSQL.

Сведения о Spring Data в других API-интерфейсах Azure Cosmos DB см. в этих статьях:

Быстрое начало работы

Порядок установки и настройки Spring Data Azure Cosmos DB представлен в нашем руководстве по Spring Boot Starter. Spring Boot Starter — это рекомендуемый способ приступить к работе с соединителем Spring Data Azure Cosmos DB.

Кроме того, можно добавить зависимость Spring Data Azure Cosmos DB в файл pom.xml, как показано ниже:

<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-spring-data-cosmos</artifactId>
    <version>latest-version</version>
</dependency>

Полезные материалы

Содержимое	Установить связь
Заметки о выпуске	Заметки о выпуске пакета SDK Для Spring Data Azure Cosmos DB версии 5
Документация по пакету SDK	Документация по пакету SDK для Azure Spring Data Azure Cosmos DB версии 5
Скачивание пакета SDK	Maven
Документация по API	Справочная документация по API Java
Участие в разработке пакета SDK	Центральный репозиторий пакета SDK Azure для Java в GitHub
Начало работы	Краткое руководство. Создание приложения Spring Data Azure Cosmos DB для управления данными Azure Cosmos DB для NoSQL Репозиторий GitHub с кодом краткого руководства
Простые примеры кода	Azure Cosmos DB: примеры Spring Data Azure Cosmos DB для API для NoSQL Репозиторий GitHub с примером кода
Советы по улучшению производительности	Советы по повышению производительности для пакета SDK для Java версии 4 (применимо к Spring Data)
Устранение неполадок	Устранение неполадок пакета SDK для Java версии 4 (применимо к Spring Data)
Семинары и лабораторные занятия по Azure Cosmos DB	Домашняя страница семинаров Azure Cosmos DB

История выпусков

История выпусков ведется в репозитории azure-sdk-for-java. Подробный список выпусков см. в файле журнала изменений.

Дополнительные примечания

Spring Data Azure Cosmos DB версии 5 поддерживает только Java JDK 17 и выше.

Вопросы и ответы

Как меня уведомят о прекращении поддержки пакета SDK?

Корпорация Майкрософт за 12 месяцев отправит предварительное уведомление об окончании поддержки пакета SDK, чтобы обеспечить более плавный переход на поддерживаемый пакет SDK. Вы будете уведомлены через разные каналы связи, включая портал Azure и обновления Azure, а также непосредственное общение с назначенными администраторами служб.

Могу ли я во время этого периода в 12 месяцев создавать приложения, используя пакет SDK для Azure Cosmos DB, поддержка которого будет прекращена?

Да, в течение 12-месячного периода уведомления вы сможете разрабатывать, развертывать и изменять приложения с помощью пакета SDK для Azure Cosmos DB, поддержка которого будет прекращена. Мы рекомендуем при удобной возможности перейти на новую поддерживаемую версию Azure Cosmos DB пакета SDK в течение 12-месячного периода уведомления.

Что произойдет с приложениями, использующими неподдерживаемый пакет SDK Azure Cosmos DB, после истечения этого срока?

После прекращения поддержки Azure Cosmos DB больше не будет получать исправления ошибок, новые функции или поддержку для устаревших версий пакета SDK. Даже если вы не выполните обновление, запросы, отправляемые из устаревших версий пакета SDK, будут обрабатываться службой Azure Cosmos DB.

Какие версии пакета SDK получат последние функции и обновления?

Новые функции и обновления получит только последняя дополнительная версия последней основной поддерживаемой версии пакета SDK. Мы рекомендуем всегда работать с последней версией, чтобы вы имели доступ к новым функциям, улучшениям производительности и исправлениям ошибок. Если вы используете старую, но еще поддерживаемую версию пакета SDK, запросы в Azure Cosmos DB будут выполняться без изменений, но вы не сможете использовать новые функции.

Что делать, если не удается обновить приложение до даты прекращения поддержки?

Рекомендуется как можно раньше выполнить обновление до последней версии SDK. После уведомления о том, что поддержка пакета SDK будет прекращена, у вас будет 12 месяцев на обновление приложения. Даже если вы не сможете выполнить обновление до объявленной даты, запросы, отправляемые из устаревших версий пакета SDK, будут обрабатываться Azure Cosmos DB, поэтому выполняющиеся приложения будут работать. Но Azure Cosmos DB больше не будет получать исправления ошибок, новые функции или поддержку для устаревших версий пакета SDK.

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

Как запросить добавление компонентов в пакет SDK или соединитель?

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

Следующие шаги

См. дополнительные сведения об Azure Cosmos DB.

См. дополнительные сведения о Spring Framework.

См. дополнительные сведения о Spring Boot.

См. дополнительные сведения о Spring Data.

Share via