Motore Amazon Neptune versione 1.0.4.2.R2 (01/06/2021)

A partire dal 1° giugno 2021, viene implementata a livello generale la versione del motore 1.0.4.2.R2. 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.2.R3 (28/06/2021)

Problemi noti in questo rilascio del motore

Problema:

Un bug di SPARQL che non rispetta il tipo di supporto in un'intestazione Accept se sono presenti spazi.

Ad esempio, una query con -H "Accept: text/csv; q=1.0, */*; q=0.1" restituisce un output JSON anziché un output CSV.

Soluzione alternativa:

Se rimuovi gli spazi nella clausola Accept nell'intestazione, il motore restituisce l'output nel corretto formato richiesto. In altre parole, anziché -H "Accept: text/csv; q=1.0, */*; q=0.1" , usa:

  -H "Accept: text/csv;q=1.0,*/*;q=0.1"

Nuove caratteristiche in questa versione del motore

• Aggiunto il nuovo tipo di istanza R5d, che include una cache di ricerca per velocizzare le letture nei casi d'uso che coinvolgono un volume elevato di valori di proprietà o ricerche letterali RDF. Per informazioni, consultare La cache di ricerca di Neptune può accelerare le query di lettura.

• Aggiunto un nuovo parametro lab-mode che consente di richiamare il motore DFE sperimentale solo per ogni query con l'hint useDFE.

Miglioramenti in questo rilascio del motore

• Aggiunto il supporto per TinkerPop 3.4.10.

• Aggiunto il supporto per l'utilizzo del passaggio di configurazione withStrategies( ) durante l'invio di richieste di script di Gremlin. Nello specifico, SubgraphStrategy, PartitionStrategy, ReadOnlyStrategy, EdgeLabelVerificationStrategy, e ReservedKeysVerificationStrategy sono tutti supportati.

• Aggiunta l'ottimizzazione per gli attraversamenti V() durante una query. In precedenza, tali attraversamenti non erano ottimizzati su Neptune.

• Aggiunto il supporto per gli URN RFC 2141 da utilizzare come parametri baseUri e namedGraphUri per un caricamento in blocco.

Difetti corretti in questa versione del motore

• Corretto un bug di Gremlin nel parser in cui le query errate venivano considerate valide.

• Corretto un bug di Gremlin per cui la visualizzazione di un effetto collaterale aggregate() con cap().unfold() a un valueMap() generava un'eccezione.

• Corretto un bug di Gremlin a causa del quale alcuni passaggi property() dopo un passaggio addV() non riuscivano con l'errore "impossibile eseguire il cast su String".

• Corretto un bug di Gremlin che impediva ad alcuni schemi di inserimento condizionali di generare eccezioni di modifica simultanea.

• Corretto un bug di Gremlin in modo che il timeout della richiesta di query ora non possa superare il timeout della sessione.

• Corretto un bug di SPARQL a causa del quale gli aggiornamenti tramite LOAD o UNLOAD potevano non riuscire con un codice HTTP 500 anziché il codice HTTP 400 quando il server remoto non era disponibile.

• Corretto un bug a causa del quale le chiamate API di streaming non riuscivano quando venivano utilizzati valori commitNum o valori opNum superiori al limite di numeri interi segnati a 32 bit (2.147.483.647).

Versioni di linguaggio di query supportate in questo rilascio

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

• Versione di Gremlin: 3.4.10

• Versione di SPARQL: 1.1

Percorsi di aggiornamento al rilascio del motore 1.0.4.2.R2

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

Non +possibile effettuare l'aggiornamento automatico a questa versione.

Aggiornamento a questo rilascio

Amazon Neptune 1.0.4.2.R2 è 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.2 \
    --apply-immediately

Per Windows:

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