# Alterar versões do mecanismo do Athena
<a name="engine-versions-changing"></a>

Esporadicamente, o Athena lança uma nova versão do mecanismo para oferecer melhor performance, funcionalidade e correções de código. Quando uma nona versão está disponível, o Athena notifica você no console. Você pode deixar que o Athena decida quando fazer upgrade ou especificar manualmente uma versão do mecanismo do Athena por grupo de trabalho.

## Localizar a versão do mecanismo de um grupo de trabalho
<a name="engine-versions-changing-finding-the-query-engine-version-for-a-workgroup"></a>

Você pode usar a página **Workgroups** (Grupos de trabalho) para localizar a versão atual do mecanismo de qualquer grupo de trabalho.

**Para localizar a versão atual do mecanismo de qualquer grupo de trabalho**

1. Abra o console do Athena em [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home).

1. Se o painel de navegação do console não estiver visível, escolha o menu de expansão à esquerda.  
![\[Escolha o menu de expansão.\]](http://docs.aws.amazon.com/pt_br/athena/latest/ug/images/nav-pane-expansion.png)

1. No painel de navegação do console do Athena, escolha **Workgroups** (Grupos de trabalho).

1. Na página **Workgroups**, encontre o grupo de trabalho desejado. A coluna **Query engine version** (Versão do mecanismo de consulta) do grupo de trabalho exibe a versão do mecanismo de consulta.

## Usar o console do Athena para alterar a versão do mecanismo
<a name="engine-versions-changing-changing-the-engine-version"></a>

Quando uma nova versão do mecanismo está disponível, você pode deixar que o Athena decida quando fazer upgrade do grupo de trabalho ou especificar manualmente a versão do mecanismo do Athena que o grupo de trabalho usa. Se apenas uma versão estiver disponível no momento, não é possível especificar manualmente uma versão diferente.

**nota**  
Para alterar a versão do mecanismo de um grupo de trabalho, você deve ter permissão para executar a ação `athena:ListEngineVersions` no grupo de trabalho. Para ver exemplos de política do IAM, consulte [Exemplo de políticas de grupo de trabalho](example-policies-workgroup.md). 

**Para deixar que o Athena decida quando fazer upgrade do grupo de trabalho**

1. Abra o console do Athena em [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home).

1. Se o painel de navegação do console não estiver visível, escolha o menu de expansão à esquerda.

1. No painel de navegação do console, escolha **Workgroups** (Grupos de trabalho).

1. Na lista de grupos de trabalho, escolha link para o grupo de trabalho que deseja configurar.

1. Escolha **Editar**.

1. Na seção **Query engine version** (Versão do mecanismo de consulta), para **Update query engine** (Atualizar mecanismo de consulta), escolha **Automatic** (Automático) para permitir que o Athena escolha quando fazer o upgrade de seu grupo de trabalho. Essa é a configuração padrão.

1. Escolha **Salvar alterações**.

   Na lista de grupos de trabalho, o **Query engine update status** (Status de atualização do mecanismo de consulta) para o grupo de trabalho indica **Automatic** (Automático).

**Para escolher manualmente a versão de um mecanismo**

1. Abra o console do Athena em [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home).

1. Se o painel de navegação do console não estiver visível, escolha o menu de expansão à esquerda.

1. No painel de navegação do console, escolha **Workgroups** (Grupos de trabalho).

1. Na lista de grupos de trabalho, escolha link para o grupo de trabalho que deseja configurar.

1. Escolha **Editar**.

1. Na seção **Query engine version** (Versão do mecanismo de consulta), em **Update query engine** (Atualizar mecanismo de consulta), escolha **Manual** para escolher manualmente uma versão do mecanismo).

1. Use a opção **Query engine version** (Versão do mecanismo de consulta) para escolher a versão do mecanismo que você deseja que o grupo de trabalho use. Se uma versão de mecanismo diferente não estiver disponível, uma versão de mecanismo diferente não poderá ser especificada.

1. Escolha **Salvar alterações**.

   Na lista de grupos de trabalho, o **Query engine update status** (Status de atualização do mecanismo de consulta) para o grupo de trabalho indica **Manual** (Manual).

## Usar o AWS CLI para alterar a versão do mecanismo
<a name="engine-versions-changing-changing-the-engine-version-cli"></a>

Para alterar a versão do mecanismo usando a AWS CLI, use a sintaxe no seguinte exemplo.

