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.4.0 (12/10/2020)
Desde 12/10/2020, a versão 1.0.4.0 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
+ [Versão: 1.0.4.0.R2 (24/02/2021)](engine-releases-1.0.4.0.R2.md)
## Novos recursos nesta versão do mecanismo
+ Adição da compactação de nível de quadro para o Gremlin.
## Melhorias nesta versão do mecanismo
+ O Amazon Neptune agora exige o uso do Secure Sockets Layer (SSL) com o protocolo TLSv1.2 para todas as conexões com o Neptune em todas as regiões, usando estes pacotes de criptografia forte:
+ `TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384`
+ `TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256`
+ `TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384`
+ `TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256`
+ `TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA`
+ `TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA`
Isso vale para conexões REST e WebSocket com o Neptune e significa que você deve usar HTTPS em vez de HTTP ao se conectar ao Neptune em todas as regiões.
Como as conexões de clientes usando HTTP ou TLS 1.1 não serão mais aceitas em nenhum lugar, garanta que os clientes e o código tenham sido atualizados para usar TLS 1.2 e HTTPS antes de atualizar para esta versão do mecanismo.
**Importante**
**A necessidade de usar SSL/TLS para todas as conexões com o Neptune pode ser uma mudança significativa.** Isso afeta as conexões com o console do Gremlin, o driver do Gremlin, Gremlin Python, .NET, NodeJs, APIs REST e também conexões do balanceador de carga. Se você estiver usando HTTP para qualquer um ou todos eles, agora deverá atualizar o cliente e os drivers relevantes e alterar o código para usar HTTPS ou as conexões falharão.
Um erro nesta versão permitia que conexões HTTP e/ou conexões TLS desatualizadas continuassem funcionando para clientes que haviam definido anteriormente um parâmetro de cluster de banco de dados para impedir a imposição de conexões HTTPS. Esse erro foi corrigido nas versões de patch [1.0.4.0.R2](engine-releases-1.0.4.0.R2.md) e [1.0.4.1.R2](engine-releases-1.0.4.1.R2.md), mas a correção causava falhas de conexão inesperadas quando os patches eram instalados automaticamente.
Por esse motivo, os dois patches foram revertidos e só podem ser instalados manualmente, para que você tenha a chance de atualizar sua configuração para o TLS 1.2.
+ Atualização do TinkerPop para a versão 3.4.8. Esta é uma atualização compatível com versões anteriores. Consulte o [log de alterações do TinkerPop](https://github.com/apache/tinkerpop/blob/master/CHANGELOG.asciidoc#tinkerpop-348-release-date-august-3-2020) para ver as novidades.
+ Melhoria do desempenho da etapa `properties()` do Gremlin.
+ Adição de detalhes sobre `BindOp` e `MultiplexerOp` nos relatórios de explain e profile.
+ Adição da pré-busca de dados para melhorar o desempenho quando há falhas de cache.
+ Adição de uma nova configuração `allowEmptyStrings` no parâmetro `parserConfiguration` do carregador em massa que permite que strings vazias sejam tratadas como valores de propriedades válidos em carregamentos de CSV (consulte [Parâmetros de solicitação do carregador do Neptune](load-api-reference-load.md#load-api-reference-load-parameters)).
+ O carregador agora permite um ponto e vírgula com escape em colunas CSV de vários valores.
## Defeitos corrigidos nesta versão do mecanismo
+ 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 fazia com que as réplicas ficassem atrasadas e reiniciassem sob carga pesada quando o mecanismo do DFE estava habilitado no modo de laboratório.
+ Correção de um erro que impedia que a mensagem de erro correta fosse relatada quando um carregamento em massa falhava devido a uma condição de falta de memória.
+ Correção de um erro do SPARQL em que a codificação de caracteres era colocada no cabeçalho Content-Encoding nas respostas de consultas do SPARQL. Em vez disso, agora `charset` é colocado no cabeçalho Content-Type, permitindo que os clientes HTTP reconheçam o conjunto de caracteres que está sendo usado automaticamente.
## 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.4.0, 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.3.0 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.4.0 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.4.0 \
4. --apply-immediately
```
Para Windows:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.0.4.0 ^
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.4.0.R2 (24/02/2021)
Desde 24/02/2021, a versão 1.0.4.0.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.
## Defeitos corrigidos nesta versão do mecanismo
+ Correção do erro [Versão: 1.0.4.0 (12/10/2020)](engine-releases-1.0.4.0.md) que permitia conexões com o Neptune usando `HTTP` ou versões anteriores do TLS, em vez de `HTTPS` e TLS 1.2.
**Importante**
**A necessidade de usar SSL/TLS para todas as conexões com o Neptune pode ser uma mudança significativa.** Isso afeta as conexões com o console do Gremlin, o driver do Gremlin, Gremlin Python, .NET, NodeJs, APIs REST e também conexões do balanceador de carga. Se você usa HTTP ou uma versão mais antiga do TLS para qualquer uma ou todas, deve atualizar o cliente e os drivers relevantes antes de instalar esse patch e alterar o código para usar exclusivamente HTTPS.
+ Correção de um erro no carregamento em massa em CSV envolvendo rótulos que terminam com `#`.
+ 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
Antes de atualizar um cluster de banco de dados para a versão 1.0.4.0.R2, 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.4.0.R2 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.4.0`.
É 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.4.0.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.4.0 \
4. --apply-immediately
```
Para Windows:
```
1. aws neptune modify-db-cluster ^
2. --db-cluster-identifier (your-neptune-cluster) ^
3. --engine-version 1.0.4.0 ^
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).