Condividi tramite

Spring Data Azure Cosmos DB v2 per API per NoSQL (legacy): note sulla versione e risorse

  • Articolo

SI APPLICA A: NoSQL

Spring Data Azure Cosmos DB versione 2 per NoSQL consente agli sviluppatori di usare Azure Cosmos DB nelle applicazioni Spring. Spring Data Azure Cosmos DB espone l'interfaccia Spring Data per la modifica di database e raccolte, l'uso dei documenti e l'esecuzione di query. Sia le API Sync che Async (Reactive) sono supportate nello stesso artefatto Maven.

Avviso

Questa versione di Spring Data Azure Cosmos DB SDK dipende da una versione ritirata di Azure Cosmos DB Java SDK. Spring Data Azure Cosmos DB SDK verrà annunciato come ritiro nel prossimo futuro. Questa non è la versione più recente di Azure Spring Data SDK per Azure Cosmos DB per Azure Cosmos DB e non è aggiornata. A causa di problemi di prestazioni e instabilità in Azure Spring Data SDK V2, è consigliabile usare Azure Spring Data Azure Cosmos DB v5 per il progetto. Per eseguire l'aggiornamento, seguire le istruzioni nella guida Eseguire la migrazione ad Azure Cosmos DB Java SDK v4 per comprendere la differenza nell'SDK Java V4 sottostante.

Spring Framework è un modello di programmazione e configurazione che semplifica lo sviluppo di applicazioni Java. Spring semplifica il "plumbing" delle applicazioni usando l'inserimento delle dipendenze. Molti sviluppatori come Spring rendono più semplice la compilazione e il test delle applicazioni. Spring Boot estende questa gestione dell'impianto idraulico con un occhio verso lo sviluppo di applicazioni Web e microservizi. Spring Data è un modello di programmazione per l'accesso a archivi dati come Azure Cosmos DB dal contesto di un'applicazione Spring o Spring Boot.

È possibile usare Spring Data Azure Cosmos DB nelle applicazioni ospitate in Azure Spring Apps.

Importante

Queste note sulla versione sono per la versione 2 di Spring Data Azure Cosmos DB. Le note sulla versione per la versione 3 sono disponibili qui.

Spring Data Azure Cosmos DB supporta solo l'API for NoSQL.

Per informazioni su Spring Data in altre API di Azure Cosmos DB, vedere gli articoli seguenti:

Vuoi andare veloce?

  1. Installare il runtime Java minimo supportato, JDK 8, in modo da poter usare l'SDK.
  2. Creare un'app Spring Data di Azure Cosmos DB usando l'utilità di avvio. È facile!
  3. Esaminare la guida per gli sviluppatori di Azure Cosmos DB per Spring Data, che illustra le richieste di base di Azure Cosmos DB.

È possibile attivare rapidamente le app Spring Boot Starter usando Spring Initializr.

Risorse

Conto risorse Collega
Download dell'SDK Maven
Documentazione sull'API Documentazione di riferimento su Spring Data per Azure Cosmos DB
Contribuire all'SDK Repository Spring Data di Azure Cosmos DB in GitHub
Spring Boot Starter Libreria client Spring Boot Starter di Azure Cosmos DB per Java
Guida per sviluppatori Guida per gli sviluppatori di Spring Data per Azure Cosmos DB
Uso di Starter Come usare Spring Boot Starter con Azure Cosmos DB per NoSQL
Repository GitHub per Azure Cosmos DB Spring Boot Starter
Esempio con il servizio app Azure Come usare Spring e Azure Cosmos DB con servizio app in Linux

Cronologia delle versioni

2.3.0 (21 maggio 2020)

Nuove funzionalità

  • Aggiorna la versione di Spring Boot alla versione 2.3.0.

2.2.5 (19 maggio 2020)

Nuove funzionalità

  • Aggiorna la versione di Azure Cosmos DB alla versione 3.7.3.

Principali correzioni di bug

  • Contiene correzioni della perdita di memoria e aggiornamenti delle versioni netty da Azure Cosmos DB SDK 3.7.3.

2.2.4 (6 aprile 2020)

Principali correzioni di bug

  • Correzioni del allowTelemetry flag da prendere in considerazione da CosmosDbConfig.
  • Corregge la TTL proprietà nel contenitore.

2.2.3 (25 febbraio 2020)

Nuove funzionalità

  • Aggiunge un nuovo elemento findAll dall'API della chiave di partizione.
  • Aggiorna la versione di Azure Cosmos DB alla versione 3.7.0.

