Motore Amazon Neptune versione 1.0.4.1 (08/12/2020)

A partire dall'08 dicembre 2020, viene implementata a livello generale la versione del motore 1.0.4.1. Tieni presente che occorrono diversi giorni prima che una nuova versione diventi disponibile in ogni regione.

Rilascio di patch successive per questa versione

• Rilascio: 1.0.4.1.R1.1 (22/03/2021)

• Rilascio: 1.0.4.1.R2 (24/02/2021)

  Importante

  Rilascio: 1.0.4.0 (12/10/2020) ha reso TLS 1.2 e HTTPS obbligatori per tutte le connessioni ad Amazon Neptune. Tuttavia, un bug presente in quel rilascio ha consentito alle connessioni HTTP e/o alle connessioni TLS obsolete di continuare a funzionare per i clienti che in precedenza avevano impostato un parametro del cluster database per impedire l'imposizione di connessioni HTTPS.

  Questo bug è stato corretto nei rilasci di patch 1.0.4.0.R2 e 1.0.4.1.R2, ma la correzione ha causato errori di connessione imprevisti quando le patch vengono installate automaticamente. Per questo motivo, entrambe le patch sono state ripristinate e possono essere installate solo manualmente, per darti la possibilità di aggiornare la configurazione per TLS 1.2.

  L'uso di SSL/TLS per tutte le connessioni a Neptune influisce sulle connessioni con la console di Gremlin, il driver di Gremlin, Gremlin Python, .NET, Node.js, le REST API e anche le connessioni del sistema di bilanciamento del carico. Se fino ad ora hai utilizzato HTTP o una versione TLS precedente per alcune o tutte queste versioni, devi aggiornare il client e i driver pertinenti e modificare il codice per utilizzare esclusivamente HTTPS prima di aggiornare il sistema alle patch più recenti.

Nuove caratteristiche in questa versione del motore

• È stata introdotta la funzionalità Neptune ML, che offre potenti funzionalità di machine learning ad Amazon Neptune. Per informazioni, consultare Amazon Neptune ML per machine learning sui grafi.

• È stata aggiunta un'operazione UNLOAD di SPARQL personalizzata per rimuovere i dati recuperati da una fonte remota. Per informazioni, consultare SPARQL UPDATE UNLOAD.

Miglioramenti in questo rilascio del motore

• Sono stati ottimizzati alcuni modelli di inserimento condizionale di Gremlin per evitare eccezioni di modifica simultanea.

Difetti corretti in questa versione del motore

• Corretto un bug di Gremlin che poteva causare la mancanza di risultati per uno specifico modello di query che utilizzava il passaggio as().

• Corretto un bug di Gremlin che poteva causare errori quando si utilizzava il passaggio project() nidificato all'interno di un altro passaggio, ad esempio union().

• Corretto un bug di Gremlin nel passaggio project().

• Corretto un bug di Gremlin basato su attraversamenti di stringhe per cui il passaggio none() non funziona.

• Corretto un bug di Gremlin basato su attraversamenti di stringhe per cui una mappa vuota non viene supportata come argomentativo del passaggio inject().

• Corretto bug di Gremlin basato sull'esecuzione di attraversamenti di stringhe nel motore DFE, a causa del quale un metodo terminale come toList() non funzionava correttamente.

• Corretto un bug di Gremlin che impediva la chiusura delle transazioni che utilizzavano il passaggio iterate() nella query String.

• Corretto un bug di Gremlin che poteva far sì che le query che utilizzavano il pattern is(P.gte(0)) generassero un'eccezione in alcune situazioni.

• Corretto un bug di Gremlin che poteva far sì che le query che utilizzavano il pattern order().by(T.id) generassero un'eccezione in alcune situazioni.

• Corretto un bug di Gremlin che poteva far sì che le query che utilizzavano il pattern addV().aggregate() fornissero risultati errati in alcune situazioni.

• Corretto un bug di Gremlin che poteva far sì che le query che utilizzavano il passaggio path() seguito dallo schema del passaggio project() generassero un'eccezione in alcune situazioni.

• Corretto un bug di SPARQL in cui la funzione SUBSTR segnala un errore anziché restituire una stringa vuota.

• Corretto un bug nel motore DFE che poteva far sì che le operazioni di join nei piani di query non bloccanti generassero risultati errati in presenza di variabili non associate.

Versioni di linguaggio di query supportate in questo rilascio

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

• Versione di Gremlin: 3.4.8

• Versione di SPARQL: 1.1

Percorsi di aggiornamento al rilascio del motore 1.0.4.1

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

È possibile aggiornare manualmente qualsiasi rilascio del motore Neptune precedente a questo rilascio.

Aggiornamento a questo rilascio

Amazon Neptune 1.0.4.1 è ora disponibile a livello generale.

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.0.4.1 \
    --apply-immediately

Per Windows:

aws neptune modify-db-cluster ^
    --db-cluster-identifier (your-neptune-cluster) ^
    --engine-version 1.0.4.1 ^
    --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.