As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Mecanismo do Amazon Neptune versão 1.0.2.1 (22/11/2019)
## Versões de patch subsequentes para esta versão
+ [Versão: 1.0.2.1.R6 (22/04/2020)](engine-releases-1.0.2.1.R6.md)
+ [Versão: 1.0.2.1.R5 (22/04/2020)](engine-releases-1.0.2.1.R5.md) *Esta versão de patch não foi implantada.*
+ [Versão: 1.0.2.1.R4 (20/12/2019)](engine-releases-1.0.2.1.R4.md)
+ [Versão: 1.0.2.1.R3 (12/12/2019)](engine-releases-1.0.2.1.R3.md)
+ [Versão: 1.0.2.1.R2 (25/11/2019)](engine-releases-1.0.2.1.R2.md)
## Novos recursos nesta versão do mecanismo
+ Adição de recursos de pesquisa de texto completo por meio da integração com o Amazon OpenSearch Service. Consulte [Pesquisa de texto completo do Neptune](full-text-search.md)
+ Adição da opção que usa o modo de laboratório para criar um quarto índice (um índice OSGP) para grandes números de predicados Consulte [Índice OSGP](features-lab-mode.md#features-lab-mode-features-osgp-index).
+ Adição de um modo de *detalhes* ao Explain do SPARQL. Consulte [Usar o SPARQL `explain`](sparql-explain-using.md) e [Saída do modo de detalhes](sparql-explain-examples.md#sparql-explain-example-details) para obter mais detalhes.
+ Adição de informações do modo de laboratório ao relatório de status do mecanismo. Para mais detalhes, consulte [Status de instância](access-graph-status.md).
+ Os snapshots de cluster de banco de dados agora podem ser copiados entre regiões da AWS. Consulte [Cópia de um snapshot](backup-restore-copy-snapshot.md).
## Melhorias nesta versão do mecanismo
+ Melhor desempenho ao lidar com um grande número de predicados.
+ Otimização de consulta aprimorada. Embora isso deva ser completamente transparente para os clientes, nós encorajamos você a testar os aplicativos antes de atualizá-los para garantir que eles se comportem conforme o esperado.
+ Pequenas melhorias no relatório de erros.
+ Adição de otimizações nas etapas `.project()` e `.identity()` do Gremlin.
+ Adição de otimizações nos casos não terminais `.union()` do Gremlin.
+ Adição de suporte nativo às travessias `.path().by()` do Gremlin.
+ Adição de suporte nativo ao do Gremlin `.coalesce()`.
+ Otimização adicional de gravação em massa.
+ Agora exigimos que as conexões HTTPS utilizem pelo menos a versão TLS 1.2 ou superior para evitar que codificações desatualizadas/não seguras sejam usadas.
## Defeitos corrigidos nesta versão do mecanismo
+ Correção de um erro ao lidar com a travessia `addE()` interna do Gremlin.
+ Correção de um bug do Gremlin causado pelo vazamento de anotações AST das travessias secundárias para a primária.
+ Correção de um bug que ocorria no Gremlin quando o `.otherV()` era chamado após o `select()`.
+ Correção de um bug que gerava falha em algumas etapas do `.hasLabel()` caso aparecessem após uma etapa do `bothE()`.
+ Pequenas correções do .sum() e .project() do Gremlin.
+ Correção de um bug no processamento de consultas SPARQL que não possuíam uma chave de fechamento.
+ Correção de alguns bugs pequenos no Explain do SPARQL.
+ Correção de um erro ao lidar com solicitações simultâneas para obter o status da carga.
+ Redução da memória usada para executar algumas travessias do Gremlin com as etapas do `.project()`.
+ Correção de comparações numéricas de valores especiais no SPARQL. Consulte [Conformidade com padrões](feature-overview-standards-compliance.md).
## Versões de linguagem de consulta compatíveis com esta versão
Antes de atualizar um cluster de banco de dados para a versão 1.0.2.1, assegure-se de que o projeto seja compatível com estas versões da linguagem de consulta:
+ *Gremlin versão:* `3.4.1`
+ *SPARQL versão:* `1.1`
## Caminhos de atualização para a versão 1.0.2.1 do mecanismo
É possível atualizar manualmente qualquer versão anterior do mecanismo do Neptune para esta versão.
Você não atualizará automaticamente para esta versão.
## Atualizar para esta versão
O Amazon Neptune 1.0.2.1 já está disponível ao público em geral.
Se um cluster de banco de dados estiver executando uma versão do mecanismo a partir da qual haja um caminho de atualização para essa versão, ele estará elegível para ser atualizado agora. Você pode atualizar qualquer cluster elegível usando as operações do cluster de banco de dados no console ou usando o SDK. O seguinte comando da CLI atualizará imediatamente um cluster elegível:
Para Linux, OS X ou Unix:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.0.2.1 \
4. --apply-immediately
```
Para Windows:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.0.2.1 ^
4. --apply-immediately
```
As atualizações são simultaneamente aplicadas a todas as instâncias em um cluster de banco de dados. Como as atualizações exigem a reinicialização do banco de dados nessas instâncias, ocorrerá um tempo de inatividade de vinte a trinta segundos a alguns minutos. Depois disso, você poderá retomar o uso do cluster de banco de dados.
### Sempre teste antes de fazer a atualização
Quando uma nova versão principal ou secundária do mecanismo do Neptune for lançada, sempre teste as aplicações do Neptune antes de atualizá-la. Mesmo uma atualização secundária pode introduzir novos atributos ou comportamentos que afetem o código.
Comece comparando as páginas de notas da versão atual com as da versão de destino para ver se haverá alterações nas versões da linguagem de consulta ou outras alterações importantes.
A melhor maneira de testar uma nova versão antes de atualizar o cluster de banco de dados de produção é clonar o cluster de produção para que o clone execute a nova versão do mecanismo. Depois, você pode executar consultas no clone sem afetar o cluster de banco de dados de produção.
### Sempre crie um snapshot manual antes de fazer a atualização
Antes de fazer uma atualização, é altamente recomendável sempre criar um snapshot manual do cluster de banco de dados. Ter um snapshot automático só oferece proteção de curto prazo, enquanto um snapshot manual permanece disponível até que você o exclua explicitamente.
Em determinados casos, o Neptune cria um snapshot manual para você como parte do processo de atualização, mas não confie nisso e, em qualquer caso, crie o próprio snapshot manual.
Quando você tiver certeza de que não precisará reverter o cluster de banco de dados para o estado de pré-atualização, poderá excluir explicitamente o snapshot manual criado, bem como o snapshot manual que o Neptune tenha criado. Se o Neptune criar um snapshot manual, ele terá um nome que começa com `preupgrade`, seguido pelo nome do cluster de banco de dados, a versão do mecanismo de origem, a versão do mecanismo de destino e a data.
**nota**
Se você estiver tentando atualizar com [uma ação pendente em andamento](manage-console-maintaining), poderá encontrar um erro como o seguinte:
```
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 você encontrar esse erro, aguarde a conclusão da ação pendente ou acione imediatamente uma janela de manutenção para permitir que a atualização anterior seja concluída.
Para obter mais informações sobre como atualizar a versão do mecanismo, consulte [Manter o cluster de banco de dados do Amazon Neptune](cluster-maintenance.md). Em caso de dúvidas ou preocupações, o AWS Support está disponível nos fóruns da comunidade e por meio do [AWS Premium Support](https://aws.amazon.com/support).
# Mecanismo do Amazon Neptune versão 1.0.2.1.R6 (22/04/2020)
Desde 22/04/2020, a versão 1.0.2.1.R6 do mecanismo está sendo implantada de forma geral. Observe que leva vários dias para que uma nova versão fique disponível em todas as regiões.
## Defeitos corrigidos nesta versão do mecanismo
+ Correção de um bug em que `ConcurrentModificationConflictException` e `TransactionException` não eram convertidos em um `NeptuneGremlinException`, fazendo com que `InternalFailureException` fosse retornado aos clientes.
+ Correção de um erro em que o Neptune relatava seu status como íntegro antes que o servidor estivesse completamente pronto.
+ Correção de um erro em que as confirmações de dicionário de transação do usuário ficavam fora de ordem quando dois mapeamentos `value->id` estavam sendo inseridos simultaneamente.
+ Correção de um bug na serialização de status de carregamento.
+ Correção de um bug de sessões do Gremlin.
+ Correção de um erro em que o Neptune não conseguia lançar uma exceção quando o servidor falhava ao iniciar.
+ Correção de um erro em que o Neptune não conseguia enviar um quadro de fechamento do WebSocket antes de fechar o canal.
## Versões de linguagem de consulta compatíveis com esta versão
Antes de atualizar um cluster de banco de dados para a versão 1.0.2.1.R6, assegure-se de que o projeto seja compatível com estas versões da linguagem de consulta:
+ *Gremlin versão:* `3.4.1`
+ *SPARQL versão:* `1.1`
## Caminhos de atualização para a versão 1.0.2.1.R6 do mecanismo
O cluster será atualizado com essa versão de patch automaticamente durante a próxima janela de manutenção se você estiver executando a versão do mecanismo `1.0.2.1`.
É possível atualizar manualmente qualquer versão anterior do mecanismo do Neptune para esta versão.
## Atualizar para esta versão
O Amazon Neptune 1.0.2.1.R6 já está disponível ao público em geral.
Se um cluster de banco de dados estiver executando uma versão do mecanismo a partir da qual haja um caminho de atualização para esta versão, ele estará elegível para ser atualizado agora. Você pode atualizar qualquer cluster elegível usando as operações do cluster de banco de dados no console ou usando o SDK. O seguinte comando da CLI atualizará imediatamente um cluster elegível:
Para Linux, OS X ou Unix:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.0.2.1 \
4. --apply-immediately
```
Para Windows:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.0.2.1 ^
4. --apply-immediately
```
As atualizações são simultaneamente aplicadas a todas as instâncias em um cluster de banco de dados. Como as atualizações exigem a reinicialização do banco de dados nessas instâncias, ocorrerá um tempo de inatividade de vinte a trinta segundos a alguns minutos. Depois disso, você poderá retomar o uso do cluster de banco de dados.
### Sempre teste antes de fazer a atualização
Quando uma nova versão principal ou secundária do mecanismo do Neptune for lançada, sempre teste as aplicações do Neptune antes de atualizá-la. Mesmo uma atualização secundária pode introduzir novos atributos ou comportamentos que afetem o código.
Comece comparando as páginas de notas da versão atual com as da versão de destino para ver se haverá alterações nas versões da linguagem de consulta ou outras alterações importantes.
A melhor maneira de testar uma nova versão antes de atualizar o cluster de banco de dados de produção é clonar o cluster de produção para que o clone execute a nova versão do mecanismo. Depois, você pode executar consultas no clone sem afetar o cluster de banco de dados de produção.
### Sempre crie um snapshot manual antes de fazer a atualização
Antes de fazer uma atualização, é altamente recomendável sempre criar um snapshot manual do cluster de banco de dados. Ter um snapshot automático só oferece proteção de curto prazo, enquanto um snapshot manual permanece disponível até que você o exclua explicitamente.
Em determinados casos, o Neptune cria um snapshot manual para você como parte do processo de atualização, mas não confie nisso e, em qualquer caso, crie o próprio snapshot manual.
Quando você tiver certeza de que não precisará reverter o cluster de banco de dados para o estado de pré-atualização, poderá excluir explicitamente o snapshot manual criado, bem como o snapshot manual que o Neptune tenha criado. Se o Neptune criar um snapshot manual, ele terá um nome que começa com `preupgrade`, seguido pelo nome do cluster de banco de dados, a versão do mecanismo de origem, a versão do mecanismo de destino e a data.
**nota**
Se você estiver tentando atualizar com [uma ação pendente em andamento](manage-console-maintaining), poderá encontrar um erro como o seguinte:
```
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 você encontrar esse erro, aguarde a conclusão da ação pendente ou acione imediatamente uma janela de manutenção para permitir que a atualização anterior seja concluída.
Para obter mais informações sobre como atualizar a versão do mecanismo, consulte [Manter o cluster de banco de dados do Amazon Neptune](cluster-maintenance.md). Em caso de dúvidas ou preocupações, o AWS Support está disponível nos fóruns da comunidade e por meio do [AWS Premium Support](https://aws.amazon.com/support).
# Mecanismo do Amazon Neptune versão 1.0.2.1.R5 (22/04/2020)
A versão 1.0.2.1.R5 do mecanismo nunca foi implantada.
# Mecanismo do Amazon Neptune versão 1.0.2.1.R4 (20/12/2019)
## Melhorias nesta versão do mecanismo
+ Agora, o Neptune sempre tenta colocar qualquer chamada de pesquisa de texto completo primeiro no pipeline de execução. Isso reduz o volume de chamadas para o OpenSearch, o que pode melhorar significativamente o desempenho. Consulte [Full-text-search execução da consulta](full-text-search-query-execution.md).
+ Agora, o Neptune lançará uma `IllegalArgumentException` se você tentar acessar um vértice, uma borda ou uma propriedade inexistente. Antes, o Neptune lançava uma `UnsupportedOperationException` nessa situação.
Por exemplo, se tentar adicionar uma borda fazendo referência a um vértice inexistente, agora você gerará um `IllegalArgumentException`.
## Defeitos corrigidos nesta versão do mecanismo
+ Correção de um bug do Gremlin em que uma travessia `union` dentro de um `project-by` não retorna resultados ou retorna resultados incorretos.
+ Correção de um bug do Gremlin que fazia com que as etapas `.project().by()` aninhadas retornassem resultados incorretos.
## Versões de linguagem de consulta compatíveis com esta versão
Antes de atualizar um cluster de banco de dados para a versão 1.0.2.1.R4, assegure-se de que o projeto seja compatível com estas versões da linguagem de consulta:
+ *Gremlin versão:* `3.4.1`
+ *SPARQL versão:* `1.1`
## Caminhos de atualização para a versão 1.0.2.1.R4 do mecanismo
É possível atualizar manualmente qualquer versão anterior do mecanismo do Neptune para esta versão.
No entanto, a **atualização automática para esta versão não é compatível**.
## Atualizar para esta versão
O Amazon Neptune 1.0.2.1.R4 já está disponível ao público em geral.
Se um cluster de banco de dados estiver executando uma versão do mecanismo a partir da qual haja um caminho de atualização para essa versão, ele estará elegível para ser atualizado agora. Você pode atualizar qualquer cluster elegível usando as operações do cluster de banco de dados no console ou usando o SDK. O seguinte comando da CLI atualizará imediatamente um cluster elegível:
Para Linux, OS X ou Unix:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.0.2.1 \
4. --apply-immediately
```
Para Windows:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.0.2.1 ^
4. --apply-immediately
```
As atualizações são simultaneamente aplicadas a todas as instâncias em um cluster de banco de dados. Como as atualizações exigem a reinicialização do banco de dados nessas instâncias, ocorrerá um tempo de inatividade de vinte a trinta segundos a alguns minutos. Depois disso, você poderá retomar o uso do cluster de banco de dados.
### Sempre teste antes de fazer a atualização
Quando uma nova versão principal ou secundária do mecanismo do Neptune for lançada, sempre teste as aplicações do Neptune antes de atualizá-la. Mesmo uma atualização secundária pode introduzir novos atributos ou comportamentos que afetem o código.
Comece comparando as páginas de notas da versão atual com as da versão de destino para ver se haverá alterações nas versões da linguagem de consulta ou outras alterações importantes.
A melhor maneira de testar uma nova versão antes de atualizar o cluster de banco de dados de produção é clonar o cluster de produção para que o clone execute a nova versão do mecanismo. Depois, você pode executar consultas no clone sem afetar o cluster de banco de dados de produção.
### Sempre crie um snapshot manual antes de fazer a atualização
Antes de fazer uma atualização, é altamente recomendável sempre criar um snapshot manual do cluster de banco de dados. Ter um snapshot automático só oferece proteção de curto prazo, enquanto um snapshot manual permanece disponível até que você o exclua explicitamente.
Em determinados casos, o Neptune cria um snapshot manual para você como parte do processo de atualização, mas não confie nisso e, em qualquer caso, crie o próprio snapshot manual.
Quando você tiver certeza de que não precisará reverter o cluster de banco de dados para o estado de pré-atualização, poderá excluir explicitamente o snapshot manual criado, bem como o snapshot manual que o Neptune tenha criado. Se o Neptune criar um snapshot manual, ele terá um nome que começa com `preupgrade`, seguido pelo nome do cluster de banco de dados, a versão do mecanismo de origem, a versão do mecanismo de destino e a data.
**nota**
Se você estiver tentando atualizar com [uma ação pendente em andamento](manage-console-maintaining), poderá encontrar um erro como o seguinte:
```
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 você encontrar esse erro, aguarde a conclusão da ação pendente ou acione imediatamente uma janela de manutenção para permitir que a atualização anterior seja concluída.
Para obter mais informações sobre como atualizar a versão do mecanismo, consulte [Manter o cluster de banco de dados do Amazon Neptune](cluster-maintenance.md). Em caso de dúvidas ou preocupações, o AWS Support está disponível nos fóruns da comunidade e por meio do [AWS Premium Support](https://aws.amazon.com/support).
# Mecanismo do Amazon Neptune versão 1.0.2.1.R3 (12/12/2019)
## Defeitos corrigidos nesta versão do mecanismo
+ Correção de um erro em que o índice `OSGP` era desabilitado mesmo que o recurso estivesse habilitado corretamente ao ser usado em [Modo de laboratório](features-lab-mode.md) com o valor `ObjectIndex` no parâmetro `neptune_lab_mode`.
+ Correção de um bug que afetava as consultas do Gremlin com um `.fold()` dentro de uma etapa do `.project().by()`. Por exemplo, gerou resultados incompletos para a consulta:
```
g.V().project("a").by(valueMap().fold())
```
+ Correção de um afunilamento de desempenho em carregamentos em massa de dados RDF.
+ Correção de um erro que gerava falha em réplicas quando os fluxos eram habilitados e a réplica era reiniciada antes da principal.
+ Correção de um bug no qual os certificados SSL alternados nas instâncias não eram coletados sem reiniciar a instância.
## Versões de linguagem de consulta compatíveis com esta versão
Antes de atualizar um cluster de banco de dados para a versão 1.0.2.1.R3, assegure-se de que o projeto seja compatível com estas versões da linguagem de consulta:
+ *Gremlin versão:* `3.4.1`
+ *SPARQL versão:* `1.1`
## Caminhos de atualização para a versão 1.0.2.1.R3 do mecanismo
É possível atualizar manualmente qualquer versão anterior do mecanismo do Neptune para esta versão.
No entanto, a **atualização automática para esta versão não é compatível**.
## Atualizar para esta versão
O Amazon Neptune 1.0.2.1.R3 já está disponível ao público em geral.
Se um cluster de banco de dados estiver executando uma versão do mecanismo a partir da qual haja um caminho de atualização para essa versão, ele estará elegível para ser atualizado agora. Você pode atualizar qualquer cluster elegível usando as operações do cluster de banco de dados no console ou usando o SDK. O seguinte comando da CLI atualizará imediatamente um cluster elegível:
Para Linux, OS X ou Unix:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.0.2.1 \
4. --apply-immediately
```
Para Windows:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.0.2.1 ^
4. --apply-immediately
```
As atualizações são simultaneamente aplicadas a todas as instâncias em um cluster de banco de dados. Como as atualizações exigem a reinicialização do banco de dados nessas instâncias, ocorrerá um tempo de inatividade de vinte a trinta segundos a alguns minutos. Depois disso, você poderá retomar o uso do cluster de banco de dados.
### Sempre teste antes de fazer a atualização
Quando uma nova versão principal ou secundária do mecanismo do Neptune for lançada, sempre teste as aplicações do Neptune antes de atualizá-la. Mesmo uma atualização secundária pode introduzir novos atributos ou comportamentos que afetem o código.
Comece comparando as páginas de notas da versão atual com as da versão de destino para ver se haverá alterações nas versões da linguagem de consulta ou outras alterações importantes.
A melhor maneira de testar uma nova versão antes de atualizar o cluster de banco de dados de produção é clonar o cluster de produção para que o clone execute a nova versão do mecanismo. Depois, você pode executar consultas no clone sem afetar o cluster de banco de dados de produção.
### Sempre crie um snapshot manual antes de fazer a atualização
Antes de fazer uma atualização, é altamente recomendável sempre criar um snapshot manual do cluster de banco de dados. Ter um snapshot automático só oferece proteção de curto prazo, enquanto um snapshot manual permanece disponível até que você o exclua explicitamente.
Em determinados casos, o Neptune cria um snapshot manual para você como parte do processo de atualização, mas não confie nisso e, em qualquer caso, crie o próprio snapshot manual.
Quando você tiver certeza de que não precisará reverter o cluster de banco de dados para o estado de pré-atualização, poderá excluir explicitamente o snapshot manual criado, bem como o snapshot manual que o Neptune tenha criado. Se o Neptune criar um snapshot manual, ele terá um nome que começa com `preupgrade`, seguido pelo nome do cluster de banco de dados, a versão do mecanismo de origem, a versão do mecanismo de destino e a data.
**nota**
Se você estiver tentando atualizar com [uma ação pendente em andamento](manage-console-maintaining), poderá encontrar um erro como o seguinte:
```
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 você encontrar esse erro, aguarde a conclusão da ação pendente ou acione imediatamente uma janela de manutenção para permitir que a atualização anterior seja concluída.
Para obter mais informações sobre como atualizar a versão do mecanismo, consulte [Manter o cluster de banco de dados do Amazon Neptune](cluster-maintenance.md). Em caso de dúvidas ou preocupações, o AWS Support está disponível nos fóruns da comunidade e por meio do [AWS Premium Support](https://aws.amazon.com/support).
# Mecanismo do Amazon Neptune versão 1.0.2.1.R2 (25/11/2019)
## Defeitos corrigidos nesta versão do mecanismo
+ Correção de um bug que afetava todas as consultas `project().by()` com travessias de repetição não alternada e travessias não `path()`.
## Versões de linguagem de consulta compatíveis com esta versão
Antes de atualizar um cluster de banco de dados para a versão 1.0.2.1.R2, assegure-se de que o projeto seja compatível com estas versões da linguagem de consulta:
+ *Gremlin versão:* `3.4.1`
+ *SPARQL versão:* `1.1`
## Caminhos de atualização para a versão 1.0.2.1.R2 do mecanismo
É possível atualizar manualmente qualquer versão anterior do mecanismo do Neptune para esta versão.
No entanto, a **atualização automática para esta versão não é compatível**.
## Atualizar para esta versão
O Amazon Neptune 1.0.2.1.R2 já está disponível ao público em geral.
Se um cluster de banco de dados estiver executando uma versão do mecanismo a partir da qual haja um caminho de atualização para essa versão, ele estará elegível para ser atualizado agora. Você pode atualizar qualquer cluster elegível usando as operações do cluster de banco de dados no console ou usando o SDK. O seguinte comando da CLI atualizará imediatamente um cluster elegível:
Para Linux, OS X ou Unix:
```
1. aws neptune modify-db-cluster \
2. --db-cluster-identifier (your-neptune-cluster) \
3. --engine-version 1.0.2.1 \
4. --apply-immediately
```
Para Windows:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.0.2.1 ^
4. --apply-immediately
```
As atualizações são simultaneamente aplicadas a todas as instâncias em um cluster de banco de dados. Como as atualizações exigem a reinicialização do banco de dados nessas instâncias, ocorrerá um tempo de inatividade de vinte a trinta segundos a alguns minutos. Depois disso, você poderá retomar o uso do cluster de banco de dados.
### Sempre teste antes de fazer a atualização
Quando uma nova versão principal ou secundária do mecanismo do Neptune for lançada, sempre teste as aplicações do Neptune antes de atualizá-la. Mesmo uma atualização secundária pode introduzir novos atributos ou comportamentos que afetem o código.
Comece comparando as páginas de notas da versão atual com as da versão de destino para ver se haverá alterações nas versões da linguagem de consulta ou outras alterações importantes.
A melhor maneira de testar uma nova versão antes de atualizar o cluster de banco de dados de produção é clonar o cluster de produção para que o clone execute a nova versão do mecanismo. Depois, você pode executar consultas no clone sem afetar o cluster de banco de dados de produção.
### Sempre crie um snapshot manual antes de fazer a atualização
Antes de fazer uma atualização, é altamente recomendável sempre criar um snapshot manual do cluster de banco de dados. Ter um snapshot automático só oferece proteção de curto prazo, enquanto um snapshot manual permanece disponível até que você o exclua explicitamente.
Em determinados casos, o Neptune cria um snapshot manual para você como parte do processo de atualização, mas não confie nisso e, em qualquer caso, crie o próprio snapshot manual.
Quando você tiver certeza de que não precisará reverter o cluster de banco de dados para o estado de pré-atualização, poderá excluir explicitamente o snapshot manual criado, bem como o snapshot manual que o Neptune tenha criado. Se o Neptune criar um snapshot manual, ele terá um nome que começa com `preupgrade`, seguido pelo nome do cluster de banco de dados, a versão do mecanismo de origem, a versão do mecanismo de destino e a data.
**nota**
Se você estiver tentando atualizar com [uma ação pendente em andamento](manage-console-maintaining), poderá encontrar um erro como o seguinte:
```
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 você encontrar esse erro, aguarde a conclusão da ação pendente ou acione imediatamente uma janela de manutenção para permitir que a atualização anterior seja concluída.
Para obter mais informações sobre como atualizar a versão do mecanismo, consulte [Manter o cluster de banco de dados do Amazon Neptune](cluster-maintenance.md). Em caso de dúvidas ou preocupações, o AWS Support está disponível nos fóruns da comunidade e por meio do [AWS Premium Support](https://aws.amazon.com/support).