Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Modification des versions du moteur Athena
Athena publie occasionnellement une nouvelle version du moteur pour améliorer les performances, les fonctionnalités et les corrections de code. Lorsqu'une nouvelle version du moteur est disponible, Athena vous en informe dans la console. Vous pouvez choisir de laisser Athena décider du moment de la mise à jour ou spécifier manuellement une version du moteur Athena par groupe de travail.
## Recherche de la version du moteur pour un groupe de travail
Vous pouvez utiliser la page **Workgroups** (Groupes de travail) pour trouver la version actuelle du moteur pour tout groupe de travail.
**Recherche de la version actuelle du moteur pour tout groupe de travail**
1. Ouvrez la console à l'adresse [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home).
1. Si le panneau de navigation de la console n'est pas visible, choisissez le menu d'extension sur la gauche.
1. Dans le panneau de navigation de la console Athena, choisissez **Workgroups** (Groupes de travail).
1. Sur la page **Workgroups** (Groupes de travail), trouvez le groupe de travail souhaité. La colonne **Query engine version** (Version du moteur de requête) pour le groupe de travail affiche la version du moteur de requête.
## Utilisation de la console Athena pour modifier la version du moteur
Lorsqu'une nouvelle version du moteur est disponible, vous pouvez choisir de laisser Athena décider de la mise à jour du groupe de travail ou spécifier manuellement la version du moteur Athena utilisée par le groupe de travail. Si une seule version est actuellement disponible, il n'est pas possible de spécifier manuellement une version différente.
**Note**
Pour modifier la version du moteur d'un groupe de travail, vous devez avoir l'autorisation d'exécuter l'action `athena:ListEngineVersions` sur le groupe de travail. Pour des exemples de politiques IAM, voir [Exemple de politiques de groupe de travail](example-policies-workgroup.md).
**Laisser Athena décider de la mise à jour du groupe de travail**
1. Ouvrez la console à l'adresse [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home).
1. Si le panneau de navigation de la console n'est pas visible, choisissez le menu d'extension sur la gauche.
1. Dans le panneau de navigation de la console, choisissez **Workgroups** (Groupes de travail).
1. Dans la liste des groupes de travail, choisissez le lien pour le groupe de travail que vous voulez configurer.
1. Choisissez **Edit** (Modifier).
1. Sous **Query engine version** (Version du moteur de requête), pour **Update query engine** (Mettre à jour le moteur de requête), choisissez **Automatic** (Automatique) pour laisser Athena décider quand mettre à jour de votre groupe de travail. Il s’agit du paramètre par défaut.
1. Sélectionnez **Enregistrer les modifications**.
Dans la liste des groupes de travail, l'**état de mise à jour du moteur de requête** pour le groupe de travail indique **Automatic** (Automatique).
**Choisir manuellement une version du moteur**
1. Ouvrez la console à l'adresse [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home).
1. Si le panneau de navigation de la console n'est pas visible, choisissez le menu d'extension sur la gauche.
1. Dans le panneau de navigation de la console, choisissez **Workgroups** (Groupes de travail).
1. Dans la liste des groupes de travail, choisissez le lien pour le groupe de travail que vous voulez configurer.
1. Choisissez **Edit** (Modifier).
1. Dans la section **Query engine version** (Version du moteur de requête), pour **Update query engine** (Mise à jour du moteur de requête), choisissez **Manual** (Manuel) pour choisir manuellement une version du moteur.
1. Utilisez l'option **Query engine version** (Version du moteur de requête) pour choisir la version du moteur à utiliser par le groupe de travail. Si aucune version du moteur différente n'est disponible, une version du moteur différente ne peut pas être spécifiée.
1. Sélectionnez **Enregistrer les modifications**.
Dans la liste des groupes de travail, l'**état de mise à jour du moteur de requête** pour le groupe de travail indique **Manual** (Manuel).
## Utilisez le AWS CLI pour modifier la version du moteur
Pour modifier la version du moteur à l'aide de AWS CLI, utilisez la syntaxe de l'exemple suivant.
```
aws athena update-work-group --work-group {{workgroup-name}} --configuration-updates EngineVersion={SelectedEngineVersion='Athena engine version 3'}
```
## Spécification de la version du moteur lors de la création d’un groupe de travail
Lorsque vous créez un groupe de travail, vous pouvez spécifier la version du moteur que le groupe de travail utilise ou laisser Athena décider de la mise à jour du groupe de travail. Si une nouvelle version du moteur est disponible, une bonne pratique consiste à créer un groupe de travail pour tester le nouveau moteur avant de mettre à jour vos autres groupes de travail. Pour spécifier la version du moteur d'un groupe de travail, vous devez avoir l'autorisation `athena:ListEngineVersions` sur le groupe de travail. Pour des exemples de politiques IAM, voir [Exemple de politiques de groupe de travail](example-policies-workgroup.md).
**Spécifier la version du moteur lors de la création d'un groupe de travail**
1. Ouvrez la console à l'adresse [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home).
1. Si le panneau de navigation de la console n'est pas visible, choisissez le menu d'extension sur la gauche.
1. Dans le panneau de navigation de la console, choisissez **Workgroups** (Groupes de travail).
1. Sur la page **Workgroups** (Groupes de travail), choisissez **Create workgroup** (Créer un groupe de travail).
1. Sur la page **Create workgroup** (Créer un groupe de travail), dans la section **Query engine version** (Version du moteur de requête), effectuez l'une des opérations suivantes :
+ Choisissez **Automatic** (Automatique) pour laisser Athena décider quand mettre à jour de votre groupe de travail. Il s’agit du paramètre par défaut.
+ Choisissez **Manual** (Manuel) pour choisir manuellement une version de moteur différente si elle est disponible.
1. Saisissez les informations pour les autres champs si nécessaire. Pour plus d'informations sur les autres champs, voir [Créer un groupe de travail](creating-workgroups.md).
1. Choisissez **Create workgroup** (Créer un groupe de travail).
## Essai des requêtes avant la mise à niveau d’une version du moteur
Lorsqu'un groupe de travail est mis à jour vers une nouvelle version du moteur, certaines de vos requêtes peuvent être interrompues en raison d'incompatibilités. Pour vous assurer que la mise à jour de votre moteur se déroule sans problème, vous pouvez tester vos requêtes à l'avance.
**Essai de vos requêtes avant une mise à jour de la version du moteur**
1. Vérifiez la version du moteur du groupe de travail que vous utilisez. La version du moteur que vous utilisez est affichée sur la page **Workgroups** (Groupes de travail) dans la colonne **Query engine version** (Version du moteur de requête) pour le groupe de travail. Pour de plus amples informations, veuillez consulter [Recherche de la version du moteur pour un groupe de travail](#engine-versions-changing-finding-the-query-engine-version-for-a-workgroup).
1. Créez un groupe de travail de test qui utilise la nouvelle version du moteur. Pour de plus amples informations, veuillez consulter [Spécification de la version du moteur lors de la création d’un groupe de travail](#engine-versions-changing-specifying-the-engine-version-when-you-create-a-workgroup).
1. Utilisez le nouveau groupe de travail pour exécuter les requêtes que vous voulez tester.
1. Si une requête échoue, vérifiez les changements importants apportés au nouveau moteur qui pourraient affecter la requête. Certaines modifications peuvent nécessiter la mise à jour de la syntaxe de vos requêtes.
1. Si vos requêtes échouent toujours, contactez AWS Support pour obtenir de l'aide. Dans la AWS Management Console, sélectionnez **Assistance**, puis **Centre d’assistance**, ou bien posez une question sur [AWS re:Post](https://repost.aws/tags/TA78iVOM7gR62_QqDe2-CmiA/amazon-athena) en utilisant la balise **Amazon Athena**.
## Résolution des problèmes de requêtes qui échouent après une mise à niveau de la version du moteur
Si une requête échoue après une mise à niveau de la version du moteur, vérifiez les changements importants apportés, y compris ceux pouvant affecter la syntaxe de vos requêtes.
Si vos requêtes échouent toujours, contactez AWS Support pour obtenir de l'aide. Dans le AWS Management Console, choisissez **Support**, **Support Center** ou posez une question sur [AWS Re:post](https://repost.aws/tags/TA78iVOM7gR62_QqDe2-CmiA/amazon-athena) en utilisant le tag **Amazon Athena**.