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

SI APPLICA A: NoSQL

• .NET SDK v3
• .NET SDK V2
• .NET Core SDK v2
• .NET Change Feed SDK v2
• Node.js
• Java SDK v4
• Sync Java SDK v2
• Async Java SDK v2
• Spring Data v2
• Spring Data v3
• Spring Data v5
• Python
• Go
• REST
• Provider di risorse REST
• SQL
• Esecuzione bulk - .NET v2
• Esecuzione bulk - Java

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.

Avviso

Questa versione di Spring Data Azure Cosmos DB SDK dipende da una versione precedente di Spring Boot e 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 V3, è 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 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 Mapping delle versioni di Azure Cosmos DB per 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:

• Spring Data per Apache Cassandra con Azure Cosmos DB
• Spring Data MongoDB con Azure Cosmos DB

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