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

SI APPLICA A: NoSQL

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.

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