Spring Data Azure Cosmos DB v3 for API for NoSQL (legado): Notas de 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 Sync e Async (Reative) são suportadas no mesmo artefato Maven.

O Spring Framework é um modelo de programação e configuração que simplifica o desenvolvimento de aplicações Java. O Spring simplifica o "encanamento" de aplicativos usando injeção de dependência. Muitos desenvolvedores gostam do Spring porque ele torna a criação e o teste de aplicativos mais simples. O Spring Boot estende esse manuseio do encanamento com um olho no desenvolvimento de aplicativos web e microsserviços. O Spring Data é um modelo de programação e uma estrutura para acessar armazenamentos de dados como o Azure Cosmos DB a partir do contexto de um aplicativo Spring ou Spring Boot.

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

Política de suporte de versão

Suporte à versão Spring Boot

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

Suporte à versão Spring Data

Este projeto suporta diferentes versões spring-data-commons. Visite o suporte da versão de dados de primavera para obter mais informações.

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

Azure Spring Data A biblioteca do Azure Cosmos DB suporta várias versões do Spring Boot / Spring Cloud. Consulte Azure Spring Data Azure Cosmos DB version mapping 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.

Comece rapidamente

Comece a trabalhar com o Spring Data Azure Cosmos DB seguindo nosso guia do Spring Boot Starter. A abordagem Spring Boot Starter é a maneira recomendada de começar a usar o conector Spring Data Azure Cosmos DB.

Como alternativa, você pode adicionar a dependência do Spring Data Azure Cosmos DB 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, para obter uma lista detalhada das versões, consulte o arquivo changelog.

Versão recomendada

É altamente recomendável atualizar para o Azure Spring Data Azure Cosmos DB v5 e usar a versão mínima recomendada e superior.

Notas adicionais

• O Spring Data Azure Cosmos DB suporta Java JDK 8, Java JDK 11. A versão 3.8.0 e superior também suportam Java JDK 17.

FAQ

Como vou ser notificado do SDK descontinuado?

A Microsoft dará um aviso com 12 meses de antecedência antes do fim de suporte do SDK descontinuado para permitir uma transição suave para um SDK suportado. Será notificado através de vários canais de comunicação: o portal do Azure, as atualizações do Azure e através de comunicação direta com os administradores atribuídos aos serviços.

Posso criar aplicações com um SDK do Azure Cosmos DB que vai ser descontinuado durante o período de 12 meses?

Sim, poderá criar, implementar e modificar aplicações com o SDK do Azure Cosmos DB que vai ser descontinuado durante o período de aviso de 12 meses. Recomendamos que migre para uma versão suportada mais recente do SDK do Azure Cosmos DB durante o período de aviso de 12 meses, conforme adequado.

Após a data da descontinuação, o que acontece às aplicações que utilizam o SDK do Azure Cosmos DB não suportado?

Após a data de descontinuação, o Azure Cosmos DB deixará de fazer correções de erros, adicionar funcionalidades novas e fornecer suporte às versões descontinuadas do SDK. Se preferir não atualizar, o serviço Azure Cosmos DB continua a servir os pedidos enviados das versões descontinuadas do SDK.

Que versões do SDK terão as mais recentes funcionalidades e atualizações?

As funcionalidades e atualizações novas só vão ser adicionadas à última versão menor da última grande versão do SDK. Recomendamos que utilize sempre a última versão para tirar partido das funcionalidades, das melhorias ao desempenho e das correções de erro mais recentes. Se estiver a utilizar uma versão antiga e ainda em uso do SDK, os pedidos ao Azure Cosmos DB continuarão a funcionar, mas não terá acesso a nenhuma capacidade nova.

O que devo fazer se não conseguir atualizar a minha aplicação antes da data de descontinuação?

Recomendamos que atualize para o último SDK o mais cedo possível. Quando um SDK é marcado para descontinuação, tem 12 meses para atualizar a sua aplicação. Se não conseguir atualizar até à data de descontinuação, os pedidos enviados das versões descontinuadas do SDK continuam a ser servidos pelo Azure Cosmos DB, pelo que as aplicações em execução continuam a funcionar. Contudo, o Azure Cosmos DB deixará de fazer correções de erros, adicionar funcionalidades novas e fornecer suporte às versões descontinuadas do SDK.

Se tiver um plano de suporte e precisar de suporte técnico, preencha um pedido de suporte para nos contactar.

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

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

Próximos passos

Saiba mais sobre o Azure Cosmos DB.

Saiba mais sobre o Spring Framework.

Saiba mais sobre o Spring Boot.

Saiba mais sobre o Spring Data.