Spring Data Azure Cosmos DB v3 para API para NoSQL (herdado): notas de versão e recursos

Artigo
11/08/2024

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.

Aviso

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

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

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

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	Link
Notas de versão	Notas sobre a versão do SDK do Spring Data Azure Cosmos DB v3
Documentação do SDK	Documentação do SDK do Azure Spring Data Azure Cosmos DB v3
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	Início Rápido: criar um aplicativo Spring Data Azure Cosmos DB v3 para gerenciar dados do Azure Cosmos DB for NoSQL Repositório GitHub com código de início rápido
Amostras de código básico	Azure Cosmos DB: exemplos do Spring Data Azure Cosmos DB para a API do NoSQL 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 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 atualizar para o Azure Spring Data Azure Cosmos DB v5 e usar a versão mínima recomendada e superior.

Observações adicionais

O Spring Data Azure Cosmos DB dá suporte ao Java JDK 8, Java JDK 11. A versão 3.8.0 e superior também oferece suporte ao 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.

Compartilhar via