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

O Azure Cosmos DB com Spring Data versão 5 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 Aplicativos Spring do Azure.

Política de suporte à 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ências para permitir que o Spring gerencie as versões para 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 Azure Cosmos DB dá suporte a várias versões do Spring Boot/Spring Cloud. Consulte Mapeamento de versão 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 Spring Boot/Spring Cloud.

Importante

Essas notas sobre a versão são para a versão 5 do Azure Cosmos DB com Spring Data.

O SDK do Azure Spring Data Azure Cosmos DB tem dependência na estrutura do Spring Data e suporte apenas à API para NoSQL.

Confira estes artigos para obter informações sobre o Spring Data em outras APIs do Azure Cosmos DB:

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

Conteúdo Vínculo
Notas de lançamento Notas sobre a versão do SDK do Azure Cosmos DB com Spring Data v5
Documentação do SDK Documentação do SDK do Azure Cosmos DB com Spring Data v5
Baixe o SDK Maven
Documentação da API Documentação de referência de API Java
Contribuir para o SDK SDK do Azure para repositório central do Java no GitHub
Introdução Repositório GitHub com código de início rápido
Amostras de código básico Repositório GitHub com exemplo de código
Dicas de desempenho Dicas de desempenho para o SDK do Java v4 (aplicável ao Spring Data)
Solução de problemas Solucionar problemas do SDK do Java v4 (aplicável ao Spring Data)
Workshops e laboratórios do Azure Cosmos DB Home page dos workshops do Azure Cosmos DB

Histórico de lançamentos

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

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

Observações adicionais

  • O Azure Cosmos DB com Spring Data v5 dá suporte apenas ao JDK 17 e superior do Java.

perguntas frequentes

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

Microsoft fornecerá um aviso prévio de 12 meses antes do fim do suporte do SDK de desativação para facilitar uma transição suave para um SDK com suporte. Notificaremos você por meio de vários canais de comunicação: o portal Azure, as atualizações Azure e a comunicação direta com os administradores de serviços atribuídos.

Não posso criar aplicativos usando um SDK de Azure Cosmos DB to-bedesativado durante o período de 12 meses?

Sim, você poderá criar, implantar e modificar aplicativos usando o SDK de Azure Cosmos DB to-bedesativado durante o período de aviso prévio de 12 meses. Recomendamos que você migre para uma versão mais recente com suporte do SDK do Azure Cosmos DB durante o período de aviso prévio de 12 meses, conforme apropriado.

A data de desativação, o que acontece com os aplicativos que usam o SDK Azure Cosmos DB sem suporte?

Após a data de desativação, Azure Cosmos DB não fará mais correções de bugs, adicionará novos recursos ou fornecerá suporte às versões de SDK desativadas. Se você preferir não atualizar, as solicitações enviadas das versões desativadas do SDK continuarão a ser 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 Azure Cosmos DB ainda funcionarão, mas você não terá acesso a novos recursos.

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 atualizar até a data de desativação, as solicitações enviadas das versões desativadas do SDK continuarão a ser atendidas por Azure Cosmos DB, portanto, os aplicativos em execução continuarão funcionando. Mas Azure Cosmos DB não fará mais correções de bugs, adicionará novos recursos ou fornecerá suporte às versões de SDK desativadas.

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.