Aggiornamento immediato della versione principale di Amazon DocumentDB

Amazon DocumentDB rende generalmente disponibili nuove versioni dei motori di database solo dopo test approfonditi. Puoi scegliere come e quando aggiornare i tuoi cluster Amazon DocumentDB alla nuova versione.

Attualmente, Amazon DocumentDB supporta tre versioni principali: Amazon DocumentDB 3.6, 4.0 e 5.0. È possibile eseguire un aggiornamento immediato della versione principale (MVU) del database mantenendo gli stessi endpoint, storage e tag dei cluster e continuare a utilizzare le applicazioni senza alcuna modifica. Questa funzionalità è disponibile gratuitamente in tutte le regioni in cui è disponibile Amazon DocumentDB 5.0.

Importante

I cluster Amazon DocumentDB non saranno disponibili durante l'aggiornamento della versione principale in loco e i cluster subiranno più riavvii. I tempi di inattività degli upgrade possono variare da cluster a cluster a seconda del numero di raccolte, indici, database e istanze. Si consiglia di eseguire l'aggiornamento durante la finestra di manutenzione o durante le ore di utilizzo limitate. Una volta aggiornato il cluster, non è possibile effettuare il downgrade del cluster alla versione precedente, ma è possibile scegliere di ripristinare l'istantanea precedente all'aggiornamento su un nuovo cluster.

MVUprerequisiti e limitazioni

Di seguito sono riportati i prerequisiti e le limitazioni per l'aggiornamento in loco della versione principale che potrebbe essere necessario comprendere e agire di conseguenza prima di eseguire l'aggiornamento:

• Tipo di istanza: Amazon DocumentDB 4.0/5.0 non supporta le istanze r4.*. Per procedere con un aggiornamento immediato della versione principale, modifica le istanze r4.* in istanze r5.*. Per ulteriori informazioni, consulta Modifica di un'istanza Amazon DocumentDB. Consulta le Classi di istanza supportate per regione istanze supportate basate sulla versione del motore Amazon DocumentDB.

• Patch del sistema operativo dell'istanza: un aggiornamento immediato della versione principale richiede l'ultima patch del sistema operativo (OS) per procedere. Si prega di applicare eventuali azioni di manutenzione del sistema operativo in sospeso sulle istanze prima di procedere con l'aggiornamento in loco. Per ulteriori informazioni, consulta Aggiornamenti del sistema operativo Amazon DocumentDB.

  Nota

  In alcune situazioni, se sono in sospeso le patch del motore a livello di cluster, le patch del sistema operativo delle istanze non sono visibili. Potrebbe essere necessario applicare le patch del motore a livello di cluster prima di procedere con l'applicazione delle patch del sistema operativo dell'istanza e, successivamente, con l'aggiornamento immediato della versione principale. Per informazioni, consulta Esecuzione di un aggiornamento della patch alla versione del motore di un cluster.

• L'aggiornamento immediato della versione principale è disponibile in tutte le regioni in cui è disponibile Amazon DocumentDB 5.0.

• L'aggiornamento diretto della versione principale non è supportato con Amazon DocumentDB 4.0 come versione di destinazione.

• A partire da Amazon DocumentDB 4.0, «.» nei nomi utente non è supportato. Se stai effettuando l'aggiornamento da Amazon DocumentDB 3.6 a 5.0 e hai un nome utente contenente» . «, ricrea il tuo nome utente senza» . «, prima di procedere con l'installazione. MVU

• L'aggiornamento diretto della versione principale non è attualmente supportato sui cluster globali e sui cluster elastici di Amazon DocumentDB.

  Nota

  Per aggiornare i cluster globali, elimina i cluster secondari dal cluster globale, converti il cluster primario in un cluster regionale, esegui un aggiornamento della versione principale sul cluster regionale (primario), quindi ricrea il cluster globale aggiungendo cluster secondari con lo stesso nome per mantenere gli stessi endpoint di prima. Tieni presente che verranno addebitati costi di I/O mentre il cluster primario aggiornato replica i dati nei cluster secondari appena aggiunti. Per i passaggi dettagliati su come rimuovere i cluster secondari dal cluster globale prima dell'eliminazione, consulta. Rimozione di un cluster da un cluster globale Amazon DocumentDB

• Se disponi di una grande quantità di indici (>3.000) che operano in istanze con prestazioni espandibili (ad esempio t3.medium o t4g.medium), devi scalare l'istanza principale su un'istanza più grande (ad esempio, almeno r5.large) per eseguire l'aggiornamento immediato della versione principale. Puoi scegliere di ridurre le dimensioni dell'istanza una volta completato l'aggiornamento della versione principale sul posto. Consulta la tabella seguente per il numero massimo di indici supportati sui tipi di istanza db.t3 e db.t4g per un aggiornamento immediato della versione principale:

  Istanza	Numero massimo di indici supportati per l'utilizzo in loco MVU
  db.t4g.medium	3K
  db.t3.medium	10K

