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

• SDK .NET v3
• SDK do .NET v2
• .NET Core SDK v2
• .NET Alterar SDK de Feed v2
• Node.js
• Java SDK v4
• Sincronizar Java SDK v2
• Async SDK Java v2
• Dados do Spring v2
• Dados do Spring v3
• Dados do Spring v5
• Python
• Go
• REST
• Fornecedor de Recursos REST
• SQL
• Bulk executor - .NET v2
• Executor em massa - Java

Spring Data O Azure Cosmos DB versão 2 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.

Warning

Esta versão do Spring Data Azure Cosmos DB SDK depende de uma versão desativada 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 V2, é 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 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.

Importante

Estas notas de versão são para a versão 2 do Spring Data Azure Cosmos DB. Você pode encontrar as notas de versão para a versão 3 aqui.

Spring Data O Azure Cosmos DB suporta apenas a API para NoSQL.

Consulte os seguintes 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

Quer começar rápido?

1. Instale o tempo de execução Java mínimo suportado , JDK 8, para que você possa usar o SDK.
2. Crie um aplicativo Spring Data Azure Cosmos DB usando o iniciador. É fácil!
3. Trabalhe no guia do desenvolvedor do Spring Data Azure Cosmos DB, que orienta as solicitações básicas do Azure Cosmos DB.

Você pode girar aplicativos Spring Boot Starter rapidamente usando o Spring Initializr!

Resources

Resource	Link
Transferência de SDK	Maven
Documentação da API	Documentação de referência do Spring Data Azure Cosmos DB
Contribua para o SDK	Repositório do Spring Data Azure Cosmos DB no GitHub
Arranque de Bota de primavera	Biblioteca de cliente do Azure Cosmos DB Spring Boot Starter para Java
Guia do programador	Guia do desenvolvedor do Spring Data Azure Cosmos DB
Usando o Starter	Como usar o Spring Boot Starter com o Azure Cosmos DB para NoSQL Repositório GitHub para Azure Cosmos DB Spring Boot Starter
Exemplo com o Serviço de Aplicativo do Azure	Como usar o Spring e o Azure Cosmos DB com o Serviço de Aplicativo no Linux

Histórico de lançamentos

2.3.0 (21 de maio de 2020)

Novas funcionalidades

• Atualiza a versão Spring Boot para 2.3.0.

2.2.5 (19 de maio de 2020)

Novas funcionalidades

• Atualiza a versão do Azure Cosmos DB para 3.7.3.

Correções de bugs importantes

• Contém correções de vazamento de memória e atualizações de versão Netty do SDK do Azure Cosmos DB 3.7.3.

2.2.4 (6 de abril de 2020)

Correções de bugs importantes

• Corrige allowTelemetry o sinalizador a ter em conta a partir de CosmosDbConfig.
• Corrige TTL a propriedade no contêiner.

2.2.3 (25 de fevereiro de 2020)

Novas funcionalidades

• Adiciona novo findAll por API de chave de partição.
• Atualiza a versão do Azure Cosmos DB para 3.7.0.

Correções de bugs importantes

• Correções collectionName ->containerName.
• Correções entityClass e domainClass ->domainType.
• Corrige "Retornar coleção de entidade salva pelo repositório em vez de entidade de entrada."

2.1.10 (25 de fevereiro de 2020)

Correções de bugs importantes

• Correção de backports para "Retornar coleção de entidade salva pelo repositório em vez de entidade de entrada".

2.2.2 (15 de janeiro de 2020)

Novas funcionalidades

• Atualiza a versão do Azure Cosmos DB para 3.6.0.

Correções de bugs importantes

2.2.1 (31 de dezembro de 2019)

Novas funcionalidades

• Atualiza a versão do SDK do Azure Cosmos DB para 3.5.0.
• Adiciona campo de anotação para habilitar ou desabilitar a criação automática de coleções.
• Melhora o tratamento de exceções. Expõe CosmosClientException através de CosmosDBAccessException.
• Expõe requestCharge e activityId através de ResponseDiagnostics.

Correções de bugs importantes

• A atualização do SDK 3.5.0 corrige "Exceção quando o cabeçalho de resposta HTTP do Azure Cosmos DB é maior que 8192 bytes", "ConsistencyPolicy.defaultConsistencyLevel() falha em Atraso Delimitado e Prefixo Consistente."
• Corrige findById o comportamento do método. Anteriormente, esse método retornava vazio se a entidade não fosse encontrada em vez de lançar uma exceção.
• Corrige um bug em que a classificação não era aplicada na próxima página quando CosmosPageRequest era usada.

2.1.9 (26 de dezembro de 2019)

Novas funcionalidades

• Adiciona campo de anotação para habilitar ou desabilitar a criação automática de coleções.

Correções de bugs importantes

• Corrige findById o comportamento do método. Anteriormente, esse método retornava vazio se a entidade não fosse encontrada em vez de lançar uma exceção.

2.2.0 (21 de outubro de 2019)

Novas funcionalidades

