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à.
# Motore Amazon Neptune versione 1.0.2.1 (22/11/2019)
## Rilascio di patch successive per questa versione
+ [Rilascio: 1.0.2.1.R6 (22/04/2020)](engine-releases-1.0.2.1.R6.md)
+ [Rilascio: 1.0.2.1.R5 (22/04/2020)](engine-releases-1.0.2.1.R5.md) *Questa versione di patch non è stata distribuita.*
+ [Rilascio: 1.0.2.1.R4 (20/12/2019)](engine-releases-1.0.2.1.R4.md)
+ [Rilascio: 1.0.2.1.R3 (12/12/2019)](engine-releases-1.0.2.1.R3.md)
+ [Rilascio: 1.0.2.1.R2 (25/11/2019)](engine-releases-1.0.2.1.R2.md)
## Nuove caratteristiche in questo rilascio del motore
+ Aggiunte funzionalità di ricerca di testo completo tramite l'integrazione con il OpenSearch servizio Amazon. Per informazioni, consultare [Ricerca full-text di Neptune](full-text-search.md).
+ Aggiunta l'opzione che utilizza la modalità di laboratorio per creare un quarto indice (un indice OSGP) per un numero elevato di predicati. Consultare [Indice OSGP](features-lab-mode.md#features-lab-mode-features-osgp-index).
+ Aggiunta una modalità *dettagli* a SPARQL Explain. Consultare [Usare SPARQL `explain`](sparql-explain-using.md) e [Output con modalità dettagli](sparql-explain-examples.md#sparql-explain-example-details) per i dettagli.
+ Aggiunte le informazioni sulla modalità di laboratorio al report sullo stato del motore. Per informazioni dettagliate, vedi [Stato dell'istanza](access-graph-status.md).
+ Le istantanee di DB Cluster possono ora essere copiate tra le regioni. AWS Consultare [Copia di uno snapshot](backup-restore-copy-snapshot.md).
## Miglioramenti in questo rilascio del motore
+ Miglioramento delle prestazioni durante la gestione di un numero elevato di predicati.
+ Ottimizzazione avanzata delle query. Anche se questo dovrebbe essere completamente trasparente per i clienti, ti invitiamo a testare le tue applicazioni prima di eseguire l'aggiornamento per assicurarti che si comportino come previsto.
+ Piccoli miglioramenti alla segnalazione degli errori.
+ Aggiunte ottimizzazioni per le fasi Gremlin `.project()` e `.identity()`.
+ Aggiunte ottimizzazioni per i casi `.union()` Gremlin non terminali.
+ Aggiunto il supporto nativo per gli attraversamenti `.path().by()` di Gremlin.
+ Aggiunto il supporto nativo per `.coalesce()` di Gremlin.
+ Ulteriore ottimizzazione della scrittura di massa.
+ Ora richiediamo che le connessioni HTTPS utilizzino almeno la versione TLS 1.2 o successiva, per impedire l'uso di codici outdated/insecure .
## Difetti corretti in questo rilascio del motore
+ Corretto un bug di gestione dell'attraversamento interno `addE()` di Gremlin.
+ Corretto un bug di Gremlin causato dalle annotazioni AST che vengono perse durante gli attraversamenti da figlio a padre.
+ Corretto un bug che si verificava in Gremlin quando `.otherV()` veniva richiamato dopo `select()`.
+ Corretto un bug di Gremlin che causava l'errore di alcune fasi `.hasLabel()` se apparivano dopo una fase `bothE()`.
+ Sono state apportate correzioni minori per .sum () e .project () di Gremlin.
+ Corretto un bug nell'elaborazione delle query SPARQL senza parentesi graffa di chiusura.
+ Corretti alcuni bug minori in SPARQL Explain.
+ Corretto un bug nella gestione di richieste simultanee di stato di caricamento.
+ Ridotta la memoria utilizzata per eseguire alcuni attraversamenti con le fasi `.project()` di Gremlin.
+ Corretti i confronti numerici di valori speciali in SPARQL. Consultare [Conformità agli standard](feature-overview-standards-compliance.md).
## Versioni di linguaggio di query supportate in questo rilascio
Prima di aggiornare un cluster database alla versione 1.0.2.1, assicurati che il tuo progetto sia compatibile con queste versioni di linguaggio di query:
+ *Versione di Gremlin:* `3.4.1`
+ *Versione di SPARQL:* `1.1`
## Percorsi di aggiornamento al rilascio del motore 1.0.2.1
È possibile aggiornare manualmente qualsiasi rilascio del motore Neptune precedente a questo rilascio.
Non \$1possibile effettuare l'aggiornamento automatico a questa versione.
## Aggiornamento a questo rilascio
Amazon Neptune 1.0.2.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:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.0.2.1 \
4. --apply-immediately
```
Per Windows:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.0.2.1 ^
4. --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](manage-console-maintaining), 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](cluster-maintenance.md). In caso di domande o dubbi, il team di AWS supporto è disponibile nei forum della community e tramite [AWS Premium Support](https://aws.amazon.com/support).
# Motore Amazon Neptune versione 1.0.2.1.R6 (22/04/2020)
A partire dal 22 aprile 2020, viene implementata a livello generale la versione del motore 1.0.2.1.R6. Tieni presente che occorrono diversi giorni prima che una nuova versione diventi disponibile in ogni regione.
## Difetti corretti in questo rilascio del motore
+ Corretto un bug in cui `ConcurrentModificationConflictException` e `TransactionException` non venivano convertite in un'`NeptuneGremlinException`, che causava la restituzione di `InternalFailureException` ai clienti.
+ Corretto un bug per il quale Neptune segnalava il suo stato come integro prima che il server fosse completamente pronto.
+ Risolto un problema per cui i commit del dizionario e delle transazioni dell'utente erano fuori uso quando due mappature `value->id` venivano inserite contemporaneamente.
+ Risolto un bug nella serializzazione dello stato di caricamento.
+ Corretto un bug di sessioni di Gremlin.
+ Corretto un bug per cui Neptune non riusciva a generare un'eccezione quando il server non riusciva ad avviarsi.
+ Corretto un bug a causa del quale Neptune non riusciva a inviare un frame di chiusura WebSocket prima di chiudere il canale.
## Versioni di linguaggio di query supportate in questo rilascio
Prima di aggiornare un cluster database alla versione 1.0.2.1.R6, assicurati che il tuo progetto sia compatibile con queste versioni di linguaggio di query:
+ *Versione di Gremlin:* `3.4.1`
+ *Versione di SPARQL:* `1.1`
## Percorsi di aggiornamento al rilascio del motore 1.0.2.1.R6
Se si esegue la versione del motore `1.0.2.1`, il cluster verrà aggiornato automaticamente a questo rilascio di patch 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.2.1.R6 è 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:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.0.2.1 \
4. --apply-immediately
```
Per Windows:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.0.2.1 ^
4. --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](manage-console-maintaining), 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](cluster-maintenance.md). In caso di domande o dubbi, il team di AWS supporto è disponibile nei forum della community e tramite [AWS Premium Support](https://aws.amazon.com/support).
# Motore Amazon Neptune versione 1.0.2.1.R5 (22/04/2020)
Il rilascio 1.0.2.1.R5 del motore non è mai stato implementato.
# Motore Amazon Neptune versione 1.0.2.1.R4 (20/12/2019)
## Miglioramenti in questo rilascio del motore
+ Neptune ora cerca sempre di inserire full-text-search ogni chiamata per prima nella pipeline di esecuzione. Ciò riduce il volume delle chiamate a OpenSearch, il che può migliorare significativamente le prestazioni. Consultare [Full-text-search esecuzione di interrogazioni](full-text-search-query-execution.md).
+ Neptune ora genera un'`IllegalArgumentException` se si tenta di accedere a una proprietà inesistente, vertice o edge. In precedenza, Neptune ha sollevato un'`UnsupportedOperationException` in quella situazione.
Ad esempio, se si tenta di aggiungere un edge che fa riferimento a un vertice inesistente, ora si solleva un `IllegalArgumentException`.
## Difetti corretti in questo rilascio del motore
+ Corretto un bug Gremlin in cui un attraversamento `union` all'interno di un `project-by` non restituisce risultati o restituisce risultati errati.
+ Corretto un bug di Gremlin che causava passaggi nidificati `.project().by()` per restituire risultati non corretti.
## Versioni di linguaggio di query supportate in questo rilascio
Prima di aggiornare un cluster database alla versione 1.0.2.1.R4, assicurati che il tuo progetto sia compatibile con queste versioni di linguaggio di query:
+ *Versione di Gremlin:* `3.4.1`
+ *Versione di SPARQL:* `1.1`
## Percorsi di aggiornamento al rilascio del motore 1.0.2.1.R4
È possibile aggiornare manualmente qualsiasi rilascio del motore Neptune precedente a questo rilascio.
Tuttavia, **l'aggiornamento automatico a questa versione non è supportato**.
## Aggiornamento a questo rilascio
Amazon Neptune 1.0.2.1.R4 è 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:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.0.2.1 \
4. --apply-immediately
```
Per Windows:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.0.2.1 ^
4. --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](manage-console-maintaining), 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](cluster-maintenance.md). In caso di domande o dubbi, il team di AWS supporto è disponibile nei forum della community e tramite [AWS Premium Support](https://aws.amazon.com/support).
# Motore Amazon Neptune versione 1.0.2.1.R3 (12/12/2019)
## Difetti corretti in questo rilascio del motore
+ Corretto un bug in cui l'indice `OSGP` era disabilitato anche se la funzione era correttamente abilitata in [Modalità di laboratorio](features-lab-mode.md) utilizzando il valore `ObjectIndex` nel parametro `neptune_lab_mode`.
+ Corretto un bug che interessava le query Gremlin con `.fold()` all'interno di una fase `.project().by()`. A causa di ciò, ad esempio, la seguente query ha restituito risultati incompleti:
```
g.V().project("a").by(valueMap().fold())
```
+ Corretto un collo di bottiglia delle prestazioni nei caricamenti in blocco di dati RDF.
+ Corretto un bug che causava un arresto anomalo delle repliche quando i flussi erano abilitati e la replica veniva riavviata prima della primaria.
+ Corretto un bug in cui i certificati SSL ruotati sulle istanze non venivano prelevati senza un riavvio dell'istanza.
## Versioni di linguaggio di query supportate in questo rilascio
Prima di aggiornare un cluster database alla versione 1.0.2.1.R3, assicurati che il tuo progetto sia compatibile con queste versioni di linguaggio di query:
+ *Versione di Gremlin:* `3.4.1`
+ *Versione di SPARQL:* `1.1`
## Percorsi di aggiornamento al rilascio del motore 1.0.2.1.R3
È possibile aggiornare manualmente qualsiasi rilascio del motore Neptune precedente a questo rilascio.
Tuttavia, **l'aggiornamento automatico a questa versione non è supportato**.
## Aggiornamento a questo rilascio
Amazon Neptune 1.0.2.1.R3 è 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:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.0.2.1 \
4. --apply-immediately
```
Per Windows:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.0.2.1 ^
4. --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](manage-console-maintaining), 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](cluster-maintenance.md). In caso di domande o dubbi, il team di AWS supporto è disponibile nei forum della community e tramite [AWS Premium Support](https://aws.amazon.com/support).
# Motore Amazon Neptune versione 1.0.2.1.R2 (25/11/2019)
## Difetti corretti in questo rilascio del motore
+ Risolto un bug che interessava tutte le query `project().by()` non round-robin by-traversal e `path()` non-by-traversal.
## Versioni di linguaggio di query supportate in questo rilascio
Prima di aggiornare un cluster database alla versione 1.0.2.1.R2, assicurati che il tuo progetto sia compatibile con queste versioni di linguaggio di query:
+ *Versione di Gremlin:* `3.4.1`
+ *Versione di SPARQL:* `1.1`
## Percorsi di aggiornamento al rilascio del motore 1.0.2.1.R2
È possibile aggiornare manualmente qualsiasi rilascio del motore Neptune precedente a questo rilascio.
Tuttavia, **l'aggiornamento automatico a questa versione non è supportato**.
## Aggiornamento a questo rilascio
Amazon Neptune 1.0.2.1.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:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.0.2.1 \
4. --apply-immediately
```
Per Windows:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.0.2.1 ^
4. --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](manage-console-maintaining), 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](cluster-maintenance.md). In caso di domande o dubbi, il team di AWS supporto è disponibile nei forum della community e tramite [AWS Premium Support](https://aws.amazon.com/support).