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

Spring Data Azure Cosmos DB версии 2 для 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.

Resources

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

2.3.0 (21 мая 2020 г.)

Новые возможности

• Обновляет Spring Boot до версии 2.3.0.

2.2.5 (19 мая 2020 г.)

Новые возможности

• Обновляет Azure Cosmos DB до версии 3.7.3.

Основные исправления ошибок

• Содержит исправления утечки памяти и обновления версий Netty из пакета SDK 3.7.3 для Azure Cosmos DB.

2.2.4 (6 апреля 2020 г.)

Основные исправления ошибок

• Исправляет флаг allowTelemetry, передаваемый из CosmosDbConfig.
• Исправляет свойство TTL в контейнере.

2.2.3 (25 февраля 2020 г.)

Новые возможности

• Добавляет новый элемент findAll с помощью API ключа секции.
• Обновляет Azure Cosmos DB до версии 3.7.0.

Основные исправления ошибок

• Исправляет collectionName ->containerName.
• Исправляет entityClass и domainClass ->domainType.
• Исправляет сохранение коллекции возвращаемых сущностей репозиторием вместо входной сущности.

2.1.10 (25 февраля 2020 г.)

Основные исправления ошибок

• Реализует исправление сохранения коллекции возвращаемых сущностей репозиторием вместо входной сущности для прежних версий.

2.2.2 (15 января 2020 г.)

Новые возможности

• Обновляет Azure Cosmos DB до версии 3.6.0.

Основные исправления ошибок

2.2.1 (31 декабря 2019 г.)

Новые возможности

• Обновляет пакет SDK для Azure Cosmos DB до версии 3.5.0.
• Добавляет поле заметки для включения или отключения автоматического создания коллекций.
• Улучшает обработку исключений. Предоставляет CosmosClientException через CosmosDBAccessException.
• Предоставляет requestCharge и activityId через ResponseDiagnostics.

Основные исправления ошибок

• Обновление пакета SDK 3.5.0 устраняет ошибку "Исключение, если заголовок HTTP-ответа Azure Cosmos DB превышает 8192 байт", "ConsistencyPolicy.defaultConsistencyLevel() завершается сбоем при ограниченной статичности и согласованном префиксе".
• Исправляет поведение метода findById. Ранее этот метод возвращал пустое значение, если сущность не была найдена, а не порождал исключение.
• Устраняет ошибку, из-за которой при использовании CosmosPageRequest сортировка не применялась к следующей странице.

2.1.9 (26 декабря 2019 г.)

Новые возможности

• Добавляет поле заметки для включения или отключения автоматического создания коллекций.

Основные исправления ошибок

• Исправляет поведение метода findById. Ранее этот метод возвращал пустое значение, если сущность не была найдена, а не порождал исключение.

2.2.0 (21 октября 2019 г.)

Новые возможности

• Полная поддержка реактивного репозитория Azure Cosmos DB.
• Поддержка метрик запросов и строки диагностики запросов Azure Cosmos DB.
• Обновляет пакет SDK для Azure Cosmos DB до версии 3.3.1.
• Обновляет платформу Spring Framework до версии 5.2.0.RELEASE.
• Обновляет компонент Spring Data Commons до версии 2.2.0.RELEASE.
• Добавляет API findByIdAndPartitionKey и deleteByIdAndPartitionKey.
• Удаляет зависимость от azure-documentdb.
• Изменяет торговую марку DocumentDB на Azure Cosmos DB.

Основные исправления ошибок

• Исправляет ошибку, из-за которой при сортировке возникало исключение, если значение pageSize было меньше общего количества элементов в репозитории.

2.1.8 (18 октября 2019 г.)

Новые возможности

• Объявляет нерекомендуемыми интерфейсы API DocumentDB.
• Добавляет API findByIdAndPartitionKey и deleteByIdAndPartitionKey.
• Добавляет оптимистичную блокировку на основе _etag.
• Включает поддержку выражения SpEL для имени коллекции документов.
• Добавляет усовершенствования ObjectMapper.

2.1.7 (18 октября 2019 г.)

Новые возможности

• Добавляет зависимость для пакета SDK для Azure Cosmos DB версии 3.
• Добавляет реактивный репозиторий Azure Cosmos DB.
• Обновляет реализацию DocumentDbTemplate для использования пакета SDK для Azure Cosmos DB версии 3.
• Добавляет другие изменения конфигурации для поддержки репозитория Reactive Azure Cosmos DB.

2.1.2 (19 марта 2019 г.)

Основные исправления ошибок

• applicationInsights Удаляет зависимость для:
  • потенциального риска заcорения зависимостей;
  • несовместимости с Java 11;
  • предотвращения потенциального влияния на производительность ЦП и (или) памяти.

2.0.7 (20 марта 2019 г.)

Основные исправления ошибок

• Backport удаляет applicationInsights зависимость для:
  • потенциального риска заcорения зависимостей;
  • несовместимости с Java 11;
  • предотвращения потенциального влияния на производительность ЦП и (или) памяти.

2.1.1 (7 марта 2019 г.)

Новые возможности

• Обновляет основную версию до версии 2.1.1.

2.0.6 (7 марта 2019 г.)

Новые возможности

• Игнорирование всех исключений из данных телеметрии.

2.1.0 (17 декабря 2018 г.)

Новые возможности

• Обновляет версию до 2.1.0, чтобы устранить проблему.

2.0.5 (13 сентября 2018 г.)

Новые возможности

• Добавляет ключевые слова exists и startsWith.
• Обновляет файл сведений.

Основные исправления ошибок

• Исправляет ошибку, препятствовавшую самостоятельному вызову href непосредственно для сущности.
• Исправляет сбой операции findAll в случае, если коллекция не создана.

2.0.4 (предварительная версия) (23 августа 2018 г.)

Новые возможности

• Переименовывает пакет documentdb в cosmosdb.
• Добавляет новую функцию ключевого слова для метода запроса. Теперь поддерживаются 16 ключевых слов из API для NoSQL.
• Добавляет новую функцию запроса с разбиением на страницы и сортировкой.
• Упрощает настройку spring-data-cosmosdb.
• Добавляет API deleteCollection и deleteAll.

Основные исправления ошибок

• Исправление ошибок и устранение дефектов.

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.