

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.2 (09/03/2020)
<a name="engine-releases-1.0.2.2"></a>

Desde 09/03/2020, a versão 1.0.2.2 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.

## Versões de patch subsequentes para esta versão
<a name="engine-releases-1.0.2.2-patches"></a>
+ [Versão: 1.0.2.2.R2 (02/04/2020)](engine-releases-1.0.2.2.R2.md) 
+ [Versão: 1.0.2.2.R3 (22/07/2020)](engine-releases-1.0.2.2.R3.md) 
+ [Versão: 1.0.2.2.R4 (23/07/2020)](engine-releases-1.0.2.2.R4.md) 
+ [Versão: 1.0.2.2.R5 (12/10/2020)](engine-releases-1.0.2.2.R5.md) 
+ [Versão: 1.0.2.2.R6 (19/02/2021)](engine-releases-1.0.2.2.R6.md) 

## Melhorias nesta versão do mecanismo
<a name="engine-releases-1.0.2.2-improvements"></a>
+ Foram adicionadas informações à API de status sobre transações que estão sendo revertidas. Consulte [Status de instância](access-graph-status.md).
+ Foi atualizada a versão do Apache TinkerPop para 3.4.3.

  A versão 3.4.3 é compatível com a versão anterior compatível com o Neptune (3.4.1). Ela apresenta uma pequena alteração no comportamento: o Gremlin não retorna mais um erro quando você tenta fechar uma sessão que não existe (consulte [Evitar erro ao fechar sessões que não existem](https://issues.apache.org/jira/browse/TINKERPOP-2237)).
+ Foram removidos gargalos de desempenho na execução de etapas de pesquisa de texto completo do Gremlin.

## Defeitos corrigidos nesta versão do mecanismo
<a name="engine-releases-1.0.2.2-defects"></a>
+ Foi corrigido um bug do SPARQL na manipulação de padrões de gráficos vazios em consultas.
+ Foi corrigido um bug do SPARQL na manipulação de pontos-e-vírgulas não codificados em consultas com codificação de URL.
+ Foi corrigido um bug do Gremlin na manipulação de vértices repetidos na etapa `Union`.
+ Foi corrigido um bug do Gremlin que fazia com que algumas consultas com um `.simplePath()` ou um `.cyclicPath()` dentro de um `.repeat()` retornassem resultados incorretos.
+ Foi corrigido um bug do Gremlin que fazia `.project()` retornar resultados incorretos se sua travessia filho não retornasse nenhuma solução.
+ Foi corrigido um bug do Gremlin em que erros de conflitos de leitura/gravação geravam um `InternalFailureException`, em vez de um `ConcurrentModificationException`.
+ Foi corrigido um bug do Gremlin que causava falhas `.group().by(...).by(values("property"))`.
+ Foram corrigidos bugs do Gremlin na saída do perfil para etapas de pesquisa de texto completo.
+ Foi corrigido um vazamento de recursos em sessões do Gremlin.
+ Foi corrigido um bug que impedia a API de status de relatar a versão correta que pode ser solicitada em alguns casos.
+ Correção de um erro do carregador em massa que permitia que um URL para um local diferente do Amazon S3 fosse usado como a origem em uma solicitação de carregamento em massa.
+ Foi corrigido um bug do carregador em massa no status detalhado da carga.

## Versões de linguagem de consulta compatíveis com esta versão
<a name="engine-releases-1.0.2.2-query-versions"></a>

Antes de atualizar um cluster de banco de dados para a versão 1.0.2.2, assegure-se de que o projeto seja compatível com estas versões da linguagem de consulta:
+ *Gremlin versão:* `3.4.3`
+ *SPARQL versão:* `1.1`

## Caminhos de atualização para a versão 1.0.2.2 do mecanismo
<a name="engine-releases-1.0.2.2-upgrade-paths"></a>

É possível atualizar manualmente qualquer versão anterior do mecanismo do Neptune para esta versão.

Se o cluster tiver seu parâmetro `AutoMinorVersionUpgrade` definido como `True`, o cluster será atualizado para esta versão do mecanismo automaticamente duas a três semanas após a data desta versão, durante uma janela de manutenção.

## Atualizar para esta versão
<a name="engine-releases-1.0.2.2-upgrading"></a>

O Amazon Neptune 1.0.2.2 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.2 \
4.     --apply-immediately
```

Para Windows:

```
1. aws neptune modify-db-cluster ^
2.     --db-cluster-identifier (your-neptune-cluster) ^
3.     --engine-version 1.0.2.2 ^
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
<a name="engine-1.0.2.2-test-before-upgrading"></a>

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
<a name="engine-1.0.2.2-snapshot-before-upgrading"></a>

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.2.R6 (19/02/2021)
<a name="engine-releases-1.0.2.2.R6"></a>

Desde 19/02/2021, a versão 1.0.2.2.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
<a name="engine-releases-1.0.2.2.R6-defects"></a>
+ Correção do erro do Gremlin em que `InternalFailureException` era definida como o código de resposta em determinadas circunstâncias quando ocorria uma `ConcurrentModificationException`.
+ Correção de um erro do Gremlin em que, em determinadas condições, a atualização de bordas ou vértices poderia causar uma `InternalFailureException` transitória.

## Versões de linguagem de consulta compatíveis com esta versão
<a name="engine-releases-1.0.2.2.R6-query-versions"></a>

Antes de atualizar um cluster de banco de dados para a versão 1.0.2.2.R6, assegure-se de que o projeto seja compatível com estas versões da linguagem de consulta:
+ *Gremlin versão:* `3.4.8`
+ *SPARQL versão:* `1.1`

## Caminhos de atualização para a versão 1.0.2.2.R6 do mecanismo
<a name="engine-releases-1.0.2.2.R6-upgrade-paths"></a>

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.2`.

É possível atualizar manualmente qualquer versão anterior do mecanismo do Neptune para esta versão.

## Atualizar para esta versão
<a name="engine-releases-1.0.2.2.R6-upgrading"></a>

O Amazon Neptune 1.0.2.2.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.2 \
4.     --apply-immediately
```

Para Windows:

```
1. aws neptune modify-db-cluster ^
2.     --db-cluster-identifier (your-neptune-cluster) ^
3.     --engine-version 1.0.2.2 ^
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
<a name="engine-1.0.2.2.R6-test-before-upgrading"></a>

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
<a name="engine-1.0.2.2.R6-snapshot-before-upgrading"></a>

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.2.R5 (12/10/2020)
<a name="engine-releases-1.0.2.2.R5"></a>

Desde 12/10/2020, a versão 1.0.2.2.R5 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.

## Melhorias nesta versão do mecanismo
<a name="engine-releases-1.0.2.2.R5-improvements"></a>
+ Melhoria do desempenho da etapa `properties()` do Gremlin.
+ Adição de detalhes sobre `BindOp` e `MultiplexerOp` nos relatórios de explain e profile.
+ Para respostas de consulta do SPARQL, adicionamos `charset` ao cabeçalho Content-Type, permitindo que os clientes HTTP reconheçam o conjunto de caracteres que está sendo usado automaticamente.

## Defeitos corrigidos nesta versão do mecanismo
<a name="engine-releases-1.0.2.2.R5-defects"></a>
+ Correção de um erro do SPARQL em que `CancellationException` não era tratada.
+ Correção de um erro do SPARQL em que as consultas com opções aninhadas não funcionavam corretamente.
+ Correção de um erro do SPARQL em LOAD em que `ConcurrentModificationException` poderia fazer com que uma consulta travasse.
+ Correção de um erro do SPARQL que impedia que as respostas das consultas fossem compactadas com gzip.
+ Correção de um erro do Gremlin na etapa `groupBy()`.
+ Correção de um erro do Gremlin relacionado ao uso de uma etapa `aggregate()` dentro de uma etapa `local()`.
+ Correção de um erro do Gremlin relacionado ao uso de `bothE()` seguido por um predicado que usa valores agregados.
+ Correção de um erro do Gremlin relacionado ao uso da etapa `bothE()` com a etapa `repeat()`.
+ Correção de um possível vazamento de memória do Gremlin relacionado à etapa `both()`.
+ Correção de um erro em que as métricas de solicitação estavam ausentes porque um endpoint terminado com “/” não estava sendo tratado corretamente.
+ Correção de um erro que poderia lançar uma `ThrottlingException` mesmo quando a fila de solicitações não estivesse cheia.
+ Correção de um erro na busca do status de carregamento quando um carregamento falhava por um motivo, como `LOAD_DATA_FAILED_DUE_TO_FEED_MODIFIED_OR_DELETE`.

## Versões de linguagem de consulta compatíveis com esta versão
<a name="engine-releases-1.0.2.2.R5-query-versions"></a>

Antes de atualizar um cluster de banco de dados para a versão 1.0.2.2.R5, assegure-se de que o projeto seja compatível com estas versões da linguagem de consulta:
+ *Gremlin versão:* `3.4.3`
+ *SPARQL versão:* `1.1`

## Caminhos de atualização para a versão 1.0.2.2.R5 do mecanismo
<a name="engine-releases-1.0.2.2.R5-upgrade-paths"></a>

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.2`.

É possível atualizar manualmente qualquer versão anterior do mecanismo do Neptune para esta versão.

## Atualizar para esta versão
<a name="engine-releases-1.0.2.2.R5-upgrading"></a>

O Amazon Neptune 1.0.2.2.R5 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.2 \
4.     --apply-immediately
```

Para Windows:

```
1. aws neptune modify-db-cluster ^
2.     --db-cluster-identifier (your-neptune-cluster) ^
3.     --engine-version 1.0.2.2 ^
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
<a name="engine-1.0.2.2.R5-test-before-upgrading"></a>

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
<a name="engine-1.0.2.2.R5-snapshot-before-upgrading"></a>

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.2.R4 (23/07/2020)
<a name="engine-releases-1.0.2.2.R4"></a>

Desde 23/07/2020, a versão 1.0.2.2.R4 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.

## Melhorias nesta versão do mecanismo
<a name="engine-releases-1.0.2.2.R4-improvements"></a>
+ Melhoria do uso da memória com a liberação mais frequente de memória não utilizada de volta para o sistema operacional.
+ Também foi aprimorado o uso de memória para consultas SPARQL GROUP BY.
+ Aumento do tempo máximo que uma conexão WebSocket autenticada com o IAM pode permanecer aberta, de 36 horas para 10 dias.
+ Adição de uma métrica `BufferCacheHitRatio` do CloudWatch, que pode ser útil para diagnosticar a latência da consulta e ajustar os tipos de instância. Consulte [Métricas do Neptune](cw-metrics.md#cw-metrics-available). 

## Defeitos corrigidos nesta versão do mecanismo
<a name="engine-releases-1.0.2.2.R4-defects"></a>
+ Correção de um erro no fechamento de conexões WebSocket do IAM inativas ou expiradas. O Neptune agora envia um quadro de fechamento antes de fechar a conexão.
+ Correção de um erro do SPARQL na avaliação de consultas que contêm condições aninhadas de FILTER EXISTS e/ou FILTER NOT EXISTS.
+ Correção de um erro de encerramento de consultas do SPARQL que causava o bloqueio de threads no servidor em determinadas condições extremas.
+ Correção de um erro do Gremlin que envolve o Edge PathType na etapa `hasLabel`.
+ Correção de um erro do Gremlin para lidar com `toV` e `fromV` individualmente para cada direção em `bothE`.
+ Correção de um erro do Gremlin que envolvia o desaparecimento de sideEffects.

## Versões de linguagem de consulta compatíveis com esta versão
<a name="engine-releases-1.0.2.2.R4-query-versions"></a>

Antes de atualizar um cluster de banco de dados para a versão 1.0.2.2.R4, assegure-se de que o projeto seja compatível com estas versões da linguagem de consulta:
+ *Gremlin versão:* `3.4.3`
+ *SPARQL versão:* `1.1`

## Caminhos de atualização para a versão 1.0.2.2.R4 do mecanismo
<a name="engine-releases-1.0.2.2.R4-upgrade-paths"></a>

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.2`.

É possível atualizar manualmente qualquer versão anterior do mecanismo do Neptune para esta versão.

## Atualizar para esta versão
<a name="engine-releases-1.0.2.2.R4-upgrading"></a>

O Amazon Neptune 1.0.2.2.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.2 \
4.     --apply-immediately
```

Para Windows:

```
1. aws neptune modify-db-cluster ^
2.     --db-cluster-identifier (your-neptune-cluster) ^
3.     --engine-version 1.0.2.2 ^
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
<a name="engine-1.0.2.2.R4-test-before-upgrading"></a>

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
<a name="engine-1.0.2.2.R4-snapshot-before-upgrading"></a>

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.2.R3 (22/07/2020)
<a name="engine-releases-1.0.2.2.R3"></a>

A versão 1.0.2.2.R3 do mecanismo foi incorporada à [versão 1.0.2.2.R4 do mecanismo](engine-releases-1.0.2.2.R4.md).

# Mecanismo do Amazon Neptune versão 1.0.2.2.R2 (02/04/2020)
<a name="engine-releases-1.0.2.2.R2"></a>

Desde 02/04/2020, a versão 1.0.2.2.R2 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.

## Melhorias nesta versão do mecanismo
<a name="engine-releases-1.0.2.2.R2-improvements"></a>
+ Agora é possível enfileirar até 64 trabalhos de carregamento em massa, em vez de esperar um trabalho terminar para iniciar o próximo Também é possível executar uma solicitação de carga em fila dependente da conclusão com êxito de um ou mais trabalhos de carga enfileirados anteriormente usando o parâmetro `dependencies` do comando `load`. Consulte [Comando do carregador do Neptune](load-api-reference-load.md).
+ A saída da pesquisa de texto completo agora pode ser classificada (consulte [Parâmetros de pesquisa de texto completo](full-text-search-parameters.md)).
+ Agora há um parâmetro do cluster de banco de dados para invocar fluxos do Neptune e o atributo foi movido para fora do modo de laboratório. Consulte [Habilitar os fluxos do Neptune](streams-using-enabling.md).

## Defeitos corrigidos nesta versão do mecanismo
<a name="engine-releases-1.0.2.2.R2-defects"></a>
+ Corrigida uma falha estocástica na inicialização do servidor que atrasava a criação da instância.
+ Corrigido um problema do otimizador em que as instruções do `BIND` na consulta inicializavam o otimizador com padrões não seletivos no planejamento da ordem de junção.

## Versões de linguagem de consulta compatíveis com esta versão
<a name="engine-releases-1.0.2.2.R2-query-versions"></a>

Antes de atualizar um cluster de banco de dados para a versão 1.0.2.2.R2, assegure-se de que o projeto seja compatível com estas versões da linguagem de consulta:
+ *Gremlin versão:* `3.4.3`
+ *SPARQL versão:* `1.1`

## Caminhos de atualização para a versão 1.0.2.2.R2 do mecanismo
<a name="engine-releases-1.0.2.2.R2-upgrade-paths"></a>

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.2`.

É possível atualizar manualmente qualquer versão anterior do mecanismo do Neptune para esta versão.

## Atualizar para esta versão
<a name="engine-releases-1.0.2.2.R2-upgrading"></a>

O Amazon Neptune 1.0.2.2.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 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.2 \
4.     --apply-immediately
```

Para Windows:

```
1. aws neptune modify-db-cluster ^
2.     --db-cluster-identifier (your-neptune-cluster) ^
3.     --engine-version 1.0.2.2 ^
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
<a name="engine-1.0.2.2.R2-test-before-upgrading"></a>

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
<a name="engine-1.0.2.2.R2-snapshot-before-upgrading"></a>

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