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

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

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

Эта версия пакета SDK Для Spring Data Azure Cosmos DB зависит от более старой версии пакета SDK Spring Boot и Пакета SDK Java для Azure Cosmos DB. В ближайшее время пакет SDK Azure Cosmos DB для Spring Data Azure Cosmos DB будет объявлен как устаревший! Это не последний пакет SDK Azure Spring Data Azure Cosmos DB для Azure Cosmos DB и устарел. Из-за проблем с производительностью и нестабильности в azure Spring Data Azure Cosmos DB SDK версии 3 настоятельно рекомендуется использовать Azure Spring Data Azure Cosmos DB версии 5 для вашего проекта. Следуйте инструкциям по обновлению в руководстве Миграция на пакет SDK для Java в Azure Cosmos DB версии 4 и изучите различия в пакете SDK для Java версии 4.

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

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

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

Поддержка версии 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.

Important

Эти заметки о выпуске применимы к Spring Data Azure Cosmos DB версии 3.

Пакет 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>

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

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

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

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

Настоятельно рекомендуется обновить azure Spring Data Azure Cosmos DB версии 5 и использовать минимальную рекомендуемую версию и выше.

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

  • Spring Data Azure Cosmos DB поддерживает Java JDK 8, Java JDK 11. Версия 3.8.0 и более поздней поддерживают Java JDK 17.

FAQ

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

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

Can I author application by using a to-be-retired Azure Cosmos DB SDK в течение 12-месячного периода?

Да, вы сможете создавать, развертывать и изменять приложения с помощью пакета SDK Azure Cosmos DB to-beв течение 12-месячного периода уведомления. Рекомендуется перейти на более новую поддерживаемую версию пакета SDK Azure Cosmos DB в течение 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.