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 de requête 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 Athena à l’adresse https://console.aws.amazon.com/athena/.

2. Si le panneau de navigation de la console n'est pas visible, choisissez le menu d'extension sur la gauche.

   

3. Dans le panneau de navigation de la console Athena, choisissez Workgroups (Groupes de travail).

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

Modification de la version du moteur dans la console Athena

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 Exemples de politiques de groupe de travail.

Laisser Athena décider de la mise à jour du groupe de travail

1. Ouvrez la console Athena à l’adresse https://console.aws.amazon.com/athena/.

2. Si le panneau de navigation de la console n'est pas visible, choisissez le menu d'extension sur la gauche.

3. Dans le panneau de navigation de la console, choisissez Workgroups (Groupes de travail).

4. Dans la liste des groupes de travail, choisissez le lien pour le groupe de travail que vous voulez configurer.

5. Choisissez Edit (Modifier).

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

7. 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 Athena à l’adresse https://console.aws.amazon.com/athena/.

2. Si le panneau de navigation de la console n'est pas visible, choisissez le menu d'extension sur la gauche.

3. Dans le panneau de navigation de la console, choisissez Workgroups (Groupes de travail).

4. Dans la liste des groupes de travail, choisissez le lien pour le groupe de travail que vous voulez configurer.

5. Choisissez Edit (Modifier).

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

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

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

Modification de la version du moteur à l'aide du AWS CLI

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 Exemples de politiques de groupe de travail.

Spécifier la version du moteur lors de la création d'un groupe de travail

1. Ouvrez la console Athena à l’adresse https://console.aws.amazon.com/athena/.

2. Si le panneau de navigation de la console n'est pas visible, choisissez le menu d'extension sur la gauche.

3. Dans le panneau de navigation de la console, choisissez Workgroups (Groupes de travail).

4. Sur la page Workgroups (Groupes de travail), choisissez Create workgroup (Créer un groupe de travail).

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

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

7. Choisissez Create workgroup (Créer un groupe de travail).

Essai des requêtes avant la mise à jour 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 plus d’informations, consultez Recherche de la version du moteur de requête pour un groupe de travail.

2. Créez un groupe de travail de test qui utilise la nouvelle version du moteur. Pour plus d’informations, consultez Spécification de la version du moteur lors de la création d'un groupe de travail.

3. Utilisez le nouveau groupe de travail pour exécuter les requêtes que vous voulez tester.

4. Si une requête échoue, utilisez la version Référence de la version du moteur Athena pour vérifier les modifications qui pourraient affecter la requête. Certaines modifications peuvent nécessiter la mise à jour de la syntaxe de vos requêtes.

5. Si vos requêtes échouent toujours, contactez AWS Support pour obtenir de l'aide. Dans AWS Management Console, choisissez Support, Support Center (Centre de support), ou posez une question sur AWS re:Post en utilisant l'étiquette Amazon Athena.

Dépannage des requêtes qui échouent

Si une requête échoue après une mise à jour de la version du moteur, utilisez la version Référence de la version du moteur Athena pour vérifier s'il y a des interruptions ou d'autres modifications, y compris celles 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 en utilisant le tag Amazon Athena.