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. **Note** Les ressources Amazon Athena sont désormais accessibles dans Amazon SageMaker Unified Studio (version préliminaire), qui vous permet d'accéder aux données de votre organisation et d'agir en conséquence avec les meilleurs outils. Vous pouvez migrer les requêtes enregistrées d'un groupe de travail Athena vers un projet SageMaker Unified Studio, configurer des projets avec des groupes de travail Athena existants et conserver les autorisations nécessaires grâce aux mises à jour des rôles IAM. Pour plus d'informations, consultez la section [Migration des ressources Amazon Athena vers SageMaker Amazon Unified Studio (](https://github.com/aws/Unified-Studio-for-Amazon-Sagemaker/tree/main/migration/athena)version préliminaire). **Topics** + [Considérations et restrictions](#saved-queries-considerations-and-limitations) + [Enregistrement d’une requête avec un nom](saved-queries-name.md) + [Exécution d’une requête enregistrée](saved-queries-run.md) + [Modification d’une requête enregistrée](saved-queries-edit.md) + [Renommage ou suppression d’une requête enregistrée](saved-queries-rename-or-delete.md) + [Renommage d’une requête enregistrée non affichée](saved-queries-rename-not-displayed.md) + [Suppression d’une requête enregistrée non affichée](saved-queries-delete-not-displayed.md) + [Utilisation de l’API Athena pour mettre à jour des requêtes enregistrées](saved-queries-update-with-api.md) # Enregistrement d’une requête avec un nom **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. 1. 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). 1. 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. 1. 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é. # Exécution d’une requête enregistrée **Pour exécuter une requête enregistrée** 1. Dans la console Athena, choisissez l'onglet **Saved queries** (Requêtes enregistrées). 1. 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. 1. Cliquez sur **Exécuter**. # Modification d’une requête enregistrée **Pour modifier une requête enregistrée** 1. Dans la console Athena, choisissez l'onglet **Saved queries** (Requêtes enregistrées). 1. Dans la liste **Saved queries** (Requêtes enregistrées), choisissez l'ID de la requête que vous souhaitez modifier. 1. Modifiez la requête dans l'éditeur de requêtes. 1. 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). # Renommage ou suppression d’une requête enregistrée **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). 1. Suivez les instructions pour renommer ou supprimer la requête. # Renommage d’une requête enregistrée non affichée **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). 1. Cochez la case en regard de la requête que vous voulez renommer. 1. Choisissez **Rename (Renommer)**. 1. 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. 1. Choisissez **Rename query** (Renommer la requête). La requête renommée apparaît dans la liste **Saved queries** (Requêtes enregistrées). # Suppression d’une requête enregistrée non affichée **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). 1. Cochez une ou plusieurs cases pour les requêtes que vous souhaitez supprimer. 1. Sélectionnez **Delete (Supprimer)**. 1. À 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 des requêtes enregistrées Pour plus d'informations sur l'utilisation de l'API Athena pour mettre à jour une requête enregistrée, consultez l'[UpdateNamedQuery](https://docs.aws.amazon.com/athena/latest/APIReference/API_UpdateNamedQuery.html)action dans le Guide de référence de l'API Athena.