Azure Cosmos DB Java SDK v4 per API per NoSQL: note sulla versione e risorse

  • Articolo

SI APPLICA A: NoSQL

Azure Cosmos DB Java SDK v4 per NoSQL combina un'API asincrona e un'API di sincronizzazione in un unico artefatto Maven. V4 SDK offre prestazioni migliorate, nuove funzionalità API e supporto asincrono basato su Project Reactor e sulla libreria Netty. Si prevede quindi che Azure Cosmos DB Java SDK v4 offra prestazioni più elevate rispetto ad Azure Cosmos DB Async Java SDK v2 e Azure Cosmos DB Sync Java SDK v2.

Importante

Queste note sulla versione sono destinate solo ad Azure Cosmos DB Java SDK v4. Se attualmente si usa una versione precedente a v4, vedere l'articolo Eseguire la migrazione a Java SDK v4 per Azure Cosmos DB per informazioni sull'aggiornamento a v4.

Per iniziare rapidamente, eseguire questi tre passaggi.

  1. Installare la prima versione supportata di Java Runtime, JDK 8 per poter usare l'SDK.
  2. Consultare la Guida di avvio rapido per Azure Cosmos DB Java SDK v4, che consente di accedere all'artefatto Maven e prende in esame le richieste di base di Azure Cosmos DB.
  3. Leggere i suggerimenti sulle prestazioni e le guide alla risoluzione dei problemi di Azure Cosmos DB Java SDK v4 per ottimizzare l'SDK per l'applicazione.

I workshop e i laboratori su Azure Cosmos DB costituiscono un'altra risorsa molto utile per imparare a usare Azure Cosmos DB Java SDK v4.

Contenuto utile

Contenuto Collega
Note sulla versione Note sulla versione per Java SDK v4
Download dell'SDK Maven
Documentazione sull'API Documentazione di riferimento API Java
Contribuire all'SDK Repository centrale di Azure SDK per Java in GitHub
Introduzione Guida introduttiva: Creare un'app Java per gestire i dati di Azure Cosmos DB per NoSQL
Repository GitHub con codice di avvio rapido
Procedure consigliate Procedure consigliate per Java SDK v4
Esempi di codice di base Azure Cosmos DB: esempi Java per l'API per NoSQL
Repository GitHub con codice di esempio
App console con feed di modifiche Feed di modifiche - Esempio di Java SDK v4
Repository GitHub con codice di esempio
Esempio di App Web Creare un'app Web con Java SDK v4
Repository GitHub con codice di esempio
Suggerimenti per incrementare le prestazioni Suggerimenti sulle prestazioni per Java SDK v4
Risoluzione dei problemi Risolvere i problemi di Java SDK v4
Eseguire la migrazione a v4 da un SDK precedente Eseguire la migrazione a Java v4 SDK
Runtime minimo supportato JDK 8
Workshop e laboratori su Azure Cosmos DB Home page dei workshop di Azure Cosmos DB

Importante

  • Gli aggiornamenti reactor-core della versione 4.13.0 e reactor-netty le versioni principali per il 2020.0.4 (Europium) rilascio del training.

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.

È consigliabile usare la versione 4.48.2 e successive.

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

Per altre informazioni su Azure Cosmos DB, vedere la pagina del servizio Microsoft Azure Cosmos DB .