Spring Data Azure Cosmos DB v3 per API per NoSQL: 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 Boot
Questo progetto supporta più versioni di Spring Boot. Per altre informazioni, visitare i criteri di supporto di Spring Boot. Gli utenti Maven possono ereditare dal spring-boot-starter-parent
progetto per ottenere una sezione di gestione delle dipendenze per consentire a Spring di gestire le versioni per le dipendenze. Per altre informazioni, visitare il supporto della versione spring boot.
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 il mapping delle versioni di Azure Cosmos DB di Azure Spring Data.
Importante
Queste note sulla versione sono relative alla versione 3 di Spring Data Azure Cosmos DB.
Azure Spring Data Azure Cosmos DB SDK ha dipendenze dal framework Spring Data e supporta solo l'API per NoSQL.
Per informazioni su Spring Data in altre API di Azure Cosmos DB, vedere questi articoli:
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
Contenuto | Collega |
---|---|
Note sulla versione | Note sulla versione per Spring Data AZURE Cosmos DB SDK v3 |
Documentazione SDK | Documentazione di Azure Cosmos DB SDK v3 di Azure Spring Data |
Download dell'SDK | Maven |
Documentazione sull'API | Documentazione di riferimento API Java |
Contribuire all'SDK | Repository centrale di Azure SDK per Java in GitHub |
Operazioni preliminari | Guida introduttiva: Creare un'app Spring Data di Azure Cosmos DB per gestire i dati Di Azure Cosmos DB per NoSQL Repository GitHub con codice di avvio rapido |
Esempi di codice di base | Azure Cosmos DB: esempi di Spring Data per Azure Cosmos DB per l'API per NoSQL Repository GitHub con codice di esempio |
Suggerimenti per incrementare le prestazioni | Suggerimenti sulle prestazioni per Java SDK v4 (applicabile a Spring Data) |
Risoluzione dei problemi | Risolvere i problemi di Java SDK v4 (applicabile a Spring Data) |
Workshop e laboratori su Azure Cosmos DB | Home page dei workshop di Azure Cosmos DB |
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 usare la versione 3.28.1 e successive.
Note aggiuntive
- Spring Data Azure Cosmos DB supporta Java JDK 8, Java JDK 11 e versioni 3.8.0 e successive a 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.