Spring Data Azure Cosmos DB v3 for API for NoSQL (legado): Notas de versão e recursos

APLICA-SE A: NoSQL

• SDK do .NET v3
• SDK do .NET v2
• SDK do .NET Core v2
• SDK Feed de Alterações .NET v2
• Node.js
• Java SDK v4
• Sincronizar Java SDK v2
• SDK Java assíncrono v2
• Spring Data v2
• Spring Data v3
• Dados do Spring v5
• Python
• Ir
• REST
• Fornecedor de Recursos REST
• SQL
• Executor em massa - .NET v2
• Executor em massa - Java

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.

Aviso

Esta versão do Spring Data Azure Cosmos DB SDK depende de uma versão mais antiga do Spring Boot e do Azure Cosmos DB Java SDK. Este Spring Data Azure Cosmos DB SDK será anunciado como desativando em um futuro próximo! Este não é o SDK mais recente do Azure Spring Data Azure Cosmos DB para Azure Cosmos DB e está desatualizado. Devido a problemas de desempenho e instabilidade no Azure Spring Data Azure Cosmos DB SDK V3, é altamente recomendável usar o Azure Spring Data Azure Cosmos DB v5 para seu projeto. Para atualizar, siga as instruções no guia Migrar para o SDK Java do Azure Cosmos DB v4 para entender a diferença no Java SDK V4 subjacente.

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 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.

Importante

Estas notas de versão são para a versão 3 do Spring Data Azure Cosmos DB.

Azure Spring Data O SDK do Azure Cosmos DB depende da estrutura do Spring Data e suporta apenas a API para NoSQL.

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

• Dados de primavera para Apache Cassandra com o Azure Cosmos DB
• Spring Data MongoDB com Azure Cosmos DB

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

Conteúdo	Ligação
Notas de lançamento	Notas de versão do Spring Data Azure Cosmos DB SDK v3
Documentação do SDK	Azure Spring Data Documentação do SDK do Azure Cosmos DB v3
Transferência de SDK	Maven
Documentação da API	Documentação de referência da API Java
Contribua para o SDK	SDK do Azure para Java Central Repo no GitHub
Introdução	Guia de início rápido: criar um aplicativo Spring Data Azure Cosmos DB para gerenciar o Azure Cosmos DB para dados NoSQL Repositório GitHub com código de início rápido
Exemplos de código básico	Azure Cosmos DB: Spring Data Exemplos do Azure Cosmos DB para a API para NoSQL Repositório GitHub com código de exemplo
Sugestões de desempenho	Dicas de desempenho para Java SDK v4 (aplicável ao Spring Data)
Resolução de problemas	Solução de problemas do Java SDK v4 (aplicável ao Spring Data)
Workshops e laboratórios do Azure Cosmos DB	Página inicial dos workshops do Azure Cosmos DB

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.