Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Aggiornamento immediato della versione principale di Amazon DocumentDB
Puoi eseguire un aggiornamento della versione principale (Major Version Upgrade) sul posto del tuo cluster Amazon DocumentDB mantenendo gli stessi endpoint, storage e tag. Le tue applicazioni continuano a funzionare senza modifiche. Questa funzionalità è disponibile senza costi aggiuntivi in tutte le regioni in cui è disponibile Amazon DocumentDB.
Importante
Il cluster non sarà disponibile durante l'aggiornamento e verrà sottoposto a più riavvii. Non connettetevi, non leggete o scrivete sul cluster dopo l'avvio dell'aggiornamento. I tempi di inattività variano a seconda del numero di raccolte, indici, database e istanze. Si consiglia di eseguire l'aggiornamento durante la finestra di manutenzione o durante gli orari di scarsa utilizzazione.
Una volta effettuato l'aggiornamento, non è possibile effettuare il downgrade a una versione precedente. Se necessario, è possibile ripristinare l'istantanea precedente all'aggiornamento su un nuovo cluster.
Argomenti
Percorsi di aggiornamento supportati
| Versione di origine | Versione di destinazione |
|---|---|
Amazon DocumentDB 3.6 |
Amazon DocumentDB 5.0 |
Amazon DocumentDB 4.0 |
Amazon DocumentDB 5.0 |
Amazon DocumentDB 5.0 |
Amazon DocumentDB 8.0 |
Nota
In-place MVU non è supportato per cluster globali o cluster elastici. Per aggiornare un cluster globale, rimuovi i cluster secondari, converti il cluster primario in un cluster regionale, esegui l'MVU, quindi ricrea il cluster globale aggiungendo cluster secondari con gli stessi nomi per conservare gli endpoint. Saranno I/O addebitati dei costi mentre il sistema primario aggiornato replica i dati sui nuovi sistemi secondari. Per informazioni dettagliate sulle fasi, consulta Rimozione di un cluster da un cluster globale Amazon DocumentDB.
Prerequisiti
-
Tipo di istanza: Amazon DocumentDB 4.0+ non supporta istanze db.r4. Modifica qualsiasi
db.r4.*istanza in istanze o versioni successive prima dell'aggiornamento.db.r5.*Consulta Modifica di un'istanza Amazon DocumentDB e Classi di istanza supportate per regione. -
Patch del sistema operativo: applica eventuali azioni di manutenzione del sistema operativo in sospeso su tutte le istanze prima dell'aggiornamento. Per informazioni, consulta Aggiornamenti del sistema operativo Amazon DocumentDB.
Nota
Le patch in sospeso del motore a livello di cluster possono nascondere le patch del sistema operativo delle istanze. Se necessario, applica prima le patch al motore. Per informazioni, consulta Esecuzione di un aggiornamento della patch alla versione del motore di un cluster.
-
Limiti di indice sulle istanze espandibili (istanze della famiglia t): se disponi di più di 3.000 indici sulle istanze espandibili, aumenta il primario almeno a db.r5.large prima dell'aggiornamento. È possibile ridimensionare la scala al termine dell'aggiornamento.
Istanza Numero massimo di indici per MVU db.t4g.medium
3K
db.t3.medium
10.000
-
Gruppo di parametri: si consiglia di disporre di un gruppo di parametri del cluster personalizzato per la versione di destinazione prima dell'aggiornamento. Se non ne viene specificato uno, verrà utilizzato il gruppo di parametri predefinito per la versione di destinazione (ad esempio,
default.docdb5.0odefault.docdb8.0). -
Istantanea manuale: crea un'istantanea manuale prima dell'aggiornamento. Il processo di aggiornamento crea un'istantanea automatica denominata
preupgrade-<name>-<version>-<timestamp>, ma consigliamo vivamente di avere un backup personale. 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.
Best practice
Prima dell'aggiornamento: test con un clone
Clonazione di un volume per un cluster Amazon DocumentDBUsalo per creare un clone del tuo cluster. Non dovrai sostenere costi di archiviazione a meno che non modifichi i dati sul clone.
Abbina il numero di istanze del clone al cluster di destinazione per una stima realistica del tempo.
Eseguite l'MVU sul clone e verificate completamente le differenze funzionali.
Verifica se un aggiornamento è già pianificato eseguendo
describe-db-clusterse cercando. PendingModifiedValues.EngineVersionSe hai modificato il cluster e hai scelto di applicarlo nella finestra di manutenzione successiva, la pianificazione non sarà visibile nella console ma potrai visualizzarla su AWS CLI:aws docdb describe-db-clusters \ --regionus-east-1\ --db-cluster-identifiermydocdbcluster"PendingModifiedValues": { "EngineVersion": "5.0.0" },Se il test ha esito positivo, procedi con l'aggiornamento del cluster di produzione.
Durante l'aggiornamento
È 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 cambia quindi da aupgrading. available
Durante l'aggiornamento vengono generati i seguenti eventi:
È iniziato l'aggiornamento della versione principale del motore del cluster di database. Il cluster rimane online.
Preparazione dell’aggiornamento in corso: avvio dei controlli preliminari di aggiornamento online.
Preparazione dell’aggiornamento in corso: completamento dei controlli preliminari di aggiornamento online.
Disattivazione del cluster di database mentre l'istanza principale completa il patch/upgrade processo.
Preparazione dell'aggiornamento in corso: avvio dei controlli preliminari di aggiornamento offline.
Preparazione dell'aggiornamento in corso: precontrolli preliminari di aggiornamento offline completati.
<version-to><timestamp>Aggiornamento in corso: creazione di un'istantanea di pre-aggiornamento [preupgrade- <cluster-name>- <version-from>-to- -].
Aggiornamento in corso: clonazione del volume.
Aggiornamento in corso: aggiornamento di writer.
Aggiornamento in corso: aggiornamento dei lettori.
La versione principale del motore del cluster database è stata aggiornata.
Gli eventi sono visibili nella console nella pagina Eventi:
Da AWS CLI, puoi eseguire aws docdb describe-eventsaws docdb create-event-subscription
aws docdb describe-events --source-identifiermydocdbcluster--source-type db-cluster
Il comando restituisce un output simile al seguente:
{
"Events": [
{
"SourceIdentifier": "mydocdbcluster",
"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 l'aggiornamento
avvertimento
Subito dopo l'aggiornamento della versione principale, il cluster Amazon DocumentDB ripopola i metadati dell'indice utilizzati dal motore di database per ottimizzare i piani di esecuzione delle query. Le prestazioni delle query tornano ai livelli previsti una volta completato questo processo. In genere termina in pochi minuti, ma può richiedere fino a due ore a seconda del numero di indici nel cluster.
Non riavviate, eseguite il failover o non up/down ridimensionate l'istanza di Writer durante questo periodo, poiché ciò potrebbe interrompere il ricalcolo dei metadati dell'indice. Si consiglia di attendere di osservare le prestazioni previste delle query prima di apportare tali modifiche.
Tieni traccia dei progressi tramite i seguenti eventi del cluster:
Post-upgrade stato del cluster: è iniziato il processo di aggiornamento dei metadati dell'indice
Post-upgrade stato del cluster: processo di aggiornamento dei metadati dell'indice completato in X secondi
Contatta l' AWS assistenza se il processo di aggiornamento dei metadati dell'indice non viene completato entro tre ore o se continui a riscontrare problemi di prestazioni dopo il completamento del processo.
Scatta un'istantanea manuale del cluster aggiornato 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.
Cluster di tag aggiornati dalla versione 3.6. Aggiungi un tag per differenziare i cluster aggiornati dalla versione 3.6. (vedi). Post-upgrade considerazioni per i cluster aggiornati dalla versione 3.6 o 4.0
Aggiorna il driver. Per utilizzare nuove funzionalità (ad esempio, collation, views o compressione Zstd in 8.0), esegui l'upgrade alla versione dell'API MongoDB corrispondente. Per ulteriori informazioni, consulta Novità in Amazon DocumentDB 8.0.
Esegui test approfonditi. Convalida la tua applicazione rispetto al cluster aggiornato.
Cosa cambia dopo l'aggiornamento da Amazon DocumentDB 5.0 a 8.0
Dopo aver eseguito un aggiornamento della versione principale da Amazon DocumentDB 5.0 a 8.0, le seguenti funzionalità sono abilitate o modificate:
-
Collazione. Amazon DocumentDB 8.0 supporta la collazione. Dopo l'aggiornamento, per le nuove raccolte e i relativi indici e per i nuovi indici sulle raccolte esistenti, le regole di confronto sono abilitate per impostazione predefinita.
-
Indice di testo. I nuovi indici di testo vengono creati utilizzando Text Index V2, che utilizza un parser di ricerca di testo aggiornato per una migliore compatibilità con MongoDB. Gli indici di testo esistenti non vengono modificati.
-
Versione del pianificatore di query. Se non disponevi di un gruppo di parametri personalizzato, viene creato un nuovo gruppo di parametri predefinito per Amazon DocumentDB 8.0 con Planner versione 3 selezionato automaticamente. Con la versione 3 di Query Planner, sono disponibili anche le visualizzazioni.
-
Compressione. Amazon DocumentDB 8.0 supporta la compressione di documenti basata su dizionari utilizzando l'algoritmo Zstd. Dopo l'aggiornamento, vengono create nuove raccolte con la compressione Zstd abilitata per impostazione predefinita. Le raccolte esistenti a partire dalla versione 5.0 mantengono le impostazioni di compressione. Per sfruttare la compressione Zstd sulle raccolte esistenti, puoi modificarne le impostazioni di compressione. Per ulteriori informazioni, consultate la sezione Dictionary-based compressione.
-
Ricostruzione dell'indice. Se si esegue l'aggiornamento da Amazon DocumentDB 5.0 ad Amazon DocumentDB 8.0, non è necessaria la ricostruzione dell'indice.
Nota
Per un elenco completo delle differenze funzionali, consulta. Compatibilità di Amazon DocumentDB con MongoDB
Post-upgrade considerazioni per i cluster aggiornati dalla versione 3.6 o 4.0
-
Ricostruzione dell'indice. Un MVU mantiene gli indici originali. Amazon DocumentDB 5.0 ha migliorato la manutenzione degli indici e la raccolta dei rifiuti, in particolare per gli indici a bassa cardinalità. Dopo l'aggiornamento dalla versione 3.6 o 4.0, consigliamo di ricostruire gli indici per garantire prestazioni ottimali delle query (facoltativo, comporta ulteriori operazioni). I/O Per informazioni, consulta Manutenzione dell'indice utilizzando reIndex.
-
Confronto numerico tra sottodocumenti (solo 3.6). I cluster aggiornati dalla versione 3.6 ereditano il comportamento 3.6 in base al quale i tipi numerici nei documenti secondari non vengono confrontati tra i tipi. Ad esempio,
{a: {b: NumberLong(1)}}non è uguale{a: {b: 1}}nella versione 3.6, ma è uguale nella versione 4.0 e versioni successive. Questo comportamento influisce su tutti i cluster aggiornati dalla versione 3.6.
Esecuzione dell'aggiornamento
Risoluzione dei problemi
Errore di aggiornamento e rollback. Se l'aggiornamento fallisce, tenta automaticamente di eseguire il rollback. Un rollback riuscito genera l'evento: «Il cluster di database si trova in uno stato che non può essere aggiornato». Il cluster torna allo stato precedente all'aggiornamento ed è possibile continuare a utilizzarlo. Contatta l' AWS assistenza per risolvere i problemi prima di riprovare.
Post-upgrade prestazioni. Durante l'aggiornamento dei metadati dell'indice possono verificarsi un temporaneo peggioramento delle prestazioni e un elevato utilizzo della CPU. Se il degrado persiste oltre le 3 ore, contatta l'assistenza. AWS
Per ulteriore assistenza, contatta l'AWS assistenza
