View a markdown version of this page

Amazon Neptune Engine versione 1.3.4.0 (2024-10-01) - Amazon Neptune
MiglioramentiDifetti corretti Query-Language Versioni supportatePercorsi di aggiornamentoAggiornamento

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à.

Amazon Neptune Engine versione 1.3.4.0 (2024-10-01)

A partire dal 2024-10-01, la versione del motore 1.3.4.0 viene generalmente distribuita. Tieni presente che occorrono diversi giorni prima che una nuova versione diventi disponibile in ogni regione.

Nota

La versione del motore 1.3.0.0 ha introdotto un nuovo formato per i gruppi di parametri personalizzati e i gruppi di parametri del cluster personalizzati. Di conseguenza, se si esegue l'aggiornamento da una versione del motore precedente alla 1.3.0.0 o successiva, è necessario ricreare tutti i gruppi di parametri personalizzati esistenti e i gruppi di parametri del cluster personalizzati utilizzando la famiglia di gruppi di parametri. neptune1.3 Le versioni precedenti utilizzavano la famiglia di gruppi di parametri neptune1 o neptune1.2 e tali gruppi di parametri non funzionano con la versione 1.3.0.0 e successive. Analogamente, è necessario utilizzare i gruppi di parametri del cluster 1.4.0.0 per le versioni del motore 1.4.0.0 e successive. Per ulteriori informazioni, consulta Gruppi di parametri di Amazon Neptune.

avvertimento

È stato rilevato un problema con le operazioni di aggiornamento di SPARQL 1.1 che può essere presente in determinate condizioni quando gli operatori di aggiornamento vengono utilizzati con politiche di autorizzazione basate su azioni. Se si utilizzano le operazioni di aggiornamento SPARQL 1.1 con politiche di autorizzazione basate sulle azioni, si consiglia di eseguire l'aggiornamento alla versione più recente del motore secondario di Neptune (almeno 1.3.4.0) che include una correzione per questo problema.

La cache del piano di interrogazione è stata temporaneamente disabilitata per le query parametrizzate che coinvolgono valori di parametri numerici a causa di un problema nella gestione degli utilizzi duplicati di un parametro di tipo numerico, come nella seguente query: 

MATCH (n:movie) WHERE n.runtime>=$minutes RETURN n 
UNION 
MATCH (n:show) WHERE n.duration>=$minutes RETURN n

parameters={"minutes":130}

Miglioramenti in questa versione del motore

  • È stato aggiunto il supporto per l'esecuzione dei passaggi Gremlin limit () negli attraversamenti annidati per il motore DFE.

  • Sono state aggiunte CloudWatch le metriche relative alla cache dei risultati di Gremlin, elencate di seguito, che possono essere utili per diagnosticare e regolare la latenza della cache dei risultati. Vedi Neptune Metrics per i dettagli. https://docs.aws.amazon.com/neptune/latest/userguide/cw-metrics.html#cw-metrics-available 

    NumResultCacheHit
NumResultCacheMiss
ResultCacheSizeInBytes
ResultCacheItemCount
ResultCacheOldestItemTimestamp
ResultCacheNewestItemTimestamp

Difetti corretti in questa versione del motore

Miglioramenti generali

  • È stato risolto un problema a causa del quale, in rari casi, il motore si bloccava invece di restituire un errore di interrogazione.

Correzioni Gremlin

  • Abbiamo migliorato la gestione delle richieste e la segnalazione degli errori quando un client o un proxy invia una richiesta di aggiornamento del websocket tramite una connessione established/used HTTP (in precedenza venivano restituite 400 risposte con l'errore «no gremlin script supplied, code MissingParameterException»).

  • È stata ottimizzata la gestione dei mergeV passaggi con aggiornamenti dei valori delle proprietà a cardinalità singola. Ad esempio, la query seguente è ora supportata in modo nativo in Neptune. 

    g.mergeV([(T.id): 1234]). option(onMatch, ['age': single(20), 'name': single('alice'), 'city': set('miami')])

  • È stato risolto un problema di valutazione delle query DFE di Gremlin che causava il fallimento delle query con un. InternalFailureException Questo errore si è verificato con alcuni modelli, select come mostrato nell'esempio seguente: 

    g.V("1").as("a").as("b").select("a","b").dedup()
Correzioni apportate a openCypher

  • È stato risolto un problema per cui collect(distinct()) l'esecuzione con valori nulli causava la restituzione di un errore.

  • È stato risolto un problema per cui l'esecuzione di una query con parametri contenente un filtro di intervallo (</<=/>/>= rispetto al valore del parametro) produceva risultati. duplicate/missing

  • È stato corretto un bug per cui il motore DFE produceva più output di quanto richiesto nelle query con limite, il che poteva causare errori di memoria insufficiente.

Correzioni apportate a SPARQL

  • È stato risolto un problema per cui l'esecuzione di una query di aggiornamento SPARQL federata su cluster abilitati all'autenticazione IAM causava la restituzione di un errore.

  • Sono state corrette le autorizzazioni basate sulle azioni per le operazioni di aggiornamento di SPARQL 1.1.

Query-Language Versioni supportate in questa release

Prima di aggiornare un cluster DB alla versione 1.3.4.0, assicurati che il tuo progetto sia compatibile con queste versioni in linguaggio di interrogazione:

  • Versione meno recente di Gremlin supportata: 3.7.1

  • Versione più recente di Gremlin supportata: 3.7.1

  • Versione openCypher: Neptune-9.0.20190305-1.0

  • Versione di SPARQL: 1.1

Percorsi di aggiornamento alla versione del motore 1.3.4.0

Puoi eseguire l'aggiornamento a questo rilascio dal rilascio del motore 1.2.0.0 o successivi.

Aggiornamento a questo rilascio

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.3.4.0 \
    --allow-major-version-upgrade \
    --apply-immediately

Per Windows:

aws neptune modify-db-cluster ^
    --db-cluster-identifier (your-neptune-cluster) ^
    --engine-version 1.3.4.0 ^
    --allow-major-version-upgrade ^
    --apply-immediately

Invece di --apply-immediately, puoi specificare --no-apply-immediately. Per eseguire un aggiornamento di versione principale, è richiesto il parametro allow-major-version-upgrade. Assicurati inoltre di includere la versione del motore onde evitare che il tuo motore venga aggiornato a una versione diversa.

Se il cluster utilizza un gruppo di parametri del cluster personalizzato, assicurati di includere questo parametro per specificarlo:

    --db-cluster-parameter-group-name (name of the custom DB cluster parameter group)

Analogamente, se alcune istanze del cluster utilizzano un gruppo di parametri del database personalizzato, assicurati di includere questo parametro per specificarlo:

    --db-instance-parameter-group-name (name of the custom instance parameter group)

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 di AWS supporto è disponibile nei forum della community e tramite AWS Premium Support.