# Cambio de las versiones del motor Athena
<a name="engine-versions-changing"></a>

Ocasionalmente, Athena lanza una nueva versión del motor para proporcionar un mejor rendimiento, funcionalidad y correcciones de código. Cuando hay disponible una versión más reciente, Athena se lo notifica en la consola. Puede optar por dejar que Athena decida cuándo actualizar o puede especificar manualmente una versión del motor Athena por grupo de trabajo.

## Búsqueda de la versión del motor para un grupo de trabajo
<a name="engine-versions-changing-finding-the-query-engine-version-for-a-workgroup"></a>

Puede utilizar la página de **Grupos de trabajo** para encontrar la versión actual del motor para cualquier grupo de trabajo.

**Cómo buscar la versión actual del motor para cualquier grupo de trabajo**

1. Abra la consola de Athena en [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home).

1. Si el panel de navegación de la consola no está visible, elija el menú de expansión de la izquierda.  
![\[Elija el menú de expansión.\]](http://docs.aws.amazon.com/es_es/athena/latest/ug/images/nav-pane-expansion.png)

1. En el panel de navegación de la consola de Athena, elija **Grupos de trabajo**.

1. En la página **Workgroups**, busque el grupo de trabajo que quiera. La columna **Versión del motor de consultas** del grupo de trabajo muestra la versión del motor de consultas.

## Uso de la consola de Athena para cambiar la versión del motor
<a name="engine-versions-changing-changing-the-engine-version"></a>

Cuando haya disponible una nueva versión del motor, podrá optar por dejar que Athena decida cuándo actualizar el grupo de trabajo o puede especificar manualmente la versión del motor Athena que utiliza el grupo de trabajo. Si solo hay una versión disponible actualmente, no es posible especificar manualmente otra versión.

**nota**  
Para cambiar la versión del motor de un grupo de trabajo, debe tener permiso para ejecutar la acción `athena:ListEngineVersions` en el grupo de trabajo. Para ver ejemplos de política de IAM, consulte [Ejemplos de políticas de grupo de trabajo](example-policies-workgroup.md). 

**Cómo dejar que Athena decida cuándo actualizar el grupo de trabajo**

1. Abra la consola de Athena en [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home).

1. Si el panel de navegación de la consola no está visible, elija el menú de expansión de la izquierda.

1. En el panel de navegación de la consola, elija **Workgroups**.

1. En la lista de grupos de trabajo, elija el enlace del grupo de trabajo que quiere configurar.

1. Elija **Edit (Edición de)**.

1. En la sección **Query engine version**, en **Actualizar motor de consultas**, elija **Automático** para dejar que Athena elija cuándo actualizar el grupo de trabajo. Este es el valor predeterminado.

1. Seleccione **Save changes (Guardar cambios)**.

   En la lista de grupos de trabajo, la opción **Estado de actualización del motor de consultas** del grupo de trabajo muestra **Automático**.

**Cómo elegir manualmente una versión de motor**

1. Abra la consola de Athena en [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home).

1. Si el panel de navegación de la consola no está visible, elija el menú de expansión de la izquierda.

1. En el panel de navegación de la consola, elija **Workgroups**.

1. En la lista de grupos de trabajo, elija el enlace del grupo de trabajo que quiere configurar.

1. Elija **Edit (Edición de)**.

1. En la sección **Query engine version**, en **Update query engine**, elija **Manual** para elegir manualmente una versión del motor

1. Use la opción **Query engine version** para elegir la versión del motor que quiere que utilice el grupo de trabajo. Si no está disponible otra versión del motor, no se puede especificar una versión del motor diferente.

1. Seleccione **Save changes (Guardar cambios)**.

   En la lista de grupos de trabajo, la opción **Estado de actualización del motor de consultas** del grupo de trabajo muestra **Manual**.

## Uso de la AWS CLI para cambiar la versión del motor
<a name="engine-versions-changing-changing-the-engine-version-cli"></a>

Para cambiar la versión del motor con la AWS CLI, utilice la sintaxis del siguiente ejemplo.

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

## Especificación de la versión del motor al crear un grupo de trabajo
<a name="engine-versions-changing-specifying-the-engine-version-when-you-create-a-workgroup"></a>

Al crear un grupo de trabajo, puede especificar la versión del motor que utiliza el grupo de trabajo o puede dejar que Athena decida cuándo actualizar el grupo de trabajo. Si está disponible una nueva versión del motor, una práctica recomendada es crear un grupo de trabajo para probar el nuevo motor antes de actualizar los otros grupos de trabajo. Para especificar la versión del motor de un grupo de trabajo, debe tener el permiso de `athena:ListEngineVersions` en el grupo de trabajo. Para ver ejemplos de política de IAM, consulte [Ejemplos de políticas de grupo de trabajo](example-policies-workgroup.md).

**Cómo especificar la versión del motor al crear un grupo de trabajo**

1. Abra la consola de Athena en [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home).

1. Si el panel de navegación de la consola no está visible, elija el menú de expansión de la izquierda.

1. En el panel de navegación de la consola, elija **Workgroups**.

1. En el panel **Grupos de trabajo**, elija **Crear grupo de trabajo**.

1. En la página **Crear grupo de trabajo**, en la sección **Query engine version**, lleve a cabo una de las siguientes acciones:
   + Elija **Automatic** para dejar que Athena elija cuándo actualizar el grupo de trabajo. Este es el valor predeterminado.
   + Elija **Manual** para elegir manualmente otra versión del motor si hay una disponible.

1. Ingrese la información para los demás campos, según sea necesario. Para obtener información acerca de los campos, consulte [Creación de un grupo de trabajo](creating-workgroups.md).

1. Elija **Crear grupo de trabajo**.

## Pruebas de consultas antes de una actualización de la versión del motor
<a name="engine-versions-testing"></a>

Cuando un grupo de trabajo se actualiza a una nueva versión del motor, algunas de sus consultas pueden invalidarse debido a incompatibilidades. Para asegurarse de que la actualización de la versión del motor se efectúe sin inconvenientes, puede probar las consultas con anticipación.

**Para probar las consultas antes de una actualización de la versión del motor**

1. Verifique la versión del motor del grupo de trabajo que está utilizando. La versión del motor que está utilizando se muestra en la página **Workgroups** en la columna **Query engine version** del grupo de trabajo. Para obtener más información, consulte [Búsqueda de la versión del motor para un grupo de trabajo](#engine-versions-changing-finding-the-query-engine-version-for-a-workgroup).

1. Cree un grupo de trabajo de prueba que utilice la nueva versión del motor. Para obtener más información, consulte [Especificación de la versión del motor al crear un grupo de trabajo](#engine-versions-changing-specifying-the-engine-version-when-you-create-a-workgroup).

1. Utilice el nuevo grupo de trabajo para ejecutar las consultas que desea probar.

1. Si se produce un error en una consulta, verifique si hay cambios bruscos en el nuevo motor que podrían estar afectando a la consulta. Es posible que algunos cambios requieran que actualice la sintaxis de las consultas.

1. Si las consultas continúan produciendo un error, póngase en contacto con AWS Support para obtener ayuda. En la Consola de administración de AWS, elija **Asistencia**, **Centro de asistencia** o haga una pregunta en [AWS re:Post](https://repost.aws/tags/TA78iVOM7gR62_QqDe2-CmiA/amazon-athena) con la etiqueta **Amazon Athena**.

## Solución de problemas de consultas con error después de una actualización de la versión del motor
<a name="engine-versions-troubleshooting"></a>

Si se produce un error en una consulta después de una actualización de la versión del motor, verifique si hay cambios bruscos, incluidos los que pueden afectar la sintaxis de las consultas.

Si las consultas continúan produciendo un error, póngase en contacto con AWS Support para obtener ayuda. En la Consola de administración de AWS, elija **Asistencia**, **Centro de asistencia** o haga una pregunta en [AWS re:Post](https://repost.aws/tags/TA78iVOM7gR62_QqDe2-CmiA/amazon-athena) con la etiqueta **Amazon Athena**.