Procedure consigliate per gli aggiornamenti immediati delle versioni principali

Testa sul posto gli aggiornamenti delle versioni principali utilizzando cluster clonati

1. Per testare sul posto gli aggiornamenti delle versioni principali, consigliamo di utilizzare la funzionalità di clonazione rapida per creare un clone del cluster di destinazione. Non dovrai sostenere alcun costo di archiviazione per testare l'aggiornamento in loco della versione principale su un volume clonato, a meno che non modifichi i dati sul cluster. Per ulteriori informazioni sulla clonazione del volume, vedere. Clonazione di un volume per un cluster Amazon DocumentDB

2. Per ottenere una stima più realistica del tempo impiegato per completare l'aggiornamento immediato della versione principale, abbina il numero di istanze del cluster clonato a quello del cluster di destinazione.

3. Consigliamo di testare completamente il cluster Amazon DocumentDB 5.0 appena aggiornato per eventuali differenze funzionali per garantire che tutto funzioni come previsto.

Prima di un aggiornamento immediato della versione principale

1. Tieni pronto un gruppo di parametri del cluster compatibile con la versione.

   Utilizza il gruppo di parametri del cluster predefinito di Amazon DocumentDB per la nuova versione del motore o crea il tuo gruppo di parametri cluster personalizzato per la nuova versione del motore.

   Se associ un gruppo di parametri del cluster Amazon DocumentDB come parte della richiesta di aggiornamento, l'aggiornamento della versione principale sul posto riavvierà automaticamente il cluster per applicare il nuovo gruppo di parametri.

2. Assicurati di aver soddisfatto i prerequisiti per un aggiornamento immediato della versione principale, come indicato nella sezione Prerequisiti e limitazioni.

3. Crea un'istantanea manuale.

   Il processo di aggiornamento crea un'istantanea del cluster di database durante l'aggiornamento. Si consiglia vivamente di creare un'istantanea manuale prima del processo di aggiornamento. Per informazioni, consulta Creazione di un'istantanea manuale del cluster.

   Nota

   L'istantanea automatica creata dal processo di aggiornamento non verrà eliminata automaticamente dopo il completamento dell'aggiornamento della versione principale sul posto. Questa istantanea non comporterà alcun addebito purché rientri nel periodo di conservazione. È possibile scegliere di eliminare questa istantanea dopo aver verificato l'avvenuto aggiornamento del cluster.

   L'istantanea è denominata come. preupgrade-<name>-<version>-<timestamp>

   

4. Controlla se hai già pianificato un aggiornamento immediato della versione principale del tuo cluster.

   Se hai modificato il cluster e hai scelto di applicarlo nella finestra di manutenzione successiva, la pianificazione in atto dell'aggiornamento della versione principale non sarà visibile sulla console, ma puoi visualizzarla nel. CLI È possibile eseguire il comando seguente per verificare se un aggiornamento immediato della versione principale è già pianificato:

   aws docdb describe-db-cluster \
   --region $REGION \
   --db-cluster-identifier $CLUSTER_NAME
      
   "PendingModifiedValues": {
       "EngineVersion": "5.0.0"
   },

5. Esegui più dry-run utilizzando Volume Clone in ambienti inferiori per testare il cluster dopo l'aggiornamento della versione principale in base a qualsiasi piano di esecuzione e differenze funzionali. Consigliamo la clonazione con lo stesso numero e la stessa dimensione di istanze per ottenere una stima migliore del tempo di esecuzione dell'aggiornamento delle versioni principali in atto. Per ulteriori informazioni, consulta Clonazione di un volume per un cluster Amazon DocumentDB.

6. Se il passaggio precedente ha esito positivo, procedi con l'aggiornamento immediato della versione principale nel cluster di produzione.

Durante un aggiornamento immediato della versione principale

È possibile monitorare lo stato di avanzamento dell'aggiornamento della versione principale in loco sottoscrivendo gli eventi di manutenzione del cluster. Al termine dell'aggiornamento, riceverai l'evento «La versione principale del cluster di database è stata aggiornata». Questo e altri eventi che si verificano durante l'aggiornamento vengono visualizzati nella sezione «Eventi e tag» della pagina dei dettagli del cluster nella console Amazon DocumentDB. Lo stato del cluster passa quindi da «in aggiornamento» a «disponibile».

