Miglioramenti Difetti corretti Versioni del linguaggio di query supportate Percorsi di aggiornamento Aggiornamento

Motore Amazon Neptune versione 1.1.1.0.R6 (23/09/2022)

A partire dal 23 gennaio 2023, viene implementata a livello generale la versione del motore 1.1.1.0.R6. Tieni presente che occorrono diversi giorni prima che una nuova versione diventi disponibile in ogni regione.

Importante

L'aggiornamento a questo rilascio del motore da una versione precedente alla 1.1.0.0 attiva anche un aggiornamento del sistema operativo su tutte le istanze del cluster database. Poiché le richieste di scrittura attive che si verificano durante l'aggiornamento del sistema operativo non vengono elaborate, è necessario sospendere tutti i carichi di lavoro in scrittura sul cluster da aggiornare, compresi i caricamenti di dati in blocco, prima di avviare l'aggiornamento.

Per completare correttamente l'aggiornamento, ogni sottorete in ciascuna zona di disponibilità (AZ) deve avere almeno un indirizzo IP disponibile per ogni istanza di Neptune. Ad esempio, se ci sono un'istanza di scrittura e due istanze di lettura nella sottorete 1 e due istanze di lettura nella sottorete 2, la sottorete 1 deve avere almeno 3 indirizzi IP liberi e la sottorete 2 deve avere almeno 2 indirizzi IP liberi prima di avviare l'aggiornamento.

All'inizio dell'aggiornamento, Neptune genera uno snapshot con un nome composto da preupgrade seguito da un identificatore generato automaticamente in base alle informazioni del cluster database. Per lo snapshot non ti verrà addebitato alcun costo e potrai utilizzarlo per ripristinare il cluster database in caso di problemi durante il processo di aggiornamento.

La nuova versione del motore (una volta completato il relativo aggiornamento) rimane disponibile per un breve periodo di tempo sul vecchio sistema operativo, ma in meno di 5 minuti tutte le istanze del cluster avviano contemporaneamente un aggiornamento del sistema operativo. A questo punto, il cluster database non sarà disponibile per alcuni minuti. Puoi riprendere i carichi di lavoro in scrittura al termine dell'aggiornamento.

Questo processo genera i seguenti eventi:

Messaggi di evento per cluster:
- Upgrade in progress: Creating pre-upgrade snapshot [preupgrade-(autogenerated snapshot ID)]
- Database cluster major version has been upgraded
Messaggi di evento per istanza:
- Applying off-line patches to DB instance
- DB instance shutdown
- Finished applying off-line patches to DB instance
- DB instance restarted

Nota

In questo rilascio è presente una modifica radicale per il codice che usa openCypher con autenticazione IAM. Finora, la stringa host nella firma IAM includeva il protocollo, come bolt://, ad esempio:


"Host":"bolt://(host URL):(port)"

A partire dal rilascio del motore 1.1.1.0, il protocollo deve essere omesso:


"Host":"(host URL):(port)"

Per esempi, consulta Utilizzo del protocollo Bolt.

Miglioramenti in questo rilascio del motore

Sono state migliorate le prestazioni delle query order-by Gremlin. Le query Gremlin con order-by al termine di un NeptuneGraphQueryStep ora utilizzano blocchi di dimensioni superiori per prestazioni migliori. Questo non si applica a order-by in un nodo interno (non root) del piano di query.
Sono state migliorate le prestazioni delle query di aggiornamento Gremlin. I vertici e gli archi devono ora essere bloccati per impedirne l'eliminazione durante l'aggiunta di archi o proprietà. Questa modifica elimina i blocchi duplicati all'interno di una transazione, migliorando così le prestazioni.

Difetti corretti in questa versione del motore

È stato corretto un bug di openCypher nella clausola MERGE che in alcuni casi causava la creazione di nodi e archi duplicati.
È stato corretto un bug nella gestione delle query di SPARQL che contengono (NOT) EXISTS all'interno di una clausola OPTIONAL, a causa del quale in qualche caso mancavano alcuni risultati delle query.
È stato corretto un bug che ritardava il riavvio del server quando era in corso un caricamento in blocco.
È stato corretto un bug a causa del quale l'attraversamento bidirezionale di un modello a lunghezza variabile openCypher con un filtro sulla proprietà di relazione causava un errore. Un esempio di tale modello a lunghezza variabile è (n)-[r*1..2]->(m).
È stato corretto un bug relativo al modo in cui i dati memorizzati nella cache vengono inviati nuovamente al client, che in alcuni casi provocava una latenza inaspettatamente lunga.

Versioni di linguaggio di query supportate in questo rilascio

Prima di aggiornare un cluster database alla versione 1.1.1.0.R6, assicurati che il tuo progetto sia compatibile con queste versioni di linguaggio di query:

Versione meno recente di Gremlin supportata: 3.5.2
Versione più recente di Gremlin supportata: 3.5.4
Versione openCypher: Neptune-9.0.20190305-1.0
Versione di SPARQL: 1.1

Percorsi di aggiornamento al rilascio del motore 1.1.1.0.R6

Se si esegue la versione del motore 1.1.1.0, il cluster verrà aggiornato automaticamente a questa patch release durante la finestra di manutenzione successiva.