Principali correzioni di bug

  • Correzioni collectionName ->containerName.
  • Correzioni entityClass e domainClass ->domainType.
  • Correzione di "Return entity collection saved by repository instead of input entity" (Restituisci raccolta di entità salvata dal repository anziché dall'entità di input).

2.1.10 (25 febbraio 2020)

Principali correzioni di bug

  • Correzione dei backport per "Restituire la raccolta di entità salvata dal repository invece dell'entità di input".

2.2.2 (15 gennaio 2020)

Nuove funzionalità

  • Aggiorna la versione di Azure Cosmos DB alla versione 3.6.0.

Principali correzioni di bug

2.2.1 (31 dicembre 2019)

Nuove funzionalità

  • Aggiorna la versione di Azure Cosmos DB SDK alla versione 3.5.0.
  • Aggiunge un campo di annotazione per abilitare o disabilitare la creazione automatica della raccolta.
  • Migliora la gestione delle eccezioni. CosmosClientException Espone tramite CosmosDBAccessException.
  • requestCharge Espone e activityId tramite ResponseDiagnostics.

Principali correzioni di bug

  • L'aggiornamento dell'SDK 3.5.0 corregge l'eccezione "Eccezione quando l'intestazione della risposta HTTP di Azure Cosmos DB è superiore a 8192 byte", "ConsistencyPolicy.defaultConsistencyLevel() ha esito negativo per decadimento ristretto e prefisso coerente".
  • Corregge il findById comportamento del metodo. In precedenza, questo metodo restituiva vuoto se l'entità non è stata trovata invece di generare un'eccezione.
  • Corregge un bug in cui l'ordinamento non è stato applicato alla pagina successiva quando CosmosPageRequest è stato usato.

2.1.9 (26 dicembre 2019)

Nuove funzionalità

  • Aggiunge un campo di annotazione per abilitare o disabilitare la creazione automatica della raccolta.

Principali correzioni di bug

  • Corregge il findById comportamento del metodo. In precedenza, questo metodo restituiva vuoto se l'entità non è stata trovata invece di generare un'eccezione.

2.2.0 (21 ottobre 2019)

Nuove funzionalità

  • Completare il supporto del repository reattivo di Azure Cosmos DB.
  • Supporto della stringa di diagnostica delle richieste di Azure Cosmos DB e delle metriche di query.
  • Aggiornamento della versione di Azure Cosmos DB SDK alla versione 3.3.1.
  • Aggiornamento della versione di Spring Framework alla versione 5.2.0.RELEASE.
  • Aggiornamento della versione di Spring Data Commons alla versione 2.2.0.RELEASE.
  • Aggiunge findByIdAndPartitionKey le API e deleteByIdAndPartitionKey .
  • Rimuove la dipendenza da azure-documentdb.
  • Ridenomina DocumentDB in Azure Cosmos DB.

Principali correzioni di bug

  • Correzione di "L'ordinamento genera un'eccezione quando pageSize è minore degli elementi totali nel repository".

2.1.8 (18 ottobre 2019)

Nuove funzionalità

  • Depreca le API di DocumentDB.
  • Aggiunge findByIdAndPartitionKey le API e deleteByIdAndPartitionKey .
  • Aggiunge il blocco ottimistico in base a _etag.
  • Abilita l'espressione SpEL per il nome della raccolta documenti.
  • Aggiunge ObjectMapper miglioramenti.

2.1.7 (18 ottobre 2019)

Nuove funzionalità

  • Aggiunge la dipendenza di Azure Cosmos DB SDK versione 3.
  • Aggiunge repository reattivo di Azure Cosmos DB.
  • Aggiorna l'implementazione di DocumentDbTemplate per usare Azure Cosmos DB SDK versione 3.
  • Aggiunge altre modifiche di configurazione per il supporto del repository Reattivo di Azure Cosmos DB.

2.1.2 (19 marzo 2019)

Principali correzioni di bug

  • Rimuove la applicationInsights dipendenza per:
    • Rischio potenziale di inquinamento delle dipendenze.
    • Incompatibilità di Java 11.
    • Evitare potenziali effetti sulle prestazioni della CPU e/o della memoria.

2.0.7 (20 marzo 2019)

Principali correzioni di bug

  • Backport rimuove la applicationInsights dipendenza per:
    • Rischio potenziale di inquinamento delle dipendenze.
    • Incompatibilità di Java 11.
    • Evitare potenziali effetti sulle prestazioni della CPU e/o della memoria.

2.1.1 (7 marzo 2019)

Nuove funzionalità

  • Aggiorna la versione principale alla versione 2.1.1.

2.0.6 (7 marzo 2019)

Nuove funzionalità

  • Ignorare tutte le eccezioni dai dati di telemetria.

2.1.0 (17 dicembre 2018)

Nuove funzionalità

  • Aggiorna la versione alla versione 2.1.0 per risolvere il problema.

2.0.5 (13 settembre 2018)

Nuove funzionalità

  • Aggiunge parole exists chiave e startsWith.
  • Aggiorna il file Leggimi.

Principali correzioni di bug

  • Correzioni "Non è possibile chiamare self href direttamente per Entity".
  • Correzioni "findAll avrà esito negativo se la raccolta non viene creata".

2.0.4 (Versione preliminare) (23 agosto 2018)

Nuove funzionalità

  • Rinomina il pacchetto da documentdb a cosmosdb.
  • Aggiunge una nuova funzionalità della parola chiave del metodo di query. Sono ora supportate 16 parole chiave dell'API per NoSQL.
  • Aggiunge una nuova funzionalità di query con paging e ordinamento.
  • Semplifica la configurazione di spring-data-cosmosdb.
  • Aggiunge deleteCollection le API e deleteAll .

Principali correzioni di bug

  • Correzione di bug e mitigazione dei difetti.

Domande frequenti

In che modo si viene avvisati del ritiro degli SDK?

Microsoft invierà un preavviso di 12 mesi prima fine del supporto dell'SDK in fase di ritiro per agevolare la transizione a un SDK supportato. Verrà inviata una notifica tramite diversi canali di comunicazione, ossia il portale di Azure, gli aggiornamenti di Azure e la comunicazione diretta con gli amministratori del servizio assegnati.

È possibile creare applicazioni usando una versione di Azure Cosmos DB SDK che sta per essere ritirata durante il periodo di 12 mesi?

Sì, durante il periodo di preavviso di 12 mesi sarà possibile creare, distribuire e modificare applicazioni usando la versione di Azure Cosmos DB SDK che sta per essere ritirata. Durante il periodo di preavviso di 12 mesi, è consigliabile eseguire la migrazione a una versione più recente supportata di Azure Cosmos DB SDK.

Dopo la data di ritiro, che cosa succede alle applicazioni che usano una versione di Azure Cosmos DB SDK non supportata?

Dopo la data di ritiro, Azure Cosmos DB non eseguirà più correzioni dei bug, non aggiungerà nuove funzionalità, né fornirà supporto per le versioni ritirate dell'SDK. Se si preferisce non eseguire l'aggiornamento, le richieste inviate dalle versioni ritirate dell'SDK continueranno a essere gestite dal servizio Azure Cosmos DB.

Quali versioni dell'SDK avranno le funzionalità e gli aggiornamenti più recenti?

Le nuove funzionalità e gli aggiornamenti verranno aggiunti solo alla versione secondaria più recente della versione principale più recente supportata dell'SDK. È consigliabile usare sempre la versione più recente per sfruttare le nuove funzionalità, i miglioramenti delle prestazioni e le correzioni dei bug. Se si usa una versione di SDK precedente, non ritirata, le richieste inviate ad Azure Cosmos DB continueranno a funzionare, ma non sarà possibile accedere alle nuove funzionalità.

Come si deve procedere se non è possibile aggiornare l'applicazione prima della data del ritiro?

Si consiglia di effettuare l'aggiornamento alla versione di SDK più recente quanto prima. Una volta che un SDK è stato contrassegnato per il ritiro, si avranno a disposizione 12 mesi per aggiornare l'applicazione. Se non si è in grado di eseguire l'aggiornamento entro la data di ritiro, le richieste inviate dalle versioni ritirate dell'SDK continueranno a essere gestite da Azure Cosmos DB, quindi le applicazioni in esecuzione continueranno a funzionare. Tuttavia, Azure Cosmos DB non eseguirà più correzioni dei bug, non aggiungerà nuove funzionalità, né non fornirà supporto per le versioni ritirate dell'SDK.

Se si ha un piano di supporto e si richiede supporto tecnico, contattare Microsoft inviando un ticket di supporto.

Come è possibile richiedere l'aggiunta di funzionalità a un SDK o a un connettore?

Le nuove funzionalità non vengono sempre aggiunte immediatamente a ogni SDK o connettore. Se non è supportata una funzionalità che si vuole aggiungere, aggiungere commenti e suggerimenti al forum della community.

Passaggi successivi

Altre informazioni su Azure Cosmos DB.

Altre informazioni su Spring Framework.

Altre informazioni su Spring Boot.

Altre informazioni su Spring Data.