Spring Data Azure Cosmos DB v3 para a API para NoSQL: notas sobre a versão e recursos

APLICA-SE A: NoSQL

O Spring Data Azure Cosmos DB versão 3 para NoSQL permite que os desenvolvedores usem o Azure Cosmos DB em aplicativos Spring. O Spring Data Azure Cosmos DB expõe a interface do Spring Data para manipular bancos de dados e coleções, trabalhar com documentos e emitir consultas. As APIs de sincronização e assíncrona (reativa) são permitidas no mesmo artefato Maven.

A Estrutura do Spring é um modelo de programação e configuração que simplifica o desenvolvimento de aplicativos Java. O Spring simplifica a "conexão" de aplicativos usando a injeção de dependência. Muitos desenvolvedores gostam do Spring, pois ele simplifica a criação e o teste de aplicativos. O Spring Boot estende essa manipulação da conexão com atenção ao desenvolvimento de aplicativos e microsserviços da Web. O Spring Data é um modelo de programação e uma estrutura para acessar datastores como Azure Cosmos DB do contexto de um aplicativo Spring ou Spring Boot.

Você pode usar o Azure Cosmos DB Spring Data em aplicativos hospedados no Azure Spring Apps.

Política de suporte de versão

Suporte à versão do Spring Boot

Este projeto dá suporte a várias versões do Spring Boot. Visite a política de suporte do spring boot para obter mais informações. Os usuários do Maven podem herdar do projeto spring-boot-starter-parent para obter uma seção de gerenciamento de dependência para permitir que o Spring gerencie as versões para as dependências. Visite o suporte à versão do spring boot para obter mais informações.

Suporte à versão do Spring Data

Este projeto dá suporte a diferentes versões spring-data-commons. Visite o suporte à versão do spring data para obter mais informações.

Qual versão do Azure Cosmos DB para o Azure Spring Data devo usar?

A biblioteca do Azure Spring Data Cosmos Azure Cosmos DB dá suporte a várias versões do Spring Boot/Spring Cloud. Confira o mapeamento de versões do Azure Spring Data Azure Cosmos DB para obter informações detalhadas sobre qual versão do Azure Spring Data Azure Cosmos DB usar com a versão do Spring Boot/Spring Cloud.

Introdução rápida

Entre em funcionamento com o Spring Data Azure Cosmos DB nosso guia Spring Boot Starter. A Spring Boot Starter é a maneira recomendada de começar a usar o conector de Azure Cosmos DB Spring Data.

Como alternativa, você pode adicionar a dependência de Azure Cosmos DB Spring Data ao seu pom.xml arquivo, conforme mostrado abaixo:

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

Conteúdo útil

Histórico de versões

O histórico de versões é mantido no repositório azure-sdk-for-java. Confira a lista detalhada de versões no arquivo changelog.

Versão recomendada

É altamente recomendável usar a versão 3.28.1 e superior.

Observações adicionais

• O Spring Data Azure Cosmos DB dá suporte ao Java JDK 8, Java JDK 11 e versões 3.8.0 e superiores do Java JDK 17.

Perguntas frequentes

Como serei notificado sobre a desativação do SDK?

A Microsoft enviará uma notificação com 12 meses de antecedência informando sobre o fim do suporte para o SDK a ser desativado, para facilitar uma transição suave para um SDK com suporte. Você será notificado por meio de vários canais de comunicação: o portal do Azure, as atualizações do Azure e a comunicação direta com os administradores de serviços atribuídos.

Durante o período de 12 meses, posso criar aplicativos usando um SDK do Azure Cosmos DB que será desativado?

Sim, durante o período de notificação de 12 meses, você poderá criar, implantar e modificar aplicativos usando o SDK do Azure Cosmos DB que será desativado. Recomendamos que você migre para uma versão do SDK do Azure Cosmos DB mais recente com suporte durante o período de notificação de 12 meses, conforme o necessário.

Após a data de desativação, o que acontece com os aplicativos que usam o SDK do Azure Cosmos DB sem suporte?

Após a data de desativação, o Azure Cosmos DB não fará mais correções de bug, não adicionará novos recursos nem dará suporte às versões desativadas do SDK. Se você preferir não fazer a atualização, as solicitações enviadas das versões desativadas do SDK continuarão sendo atendidas pelo serviço Azure Cosmos DB.

Quais versões do SDK terão os recursos e as atualizações mais recentes?

Os novos recursos e atualizações serão adicionados somente à última versão secundária da última versão principal do SDK com suporte. Recomendamos que você sempre use a última versão para aproveitar os novos recursos, os aprimoramentos de desempenho e as correções de bug. Se você estiver usando uma versão antiga e não desativada do SDK, suas solicitações para o Azure Cosmos DB continuarão a funcionar, mas você não terá acesso a nenhuma funcionalidade nova.

O que fazer se eu não conseguir atualizar meu aplicativo antes da data limite?

Recomendamos atualizar o mais rápido possível para o SDK mais recente. Depois que um SDK for marcado para desativação, você terá 12 meses para atualizar seu aplicativo. Se você não conseguir fazer a atualização até data de desativação, as solicitações enviadas das versões desativadas do SDK continuarão a ser atendidas pelo Azure Cosmos DB, para que os aplicativos em execução continuem a funcionar. No entanto, o Azure Cosmos DB não fará mais correções de bug, não adicionará novos recursos nem dará suporte às versões desativadas do SDK.

Se você tem um plano de suporte e precisa de suporte técnico, entre em contato conosco abrindo um tíquete de suporte.

Como solicitar que recursos sejam adicionados a um SDK ou ao conector?

Os novos recursos nem sempre são adicionados a cada SDK ou conector imediatamente. Se não houver suporte para um recurso que você gostaria de adicionar, adicione comentários ao nosso fórum da comunidade.

Próximas etapas

Saiba mais sobre o Azure Cosmos DB.

Saiba mais sobre a Estrutura do Spring.

Saiba mais sobre o Spring Boot.

Saiba mais sobre o Spring Data.