DaCLI, puoi correre aws docdb create-event-subscription per creare eventi e monitorare i progressi. aws docdb describe-events Puoi anche impostare notifiche di eventi per gli eventi di cui sopra su Amazon SNS come destinazione da notificare tramite e-mail, messaggi push e altri metodi. Per ulteriori informazioni, consulta Iscrizione agli eventi di Amazon DocumentDB.

L'aggiornamento immediato della versione principale genera i seguenti eventi durante l'aggiornamento:

• <cluster-name><timestamp>Aggiornamento in corso: creazione di un'istantanea di pre-aggiornamento [preupgrade- -]

• Aggiornamento in corso: clonazione del volume.

• Aggiornamento in corso: aggiornamento di writer.

• Aggiornamento in corso: aggiornamento dei lettori.

• La versione principale del cluster di database è stata aggiornata.

Gli eventi sono visibili anche sulla console nella pagina Eventi:

In AWS CLI, è possibile utilizzare i seguenti comandi per tenere traccia dei progressi:

aws docdb describe-events --source-identifier $CLUSTER_NAME --source-type db-cluster
{
    "Events": [
        {
            "SourceIdentifier": "mycluster",
            "SourceType": "db-cluster",
            "Message": "Database cluster engine version upgrade started.",
            "EventCategories": [
                "maintenance"
            ],
            "Date": "2023-07-11T23:20:32.444000+00:00",
            "SourceArn": "arn:aws:rds:us-east-1:xxxx:cluster:mycluster"
        }
    ]
}

Dopo un aggiornamento immediato della versione principale

Per Amazon DocumentDB 3.6, aggiungi un tag al cluster per distinguere che il cluster è stato aggiornato ad Amazon DocumentDB 5.0 da Amazon DocumentDB 3.6 rispetto a un cluster Amazon DocumentDB 5.0 appena creato. Consulta la sezione sulle differenze tra un cluster Amazon DocumentDB 5.0 aggiornato e un nuovo cluster Amazon DocumentDB 5.0.

Scatta un'istantanea manuale al termine dell'aggiornamento della versione principale in atto, nel caso in cui sia necessario ripristinare lo stato successivo all'aggiornamento. Il processo di creazione automatica delle istantanee riprenderà non appena sarà completato l'aggiornamento della versione principale in atto. L'istantanea manuale non comporterà alcun addebito purché rientri nel periodo di conservazione.

Per utilizzare le nuove funzionalità associate ad Amazon DocumentDB 5.0, ad esempio la crittografia a livello di campo lato client, consigliamo di aggiornare la versione del driver alla versione MongoDB 5.0. API Per ulteriori informazioni, consulta Novità di Amazon DocumentDB 5.0 un elenco delle funzionalità di Amazon DocumentDB 5.0.

Importante

Immediatamente dopo aver eseguito sul posto l'aggiornamento della versione principale (MVU), il cluster Amazon DocumentDB 5.0 ripopolerà i metadati dell'indice, in base ai quali il motore di database ottimizza i piani di esecuzione delle query. Le prestazioni di query previste sul cluster Amazon DocumentDB riprenderanno dopo il completamento del processo di ricalcolo dei metadati dell'indice. In genere, questo processo viene completato in pochi minuti, ma può durare fino a due ore a seconda del numero di indici presenti nel cluster.

Inoltre, un riavvio, un failover o una scalabilità verso l'alto o verso il basso immediati dell'istanza Writer dopo l'installazione possono interrompere il processo di calcolo dei MVU metadati dell'indice sul cluster. Una volta MVU completata l'operazione, consigliamo di apportare tali modifiche dopo aver osservato le prestazioni di query previste sul cluster Amazon DocumentDB 5.0.

Contatta l' AWS assistenza se noti che questo calo temporaneo delle prestazioni persiste per più di due ore dopo l'implementazione. MVU

Testa completamente il cluster Amazon DocumentDB 5.0 aggiornato per assicurarti che tutto funzioni come previsto.

Nota

Dopo aver eseguito un'operazione sul posto MVU su un cluster Amazon DocumentDB con i flussi di modifica abilitati, gli eventi del flusso di modifica precedenti vengono conservati e possono essere ripresi utilizzando o. resumeToken startAtOperationTime Come in ogni cluster Amazon DocumentDB appena creato, i log degli eventi di flusso di modifica più vecchi di change_stream_log_retention_duration vengono eliminati se la dimensione del registro è superiore a 51.200 MB.

Esecuzione di un aggiornamento immediato della versione principale

Using the AWS Management Console

Per eseguire un aggiornamento immediato della versione principale utilizzando: AWS Management Console

1. Accedi AWS Management Consolee apri la console Amazon DocumentDB.