```
aws athena update-work-group --work-group workgroup-name --configuration-updates EngineVersion={SelectedEngineVersion='Athena engine version 3'}
```

## Especificar a versão do mecanismo ao criar um grupo de trabalho
<a name="engine-versions-changing-specifying-the-engine-version-when-you-create-a-workgroup"></a>

Ao criar um grupo de trabalho, você pode especificar a versão do mecanismo que ele usará ou deixar que o Athena decida quando fazer upgrade do grupo de trabalho. Se uma nova versão do mecanismo estiver disponível, uma prática recomendada é criar um grupo de trabalho para testar o novo mecanismo antes de fazer upgrade dos outros grupos de trabalho. Para especificar a versão do mecanismo de um grupo de trabalho, você deve ter a permissão `athena:ListEngineVersions` no grupo de trabalho. Para ver exemplos de política do IAM, consulte [Exemplo de políticas de grupo de trabalho](example-policies-workgroup.md).

**Especificar a versão do mecanismo quando você cria um grupo de trabalho**

1. Abra o console do Athena em [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home).

1. Se o painel de navegação do console não estiver visível, escolha o menu de expansão à esquerda.

1. No painel de navegação do console, escolha **Workgroups** (Grupos de trabalho).

1. Na página **Workgroups** (Grupos de trabalho), escolha **Create workgroup** (Criar grupo de trabalho).

1. Na página **Create workgroup** (Criar grupo de trabalho), na seção **Query engine version** (Versão do mecanismo de consulta), execute um destes procedimentos:
   + Escolha **Automatic** (Automático) para permitir que o Athena escolha quando fazer upgrade de seu grupo de trabalho. Essa é a configuração padrão.
   + Selecione **Manual** para escolher manualmente uma versão de mecanismo diferente, se houver uma disponível.

1. Digite as informações nos outros campos conforme necessário. Para obter informações sobre os outros campos, consulte [Criar um grupo de trabalho](creating-workgroups.md).

1. Escolha **Create workgroup (Criar grupo de trabalho)**.

## Testar consultas antes da atualização da versão do mecanismo
<a name="engine-versions-testing"></a>

Quando o upgrade de um grupo de trabalho é feito para uma nova versão do mecanismo, algumas das suas consultas podem ser interrompidas devido a incompatibilidades. Para garantir que o upgrade da versão do mecanismo seja feito sem problemas, você pode testar as consultas com antecedência.

**Para testar as consultas antes do upgrade de uma versão do mecanismo**

1. Verifique a versão do mecanismo do grupo de trabalho que você está usando. A versão do mecanismo que você está usando aparece na página **Workgroups** (Grupos de trabalho) na coluna **Query engine version** (Versão do mecanismo de consulta) do grupo de trabalho. Para obter mais informações, consulte [Localizar a versão do mecanismo de um grupo de trabalho](#engine-versions-changing-finding-the-query-engine-version-for-a-workgroup).

1. Crie um grupo de trabalho de teste que usa a nova versão do mecanismo. Para obter mais informações, consulte [Especificar a versão do mecanismo ao criar um grupo de trabalho](#engine-versions-changing-specifying-the-engine-version-when-you-create-a-workgroup).

1. Use o novo grupo de trabalho para executar as consultas que você deseja testar.

1. Se uma consulta falhar, verifique se há alterações inválidas no novo mecanismo que possam estar afetando a consulta. Algumas alterações podem exigir que você atualize a sintaxe das suas consultas.

1. Se a falha persistir, entre em contato com AWS Support para obter ajuda. No Console de gerenciamento da AWS, escolha **Suporte**, **Central de Suporte** ou faça uma pergunta em [AWS re:Post](https://repost.aws/tags/TA78iVOM7gR62_QqDe2-CmiA/amazon-athena) usando a etiqueta **Amazon Athena**.

## Solucionar problemas de consultas que falham após a atualização da versão do mecanismo
<a name="engine-versions-troubleshooting"></a>

Se uma consulta falhar após o upgrade de uma versão do mecanismo, verifique se há alterações inválidas, inclusive que possam afetar a sintaxe das consultas.

Se a falha persistir, entre em contato com AWS Support para obter ajuda. No Console de gerenciamento da AWS, escolha **Suporte**, **Central de Suporte** ou faça uma pergunta em [AWS re:Post](https://repost.aws/tags/TA78iVOM7gR62_QqDe2-CmiA/amazon-athena) usando a etiqueta **Amazon Athena**.