Aggiornare la versione dell'API per l'account di Azure Cosmos DB for MongoDB

  • Articolo

SI APPLICA A: MongoDB

Questo articolo illustra come aggiornare la versione per l'account dell'API Azure Cosmos DB for MongoDB. Dopo l'aggiornamento, sarà possibile usare le funzionalità più recenti nell'API Azure Cosmos DB for MongoDB. Il processo di aggiornamento non interrompe la disponibilità dell'account e non utilizza UR/sec né riduce la capacità del database in qualsiasi momento. Questo processo non influisce su dati o indici esistenti.

Quando si esegue l'aggiornamento a una nuova versione dell'API, iniziare con carichi di lavoro di sviluppo/test prima di aggiornare i carichi di lavoro di produzione. È importante aggiornare i client a una versione compatibile con la versione dell'API di aggiornamento prima di aggiornare il proprio account Azure Cosmos DB for MongoDB.

Nota

Attualmente, solo gli account idonei che usano il server versione 3.2 possono essere aggiornati alla versione 3.6 e successive. Se il proprio account non mostra l'opzione di aggiornamento, inviare un ticket di supporto.

Aggiornamento alla versione 4.2, 4.0 o 3.6

Vantaggi dell'aggiornamento alla versione 4.2

  • Diversi miglioramenti importanti della pipeline di aggregazione, ad esempio supporto per $merge, trigonometria, espressioni aritmetiche e altro ancora.
  • Supporto per la crittografia lato client che protegge ulteriormente il database consentendo la crittografia selettiva dei singoli campi e la gestione della privacy dei dati crittografati dagli utenti del database e dai provider di hosting.

Vantaggi dell'aggiornamento alla versione 4.0

Di seguito sono riportate le nuove funzionalità incluse nella versione 4.0:

  • Supporto per transazioni con più documenti all'interno di raccolte senza partizionamento.
  • Nuovi operatori di aggregazione
  • Prestazioni di scansioni migliorate
  • Archiviazione più efficiente e veloce

Vantaggi dell'aggiornamento alla versione 3.6

Di seguito sono presentate le nuove funzionalità incluse nella versione 3.6:

  • Prestazioni e stabilità migliorate
  • Supporto per i nuovi comandi di database
  • Supporto per la pipeline di aggregazione per impostazione predefinita e le nuove fasi di aggregazione
  • Supporto per la modifica dei flussi
  • Supporto per gli indici composti
  • Supporto tra partizioni per le operazioni seguenti: aggiornamento, eliminazione, calcolo e ordinamento
  • Miglioramento delle prestazioni per le operazioni di aggregazione seguenti: $count, $skip, $limit and $group
  • L'indicizzazione con caratteri jolly è ora supportata

Modifiche rispetto alla versione 3.2

  • Per impostazione predefinita, la funzionalità di ripetizione del lato server è abilitata, in modo che le richieste provenienti dall'applicazione client non restituiscano errori 16500. Al contrario, le richieste verranno riavviate fino al completamento o al raggiungimento di 60 secondi di timeout.
  • Il timeout configurato per richiesta è di 60 secondi.
  • Per impostazione predefinita, nelle nuove raccolte MongoDB create nella nuova versione del protocollo di trasmissione sarà indicizzata solo la proprietà _id.

Azione richiesta in caso di aggiornamento dalla versione 3.2

Quando si esegue l'aggiornamento dalla versione 3.2, il suffisso dell'endpoint per l'account del database verrà aggiornato nel formato seguente:

<your_database_account_name>.mongo.cosmos.azure.com

Se si esegue l'aggiornamento dalla versione 3.2, sarà necessario sostituire l'endpoint esistente nelle applicazioni e nei driver che si connettono a questo account di database. Solo le connessioni che usano il nuovo endpoint avranno accesso alle funzionalità nella nuova versione dell'API. Il suffisso per l'endpoint 3.2 precedente deve essere .documents.azure.com.

Quando si esegue l'aggiornamento dalla versione 3.2 alle versioni più recenti, sono ora necessari indici composti per eseguire operazioni di ordinamento su più campi in modo da garantire prestazioni stabili ed elevate per queste query. Assicurarsi che questi indici composti vengano creati in modo che gli ordinamenti su più campi abbiano esito positivo.

Nota

Questo endpoint potrebbe presentare piccole differenze se l'account è stato creato in un cloud di Azure sovrano, per enti pubblici o con restrizioni.

Come eseguire l'aggiornamento

  1. Accedere al portale di Azure.

  2. Passare all'account Azure Cosmos DB for MongoDB. Aprire il riquadro Panoramica e verificare che il valore corrente di Versione server sia 3.2 o 3.6.

    Check the current version of your MongoDB account from the Azure portal.

  3. Dal menu a sinistra aprire il riquadro Features. Verranno mostrate le funzionalità a livello di account disponibili per il proprio account di database.

  4. Selezionare la riga Upgrade MongoDB server version. Se questa opzione non è presente, è possibile che l'account non sia idoneo per l'aggiornamento. Inviare un ticket di supporto in caso affermativo.

    Open the Features blade and upgrade your account.

  5. Esaminare le informazioni visualizzate sull'aggiornamento. Selezionare Set server version to 4.2 (oppure 4.0 o 3.6 a seconda della versione corrente).

    Review upgrade guidance and select upgrade.

  6. Dopo l'avvio dell'aggiornamento, il menu Funzionalità viene disattivato e lo stato viene impostato su In sospeso. Il completamento dell'aggiornamento richiede circa 15 minuti. Questo processo non influirà sulle funzionalità o sulle operazioni esistenti dell'account di database. Al termine, lo stato di Aggiorna versione del server MongoDB mostrerà il numero della versione aggiornata. Se si è verificato un problema durante l'elaborazione della richiesta, contattare il supporto tecnico.

  7. Di seguito sono riportate alcune considerazioni da tenere presenti dopo l'aggiornamento dell'account:

    1. Se è stato eseguito l'aggiornamento dalla versione 3.2, tornare al riquadro Panoramica e copiare la nuova stringa di connessione da usare nell'applicazione. La stringa di connessione precedente che esegue la versione 3.2 non verrà interrotta. Per garantire un'esperienza coerente, è necessario che tutte le applicazioni usino il nuovo endpoint.

    2. Se è stato eseguito l'aggiornamento dalla versione 3.6, la stringa di connessione esistente verrà aggiornata alla versione specificata e verrà ancora usata.

Come effettuare il downgrade

È possibile effettuare il downgrade dell'account anche alla versione 4.0 o 3.6 tramite gli stessi passaggi della sezione "Come eseguire l'aggiornamento".

Se è stato eseguito l'aggiornamento dalla versione 3.2, ma si vuole ripristinare tale versione, è sufficiente usare di nuovo la stringa di connessione precedente (3.2) con l'host accountname.documents.azure.com, che rimane attivo dopo l'aggiornamento della versione 3.2.

Passaggi successivi