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 l’éditeur de requêtes Aurora L’éditeur de requêtes Aurora vous permet d’exécuter des instructions SQL sur votre cluster de bases de données Aurora via la AWS Management Console. Vous pouvez exécuter des requêtes SQL, des instructions de manipulation de données (DML) et des instructions de définition de données (DDL). L’interface de console vous permet d’effectuer la maintenance de la base de données, de produire des rapports et de réaliser des tests SQL. Vous pouvez éviter de configurer la configuration réseau pour vous connecter à votre cluster de base de données à partir d'un système client distinct tel qu'une EC2 instance ou un ordinateur portable. L’éditeur de requête nécessite un cluster de bases de données Aurora pour lequel l’API RDS de données (API de données) est activée. Pour en savoir plus sur les clusters de bases de données qui prennent en charge l’API de données et sur son activation, consultez [Utilisation de l’API de données Amazon RDS](data-api.md). Le SQL que vous pouvez exécuter est limité par les contraintes de l’API de données. Pour plus d’informations, consultez [Limites de l’API de données Amazon RDS](data-api.limitations.md). ## Disponibilité de l’éditeur de requête L'éditeur de requêtes est disponible pour les clusters de base de données Aurora utilisant les versions des moteurs Aurora MySQL et Aurora PostgreSQL qui prennent en charge l'API Data, et dans Régions AWS le répertoire où l'API Data est disponible. Pour de plus amples informations, veuillez consulter [Régions et moteurs de base de données Aurora pris en charge pour l’API de données RDS](Concepts.Aurora_Fea_Regions_DB-eng.Feature.Data_API.md). ## Autorisation de l’accès à l’éditeur de requête Pour exécuter des requêtes dans l’éditeur de requête, les utilisateurs doivent y être autorisés. Vous pouvez autoriser un utilisateur à exécuter des requêtes dans l'éditeur de requêtes en ajoutant la `AmazonRDSDataFullAccess` politique, une stratégie prédéfinie Gestion des identités et des accès AWS (IAM), à cet utilisateur. **Note** Lorsque vous créez l’utilisateur IAM, assurez-vous d’utiliser le même nom d’utilisateur et le même mot de passe que ceux utilisés pour l’utilisateur de base de données, à savoir le nom d’utilisateur et le mot de passe administrateur. Pour plus d’informations, consultez [Création d’un utilisateur IAM dans votre Compte AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_create.html) dans le *Guide de l’utilisateur Gestion des identités et des accès AWS*. Vous pouvez aussi créer une politique IAM qui accorde l’accès à l’éditeur de requête. Après la création de la politique, ajoutez-la à chaque utilisateur ayant besoin d’accéder à l’éditeur de requête. La politique suivante fournit aux utilisateurs les autorisations minimales requises pour accéder à l’éditeur de requête. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "QueryEditor0", "Effect": "Allow", "Action": [ "secretsmanager:GetSecretValue", "secretsmanager:PutResourcePolicy", "secretsmanager:PutSecretValue", "secretsmanager:DeleteSecret", "secretsmanager:DescribeSecret", "secretsmanager:TagResource" ], "Resource": "arn:aws:secretsmanager:*:*:secret:rds-db-credentials/*" }, { "Sid": "QueryEditor1", "Effect": "Allow", "Action": [ "secretsmanager:GetRandomPassword", "tag:GetResources", "secretsmanager:CreateSecret", "secretsmanager:ListSecrets", "dbqms:CreateFavoriteQuery", "dbqms:DescribeFavoriteQueries", "dbqms:UpdateFavoriteQuery", "dbqms:DeleteFavoriteQueries", "dbqms:GetQueryString", "dbqms:CreateQueryHistory", "dbqms:UpdateQueryHistory", "dbqms:DeleteQueryHistory", "dbqms:DescribeQueryHistory", "rds-data:BatchExecuteStatement", "rds-data:BeginTransaction", "rds-data:CommitTransaction", "rds-data:ExecuteStatement", "rds-data:RollbackTransaction" ], "Resource": "*" } ] } ``` ------ Pour plus d’informations sur la création d’une stratégie IAM, consultez [Création de stratégies IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html) dans le *Guide de l’utilisateur Gestion des identités et des accès AWS*. Pour plus d’informations sur l’ajout d’une stratégie IAM, consultez [Ajout et suppression de stratégies IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html) dans le *Guide de l’utilisateur Gestion des identités et des accès AWS*. ## Exécution de requêtes dans l’éditeur de requête Avec l’éditeur de requête, vous pouvez exécuter des requêtes SQL dans un cluster de bases de données Aurora. Le SQL que vous pouvez exécuter est limité par les contraintes de l’API de données. Pour plus d’informations, consultez [Limites de l’API de données Amazon RDS](data-api.limitations.md). **Pour exécuter une requête dans l’éditeur de requête** 1. Connectez-vous à la console Amazon RDS AWS Management Console et ouvrez-la à [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)l'adresse. 1. Dans le coin supérieur droit duAWS Management Console, choisissez celui Région AWS dans lequel vous avez créé les clusters de base de données Aurora que vous souhaitez interroger. 1. Dans le panneau de navigation, choisissez **Databases (Bases de données)**. 1. Choisissez le cluster de bases de données Aurora sur lequel vous souhaitez exécuter des requêtes SQL. 1. Pour **Actions**, choisissez **Query (Requête)**. Si vous ne vous êtes pas connecté à la base de données au préalable, la page **Connect to database (Se connecter à la base de données)** s’ouvre. ![\[Page de connexion à la base de données de l’éditeur de requête\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/AuroraUserGuide/images/query-editor-connect.png) 1. Entrez les informations suivantes : 1. Pour **l’instance ou le cluster de bases de données**, choisissez le cluster de bases de données Aurora pour lequel vous souhaitez exécuter des requêtes SQL. 1. Pour **Database username (Nom d’utilisateur de la base de données)**, choisissez le nom de l’utilisateur de la base de données avec lequel vous souhaitez vous connecter, ou choisissez **Add new database credentials (Ajouter de nouvelles informations d’identification pour la base de données)**. Si vous choisissez **Add new database credentials (Ajouter de nouvelles informations d’identification pour la base de données)**, entrez le nom d’utilisateur pour les nouvelles informations d’identification de la base de données dans le champ **Enter database username (Entrer le nom d’utilisateur de la base de données)**. 1. Pour **Enter database password (Entrer le mot de passe de la base de données)**, saisissez le mot de passe de l’utilisateur de base de données que vous avez choisi. 1. Dans la dernière case, entrez le nom de la base de données ou du schéma que vous souhaitez utiliser pour le cluster de bases de données Aurora. 1. Choisissez **Connect to database (Se connecter à la base de données)**. **Note** Si la connexion aboutit, vos informations de connexion et d’authentification sont stockées dans AWS Secrets Manager. Vous n’avez pas besoin d’entrer à nouveau les informations de connexion. 1. Dans l’éditeur de requête, entrez la requête SQL que vous souhaitez exécuter au niveau de la base de données. ![\[Éditeur de requêtes avec une instruction SQL dans la zone de texte\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/AuroraUserGuide/images/query-editor.png) Chaque instruction SQL peut être validée automatiquement, ou vous pouvez exécuter les instructions SQL dans un script dans le cadre d’une transaction. Pour contrôler ce comportement, choisissez l’icône représentant un engrenage située au-dessus de la fenêtre de requête. ![\[Icône engrenage dans l’éditeur de requête\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/AuroraUserGuide/images/query-editor-gear.png) La fenêtre **Query Editor Settings (Paramètres de l’éditeur de requête)** apparaît. ![\[Query Editor Settings (Paramètres de l’éditeur de requête)\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/AuroraUserGuide/images/query-editor-settings.png) Si vous choisissez **Auto-commit**, chaque instruction SQL est automatiquement validée. Si vous choisissez **Transaction**, vous pouvez exécuter un groupe d’instructions dans un script. Les instructions sont automatiquement validées à la fin du script, sauf si elles sont explicitement validées ou annulées avant. En outre, vous pouvez également choisir d’arrêter un script en cours si une erreur se produit en activant **Stop on error (Arrêter en cas d’erreur)**. **Note** Dans un groupe d’instructions, les instructions en langage de définition de données (DDL) peuvent provoquer la validation d’anciennes instructions en langage de manipulation de données (DML). Vous pouvez également inclure des instructions `COMMIT` et `ROLLBACK` dans un groupe d’instructions au sein d’un script. Une fois que vous avez terminé la configuration dans la fenêtre **Query Editor Settings (Paramètres de l’éditeur de requête)**, choisissez **Save (Enregistrer)**. 1. Choisissez **Run (Exécuter)** ou appuyez sur Ctrl \$1 Entrée pour que l’éditeur de requête affiche les résultats de la requête. Une fois la requête exécutée, choisissez **Save (Enregistrer)** pour l’enregistrer dans **Saved queries (Requêtes enregistrées)**. Choisissez **Export to csv (Exporter au format csv)** pour enregistrer les résultats de la requête dans une feuille de calcul. Vous pouvez rechercher, modifier et exécuter de nouveau des anciennes requêtes. Pour ce faire, choisissez l’onglet **Recent (Récent)** ou **Saved queries (Requêtes enregistrées)**, sélectionnez le texte de la requête, puis choisissez **Run (Exécuter)**. Pour changer de base de données, choisissez **Change database (Changer de base de données)**. # Référence de l’API DBQMS (Database Query Metadata Service) Le service `dbqms` (Database Query Metadata Service, service de métadonnées de requête de base de données) est un service interne uniquement. Il fournit vos requêtes récentes et enregistrées pour l’éditeur de requêtes sur l’AWS Management Console pour plusieurs services AWS, dont Amazon RDS. **Topics** + [CreateFavoriteQuery](#CreateFavoriteQuery) + [CreateQueryHistory](#CreateQueryHistory) + [CreateTab](#CreateTab) + [DeleteFavoriteQueries](#DeleteFavoriteQueries) + [DeleteQueryHistory](#DeleteQueryHistory) + [DeleteTab](#DeleteTab) + [DescribeFavoriteQueries](#DescribeFavoriteQueries) + [DescribeQueryHistory](#DescribeQueryHistory) + [DescribeTabs](#DescribeTabs) + [GetQueryString](#GetQueryString) + [UpdateFavoriteQuery](#UpdateFavoriteQuery) + [UpdateQueryHistory](#UpdateQueryHistory) + [UpdateTab](#UpdateTab) ## CreateFavoriteQuery Crée une nouvelle requête préférée. Chaque utilisateur peut créer jusqu’à 1 000 requêtes enregistrées. Cette limite est sujette à changement à l’avenir. ## CreateQueryHistory Enregistre une nouvelle entrée d’historique des requêtes. ## CreateTab Enregistre un nouvel onglet de requête. Chaque utilisateur peut créer jusqu’à 10 onglets de requête. ## DeleteFavoriteQueries Supprime une ou plusieurs requêtes enregistrées. ## DeleteQueryHistory Supprime les entrées d’historique des requêtes. ## DeleteTab Supprime les entrées de l’onglet requête. ## DescribeFavoriteQueries Répertorie les requêtes enregistrées créées par un utilisateur dans un compte donné. ## DescribeQueryHistory Liste les entrées de l’historique des requêtes. ## DescribeTabs Répertorie les onglets de requête créés par un utilisateur dans un compte donné. ## GetQueryString Récupérer le texte complet de la requête à partir d’un ID de requête. ## UpdateFavoriteQuery Met à jour la chaîne de requête, la description, le nom ou la date d’expiration. ## UpdateQueryHistory Met à jour le statut de l’historique des requêtes. ## UpdateTab Met à jour le nom de l’onglet de requête et la chaîne de requête.