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

Spring Data Azure Cosmos DB versione 3 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.

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 e un framework 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.

Politica di supporto delle versioni

Supporto della versione di Spring Data

Questo progetto supporta diverse versioni di spring-data-commons. Per altre informazioni, visitare il supporto della versione di Spring Data.

Quale versione di Azure Spring Data è consigliabile usare Azure Cosmos DB

La libreria Azure Cosmos DB di Azure Spring Data supporta più versioni di Spring Boot/Spring Cloud. Per informazioni dettagliate sulla versione di Azure Spring Data da usare con Spring Boot/Spring Cloud, vedere Mapping delle versioni di Azure Cosmos DB per Azure Spring Data.

Introduzione rapida

Iniziare a usare Spring Data Azure Cosmos DB seguendo la guida di Spring Boot Starter. L'approccio Spring Boot Starter è il modo consigliato per iniziare a usare il connettore Spring Data di Azure Cosmos DB.

In alternativa, è possibile aggiungere la dipendenza spring data di Azure Cosmos DB al pom.xml file, come illustrato di seguito:

<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-spring-data-cosmos</artifactId>
    <version>latest-version</version>
</dependency>

Contenuto utile

Cronologia delle versioni

La cronologia delle versioni viene mantenuta nel repository azure-sdk-for-java, per un elenco dettagliato delle versioni, vedere il file del log delle modifiche.

Versione consigliata

È consigliabile eseguire l'aggiornamento ad Azure Spring Data Azure Cosmos DB v5 e usare la versione minima consigliata e versioni successive.

Note aggiuntive

• Spring Data Azure Cosmos DB supporta Java JDK 8, Java JDK 11. La versione 3.8.0 e successive supporta anche Java JDK 17.

Domande frequenti

In che modo si viene avvisati del ritiro degli SDK?

Microsoft fornirà un preavviso di 12 mesi prima della fine del supporto dell'SDK di ritiro per facilitare una transizione senza problemi a un SDK supportato. Verrà visualizzata una notifica tramite vari canali di comunicazione: il portale di Azure, gli aggiornamenti Azure e la comunicazione diretta agli amministratori del servizio assegnati.

Can I author applications by using a to-be-retired Azure Cosmos DB SDK during the 12-month period?

Sì, sarà possibile creare, distribuire e modificare le applicazioni usando il to-be-ritirato Azure Cosmos DB SDK durante il periodo di preavviso di 12 mesi. È consigliabile eseguire la migrazione a una versione più recente supportata di Azure Cosmos DB SDK durante il periodo di preavviso di 12 mesi, in base alle esigenze.

Dopo la data di ritiro, cosa accade alle applicazioni che usano l'SDK di Azure Cosmos DB non supportato?

Dopo la data di ritiro, Azure Cosmos DB non eseguirà più correzioni di bug, aggiungerà nuove funzionalità o fornirà supporto alle versioni dell'SDK ritirato. Se si preferisce non eseguire l'aggiornamento, le richieste inviate dalle versioni ritirata 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 precedente e non ritirata dell'SDK, le richieste di Azure Cosmos DB funzioneranno ancora, ma non si avrà accesso a 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 è possibile eseguire l'aggiornamento in base alla data di ritiro, le richieste inviate dalle versioni ritirata dell'SDK continueranno a essere gestite da Azure Cosmos DB, quindi le applicazioni in esecuzione continueranno a funzionare. Tuttavia, Azure Cosmos DB non effettuerà più correzioni di bug, aggiungerà nuove funzionalità o fornirà supporto alle versioni dell'SDK ritirato.

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.