Azure Cosmos DB Java SDK v4 for API for NoSQL: notas sobre a versão e recursos

APLICA-SE A: NoSQL

• SDK v3 do .NET
• SDK do .NET v2
• SDK v2 do .NET Core
• SDK do Feed de Alterações do .NET v2
• Node.js
• SDK do Java v4
• SDK do Java Síncrono v2
• SDK do Java Assíncrono v2
• Spring Data v2
• Spring Data v3
• Spring Data v5
• Python
• Go
• REST
• Provedor de recursos REST
• SQL
• Executor em massa – .NET v2
• Executor em massa – Java

O SDK do Java v4 do Azure Cosmos DB for NoSQL combina uma API Async e uma API Sync em um artefato Maven. O SDK da v4 oferece desempenho aprimorado, novos recursos de API e suporte a Async com base no Project Reactor e na biblioteca Netty. Os usuários podem esperar um desempenho aprimorado com o SKD do Java v4 do Azure Cosmos DB em comparação com o SDK do Java Assíncrono v2 do Azure Cosmos DB e o SDK do Java Síncrono v2 do Azure Cosmos DB.

Importante

Essas notas de versão são apenas para o SDK do Java v4 do Azure Cosmos DB. Se você estiver usando uma versão mais antiga do que a v4, confira o guia Migrar para o SDK do Java v4 do Azure Cosmos DB para obter ajuda na atualização da versão 4.

Aqui estão três etapas para começar rápido!

1. Instale o runtime mínimo com suporte para Java, JDK 8 para poder usar o SDK.
2. Trabalhe no Guia de Início Rápido do SDK do Java v4 do Azure Cosmos DB, que fornece acesso ao artefato Maven, e percorre as solicitações básicas do Azure Cosmos DB.
3. Leia as dicas de desempenho e os guias de solução de problemas do SDK do Java v4 do Azure Cosmos DB para otimizar o SDK para seu aplicativo.

Os workshops e laboratórios do Azure Cosmos DB são outro ótimo recurso para aprender como usar o SDK do Java v4 do Azure Cosmos DB!

Conteúdo útil

Conteúdo	Link
Notas de Versão	Notas sobre a versão do SDK v4 do Java
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 Java para gerenciar os dados do Azure Cosmos DB for NoSQL Repositório GitHub com código de início rápido
Práticas recomendadas	Melhores práticas do SDK v4 do Java
Amostras de código básico	Azure Cosmos DB: exemplos de Java para API para NoSQL Repositório GitHub com exemplo de código
Aplicativo de console com feed de alterações	Feed de alterações - amostra do Java SDK v4 Repositório GitHub com exemplo de código
Exemplo de aplicativo Web	Compilar um aplicativo Web com o Java SDK v4 Repositório GitHub com exemplo de código
Dicas de desempenho	Dicas de desempenho para o SDK do Java v4
Solução de problemas	Solucionar problemas do SDK do Java v4
Migrar para v4 de um SDK mais antigo	Migrar para o SDK do Java V4
runtime mínimo com suporte	JDK 8
Workshops e laboratórios do Azure Cosmos DB	Home page dos workshops do Azure Cosmos DB

Importante

• As atualizações da versão 4.13.0 reactor-core e as versões principais reactor-netty para o treinamento sobre a versão 2020.0.4 (Europium).

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 4.48.2 e superior.

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

Para saber mais sobre o Azure Cosmos DB, veja a página do serviço Microsoft Azure Cosmos DB.