Utilisation de requêtes enregistrées - Amazon Athena

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.

Utilisation de requêtes enregistrées

Vous pouvez utiliser la console Athena pour enregistrer, modifier, exécuter, renommer et supprimer les requêtes que vous créez dans l'éditeur de requêtes.

Considérations et restrictions

  • Vous pouvez mettre à jour le nom, la description et le texte de requête des requêtes enregistrées.

  • Vous pouvez uniquement mettre à jour les requêtes dans votre propre compte.

  • Vous ne pouvez pas modifier le groupe de travail ou la base de données auquel la requête appartient.

  • Athena ne conserve pas d'historique des modifications de requêtes. Si vous souhaitez conserver une version particulière d'une requête, enregistrez-la sous un autre nom.

Utilisation de requêtes enregistrées dans la console Athena

Pour enregistrer une requête et lui attribuer un nom
  1. Dans l'éditeur de requêtes de la console Athena, saisissez ou exécutez une requête.

  2. Au-dessus de la fenêtre de l'éditeur de requêtes, sur l'onglet de la requête, choisissez les trois points verticaux, puis choisissez Save as (Enregistrer sous).

  3. Dans la boîte de dialogue Choose a name (Choisir un nom), saisissez un nom pour la requête et une description facultative. Vous pouvez utiliser la fenêtre extensible Preview SQL query (Aperçu de la requête SQL) pour vérifier le contenu de la requête avant de l'enregistrer.

  4. Choisissez Save query (Enregistrer la requête).

    Dans l'éditeur de requêtes, l'onglet de la requête affiche le nom que vous avez spécifié.

Pour exécuter une requête enregistrée
  1. Dans la console Athena, choisissez l'onglet Saved queries (Requêtes enregistrées).

  2. Dans la liste Saved queries (Requêtes enregistrées), choisissez l'ID de la requête que vous souhaitez exécuter.

    L'éditeur de requêtes affiche la requête que vous avez choisie.

  3. Cliquez sur Run (Exécuter).

Pour modifier une requête enregistrée
  1. Dans la console Athena, choisissez l'onglet Saved queries (Requêtes enregistrées).

  2. Dans la liste Saved queries (Requêtes enregistrées), choisissez l'ID de la requête que vous souhaitez modifier.

  3. Modifiez la requête dans l'éditeur de requêtes.

  4. Effectuez l'une des étapes suivantes :

    • Pour exécuter la requête, choisissez ensuite Run (Exécuter).

    • Pour enregistrer la requête, cliquez sur les trois points verticaux de l'onglet de la requête, puis choisissez Save as (Enregistrer sous).

    • Pour enregistrer la requête sous un autre nom, cliquez sur les trois points verticaux de l'onglet de la requête, puis choisissez Save as (Enregistrer sous).

Renommer ou supprimer une requête enregistrée déjà affichée dans l'éditeur de requêtes
  1. Choisissez les trois points verticaux de l'onglet de la requête, puis choisissez Rename (Renommer) ou Delete (Supprimer).

  2. Suivez les instructions pour renommer ou supprimer la requête.

Renommer une requête enregistrée non affichée dans l'éditeur de requêtes
  1. Dans la console Athena, choisissez l'onglet Saved queries (Requêtes enregistrées).

  2. Cochez la case en regard de la requête que vous voulez renommer.

  3. Choisissez Rename (Renommer).

  4. Dans Rename query (Renommer la requête), modifiez le nom et la description de la requête. Vous pouvez utiliser la fenêtre extensible Preview SQL query (Aperçu de la requête SQL)pour vérifier le contenu de la requête avant de la renommer.

  5. Choisissez Rename query (Renommer la requête).

    La requête renommée apparaît dans la liste Saved queries (Requêtes enregistrées).

Supprimer une requête enregistrée non affichée dans l'éditeur de requêtes
  1. Dans la console Athena, choisissez l'onglet Saved queries (Requêtes enregistrées).

  2. Cochez une ou plusieurs cases pour les requêtes que vous souhaitez supprimer.

  3. Choisissez Supprimer.

  4. À l'invite de confirmation, choisissez Delete (Supprimer).

    Une ou plusieurs requêtes sont supprimées de la liste Saved queries (Requêtes enregistrées).

Utilisation de l'API Athena pour mettre à jour les requêtes enregistrées

Pour plus d'informations sur l'utilisation de l'API Athena pour mettre à jour une requête enregistrée, veuillez consulter l'action UpdateNamedQuery dans la référence de l'API Athena.