Aggiornamento a questo rilascio

Importante

L'aggiornamento a questo rilascio del motore da qualsiasi versione precedente alla 1.1.0.0 attiva anche un aggiornamento del sistema operativo su tutte le istanze del cluster database. Poiché le richieste di scrittura attive che si verificano durante l'aggiornamento del sistema operativo non vengono elaborate, è necessario sospendere tutti i carichi di lavoro in scrittura sul cluster da aggiornare, compresi i caricamenti di dati in blocco, prima di avviare l'aggiornamento.

La nuova versione del motore (una volta completato il relativo aggiornamento) rimane disponibile per un breve periodo di tempo sul vecchio sistema operativo, ma in meno di 5 minuti tutte le istanze del cluster avviano contemporaneamente un aggiornamento del sistema operativo. A questo punto, il cluster database non sarà disponibile per circa 6 minuti. Puoi riprendere i carichi di lavoro in scrittura al termine dell'aggiornamento.

Questo processo genera i seguenti eventi:

Messaggi di evento per cluster:
- Upgrade in progress: Creating pre-upgrade snapshot [preupgrade-(autogenerated snapshot ID)]
- Database cluster major version has been upgraded
Messaggi di evento per istanza:
- Applying off-line patches to DB instance
- DB instance shutdown
- Finished applying off-line patches to DB instance
- DB instance restarted

Se un cluster database utilizza una versione del motore dalla quale esiste un percorso di aggiornamento a questo rilascio, ora è idoneo all'aggiornamento. È possibile aggiornare qualsiasi cluster idoneo utilizzando le operazioni del cluster database sulla console o utilizzando SDK. Il seguente comando CLI aggiornerà immediatamente un cluster idoneo:

Per Linux, OS X o Unix:


aws neptune modify-db-cluster \
    --db-cluster-identifier (your-neptune-cluster) \
    --engine-version 1.1.1.0 \
    --apply-immediately

Per Windows:


aws neptune modify-db-cluster ^
    --db-cluster-identifier (your-neptune-cluster) ^
    --engine-version 1.1.1.0 ^
    --apply-immediately

Gli aggiornamenti vengono applicati contemporaneamente a tutte le istanze in un cluster di database. Un aggiornamento richiede il riavvio del database su queste istanze, quindi si verificheranno tempi di inattività che vanno da 20-30 secondi a diversi minuti, dopodiché si potrà riprendere a usare il cluster database.

Eseguire sempre un test prima dell'aggiornamento

Quando viene rilasciata una nuova versione principale o secondaria del motore Neptune, testa sempre le applicazioni Neptune su di essa prima di procedere all'aggiornamento. Anche un aggiornamento secondario potrebbe introdurre nuove funzionalità o comportamenti che possono influire sul codice.

Inizia confrontando le pagine delle note di rilascio della versione corrente con quelle della versione di destinazione per valutare se verranno modificate le versioni del linguaggio di query o verranno introdotte altre modifiche che causano interruzioni.

Il modo migliore per testare una nuova versione prima di aggiornare il cluster database di produzione è clonare il cluster di produzione affinché il clone esegua la nuova versione del motore. È quindi possibile eseguire query sul clone senza influire sul cluster database di produzione.

Creare sempre uno snapshot manuale prima dell'aggiornamento

Prima di procedere a un aggiornamento, è consigliabile creare sempre uno snapshot manuale del cluster database. Uno snapshot automatico offre solo una protezione a breve termine, mentre uno snapshot manuale rimane disponibile fino a quando non lo elimini esplicitamente.

In alcuni casi Neptune crea automaticamente uno snapshot manuale come parte del processo di aggiornamento, ma non è consigliabile farvi affidamento ed è comunque opportuno creare sempre il proprio snapshot manuale.

Quando hai la certezza che non sarà necessario ripristinare lo stato precedente all'aggiornamento del cluster di database, puoi eliminare in modo esplicito lo snapshot manuale che hai creato, così come lo snapshot manuale eventualmente creato da Neptune. Se Neptune crea uno snapshot manuale, questo avrà un nome che inizia con preupgrade, seguito dal nome del cluster database, dalla versione del motore di origine, dalla versione del motore di destinazione e dalla data.

Nota

Se stai tentando di eseguire l'aggiornamento mentre è in corso un'azione in sospeso, potrebbe verificarsi un errore come il seguente:


   We're sorry, your request to modify DB cluster (cluster identifier) has failed.
   Cannot modify engine version because instance (instance identifier) is
   running on an old configuration. Apply any pending maintenance actions on the instance before
   proceeding with the upgrade.

Se riscontri questo errore, attendi il completamento dell'azione in sospeso o attiva immediatamente una finestra di manutenzione per completare l'aggiornamento precedente.

Per ulteriori informazioni sull'aggiornamento della versione del motore, consulta Gestione del cluster di database Amazon Neptune. In caso di domande o dubbi, il team del supporto AWS è disponibile nei forum della community e tramite il Supporto AWS Premium.

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

Rilascio: 1.1.1.0.R7 (23/01/2023)

Rilascio: 1.1.1.0.R5 (21/07/2022)