2. Nella tabella Cluster, seleziona il cluster di origine, fai clic su Azioni, quindi su Modifica.

   

3. Nella finestra di dialogo Modifica cluster nella sezione Specifiche del cluster, scegli la versione del database di destinazione (5.0) dal menu a discesa Versione del motore.

   

4. Nella sezione Opzioni del cluster, scegli il gruppo di parametri del cluster appropriato (default.docdb5.0) o un gruppo di parametri creato su misura.

   

5. Una volta completato, scorri verso il basso e scegli Continua.

6. Nella sezione Pianificazione delle modifiche, scegli il tuo piano di pianificazione preferito: applicalo immediatamente o applicalo nella finestra di manutenzione successiva.

   Scegli Modify cluster (Modifica cluster).

   

7. Nella tabella dei cluster, annota lo stato del cluster durante l'aggiornamento:

   

Using the AWS CLI

Usa il set modify-db-cluster API di flag e allow-major-version-upgrade la versione del motore desiderati:

aws docdb modify-db-cluster \
 ‐‐db-cluster-identifier $CLUSTER_NAME \
 ‐‐allow-major-version-upgrade \
 ‐‐engine-version 5.0 \
 ‐‐apply-immediately \
 ‐‐cluster-parameter-group $PARAMETER_GROUP \
 ‐‐region $REGION

Differenze tra i cluster aggiornati da Amazon DocumentDB da 3.6/4.0 a 5.0 e i nuovi cluster Amazon DocumentDB 5.0

• Confronti di documenti secondari per più tipi di dati numerici:

  • Se il cluster viene migrato da Amazon DocumentDB 3.6, erediterà il comportamento di confronto dei sottodocumenti di Amazon DocumentDB 3.6. La differenza funzionale è limitata ai tipi numerici (come Long, Double, Decimal128) in un documento secondario. Ad esempio, {a: {b: {NumberLong(1)}} non è uguale {a: {b: 1}} in Amazon DocumentDB 3.6, mentre vengono confrontati come uguali in Amazon DocumentDB 4.0 e versioni successive.

  • Questo comportamento di confronto dei documenti secondari esiste solo nei cluster Amazon DocumentDB 3.6 e Amazon DocumentDB 5.0 che sono stati aggiornati dalla versione 3.6 utilizzando un aggiornamento della versione principale in loco. Questo non si applica ai cluster Amazon DocumentDB 5.0 appena creati.

• Un aggiornamento immediato della versione principale mantiene gli indici originali sul cluster aggiornato. Come procedura consigliata generale, consigliamo di eliminare e ricreare gli indici una volta completata correttamente l'operazione sul posto. MVU Con Amazon DocumentDB 5.0, abbiamo migliorato l'efficienza complessiva del processo di raccolta dei rifiuti, in particolare per gli indici a bassa cardinalità. Se in passato hai riscontrato problemi con la raccolta dei rifiuti sui tuoi cluster Amazon DocumentDB 3.6 o 4.0, questi cluster trarranno vantaggio dall'eliminazione e dalla ricreazione degli indici dopo. MVU La ricreazione degli indici non è un requisito. Tuttavia, la ricreazione di un indice può richiedere I/O e tempo aggiuntivi. Per ulteriori informazioni, consulta Gestione degli indici Amazon DocumentDB.

Nota

Per un elenco delle differenze funzionali tra Amazon DocumentDB 3.6/4.0 e Amazon DocumentDB 5.0, consulta. Compatibilità di Amazon DocumentDB con MongoDB

Risoluzione dei problemi relativi all'aggiornamento di una versione principale in atto

• In caso di errore, l'aggiornamento in loco della versione principale tenterà di ripristinare l'aggiornamento per presupporre l'ultimo stato operativo del cluster prima dell'inizio dell'aggiornamento. Un rollback riuscito genererà un evento: «Il cluster di database si trova in uno stato che non può essere aggiornato: il cluster DocumentDB si trova in uno stato in cui l'aggiornamento della versione principale non può essere completato con successo». A questo punto, è necessario contattare il team di AWS supporto per risolvere i problemi e tentare nuovamente l'aggiornamento della versione. Puoi continuare a utilizzare il tuo carico di lavoro come prima. In qualsiasi altro raro scenario in cui l'aggiornamento richieda più tempo del previsto, contatta il team di AWS supporto per ricevere assistenza.

• Una volta MVU completato con successo l'installazione, il cluster aggiornato potrebbe subire un temporaneo peggioramento delle prestazioni e un elevato CPU utilizzo per un breve periodo di tempo, mentre è in corso il processo di aggiornamento dei metadati dell'indice. Se continui a riscontrare un peggioramento delle prestazioni per più di 2 ore, contatta l'assistenza. AWS