• Suporte completo ao repositório reativo do Azure Cosmos DB.
• Suporte a String de Diagnóstico de Solicitação e Métricas de Consulta do Azure Cosmos DB.
• Atualização da versão do SDK do Azure Cosmos DB para 3.3.1.
• Atualização da versão do Spring Framework para 5.2.0.RELEASE.
• Atualização da versão do Spring Data Commons para 2.2.0.RELEASE.
• Adiciona findByIdAndPartitionKey e deleteByIdAndPartitionKey APIs.
• Remove a dependência do azure-documentdb.
• Renomeia o Banco de Dados de Documentos para o Azure Cosmos DB.

Correções de bugs importantes

• Corrige "A classificação gera exceção quando pageSize é menor que o total de itens no repositório."

2.1.8 (18 de outubro de 2019)

Novas funcionalidades

• Substitui as APIs do Banco de Dados de Documentos.
• Adiciona findByIdAndPartitionKey e deleteByIdAndPartitionKey APIs.
• Adiciona bloqueio otimista com base em _etag.
• Habilita a expressão SpEL para o nome da coleção de documentos.
• Adiciona ObjectMapper melhorias.

2.1.7 (18 de outubro de 2019)

Novas funcionalidades

• Adiciona a dependência do SDK do Azure Cosmos DB versão 3.
• Adiciona o repositório reativo do Azure Cosmos DB.
• Atualiza a implementação do para usar o SDK do DocumentDbTemplate Azure Cosmos DB versão 3.
• Adiciona outras alterações de configuração para suporte ao Repositório Reativo do Azure Cosmos DB.

2.1.2 (19 de março de 2019)

Correções de bugs importantes

• Remove a applicationInsights dependência para:
  • Risco potencial de dependências poluentes.
  • Incompatibilidade Java 11.
  • Evitando possíveis impactos no desempenho da CPU e/ou memória.

2.0.7 (20 de março de 2019)

Correções de bugs importantes

• O backport remove a applicationInsights dependência para:
  • Risco potencial de dependências poluentes.
  • Incompatibilidade Java 11.
  • Evitando possíveis impactos no desempenho da CPU e/ou memória.

2.1.1 (7 de março de 2019)

Novas funcionalidades

• Atualiza a versão principal para 2.1.1.

2.0.6 (7 de março de 2019)

Novas funcionalidades

• Ignore todas as exceções da telemetria.

2.1.0 (17 de dezembro de 2018)

Novas funcionalidades

• Atualiza a versão para 2.1.0 para resolver o problema.

2.0.5 (13 de setembro de 2018)

Novas funcionalidades

• Adiciona palavras-chave exists e startsWith.
• Atualiza o Leiame.

Correções de bugs importantes

• Corrige "Não é possível chamar o self href diretamente para a Entidade."
• Corrige "findAll falhará se a coleção não for criada".

2.0.4 (Pré-lançamento) (23 de agosto de 2018)

Novas funcionalidades

• Renomeia o pacote de documentdb para cosmosdb.
• Adiciona novo recurso de palavra-chave do método de consulta. 16 palavras-chave da API para NoSQL agora são suportadas.
• Adiciona novo recurso de consulta com paginação e classificação.
• Simplifica a configuração do spring-data-cosmosdb.
• Adiciona deleteCollection e deleteAll APIs.

Correções de bugs importantes

• Correção de bugs e mitigação de defeitos.

FAQ

Como vou ser notificado do SDK descontinuado?

A Microsoft fornecerá um aviso prévio de 12 meses antes do fim do suporte do SDK que está a ser retirado para facilitar uma transição suave para um SDK suportado. Notificaremos através de vários canais de comunicação: o portal Azure, atualizações do Azure e comunicação direta com os administradores de serviço atribuídos.

Posso criar candidaturas usando um SDK de Azure Cosmos DB to-bereformado durante o período de 12 meses?

Sim, poderá criar, implementar e modificar aplicações usando o SDK Azure Cosmos DB to-be- retirado durante o período de aviso prévio de 12 meses. Recomendamos que migre para uma versão mais recente suportada do Azure Cosmos DB SDK durante o período de aviso prévio de 12 meses, conforme apropriado.

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

Após a data de reforma, o Azure Cosmos DB deixará de corrigir bugs, adicionar novas funcionalidades nem fornecer suporte às versões do SDK retiradas. Se preferir não atualizar, os pedidos enviados pelas versões desativadas do SDK continuarão a ser servidos pelo serviço Azure Cosmos DB.

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 estiveres a usar uma versão antiga e não desativada do SDK, os teus pedidos para o Azure Cosmos DB continuarão a funcionar, mas não terás acesso a novas funcionalidades.

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 reforma, os pedidos enviados das versões desativadas do SDK continuarão a ser servidos pelo Azure Cosmos DB, pelo que as suas aplicações em execução continuarão a funcionar. Mas o Azure Cosmos DB já não fará correções de bugs, adiciona novas funcionalidades nem fornece suporte às versões do SDK retiradas.

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.

Passos seguintes

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.