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.

# Commencez à utiliser l'éditeur de requêtes SQL Aurora
<a name="getting-started-query-editor"></a>

Avec l'éditeur de requêtes Aurora DSQL, vous pouvez vous connecter en toute sécurité à vos clusters Aurora DSQL et exécuter des requêtes SQL directement depuis la console de AWS gestion sans installer ni configurer de clients externes. Il fournit un espace de travail intuitif avec mise en évidence syntaxique intégrée, saisie automatique et assistance intelligente au code. Vous pouvez rapidement explorer les objets du schéma, développer et exécuter des requêtes SQL et afficher les résultats, le tout au sein d'une seule interface.

Cette rubrique explique les étapes de connexion à un cluster, d'exécution de requêtes, d'affichage des résultats et d'exploration de fonctionnalités avancées telles que les plans d'exécution.

**Note**  
L'éditeur de requêtes est disponible dans toutes les régions où Aurora DSQL est pris en charge. Pour plus de détails sur la disponibilité régionale, consultez la section [Services AWS régionaux](https://aws.amazon.com/about-aws/global-infrastructure/regional-product-services/).

## Conditions préalables
<a name="query-editor-prerequisites"></a>

Avant de commencer, vérifiez que vous respectez les conditions requises suivantes :
+ Vous avez au moins un cluster Aurora DSQL disponible. Pour plus de détails sur la création de clusters, consultez[Étape 1 : création d’un cluster à une seule région Aurora DSQL](getting-started.md#getting-started-create-cluster).
+ Le point de terminaison de votre cluster est accessible au public. L'éditeur de requête ne prend pas en charge les clusters dont l'accès public est bloqué par des politiques basées sur les ressources ou les clusters gérés via des points de terminaison VPC. Pour plus de détails sur les restrictions d'accès, consultez [Blocage de l'accès public à l'aide de politiques basées sur les ressources dans Aurora DSQL](rbp-block-public-access.md) et[Gestion et connexion aux clusters SQL Amazon Aurora à l'aide de AWS PrivateLink](privatelink-managing-clusters.md).
+ Votre utilisateur ou rôle IAM dispose des autorisations requises pour accéder au cluster et s'y connecter. Pour plus de détails sur les autorisations, consultez[Utilisation des rôles de base de données et de l’authentification IAM](using-database-and-iam-roles.md).

## Utilisation de l'éditeur de requêtes
<a name="query-editor-working"></a>

### Ouvrez l'éditeur de requêtes
<a name="query-editor-open"></a>

**Pour ouvrir l'éditeur de requêtes**

1. Ouvrez la [console Aurora DSQL.](https://console.aws.amazon.com/dsql)

1. Dans le panneau de navigation, choisissez **Query Editor (Éditeur de requête)**.

Sur la page **Clusters**, vous pouvez également sélectionner le cluster que vous souhaitez interroger et choisir **Connect with Query editor** pour lancer directement l'éditeur.

**Note**  
L'état du travail et de la connexion ne sont pas enregistrés. Si vous quittez la console Aurora DSQL, fermez l'onglet du navigateur ou déconnectez-vous, vos connexions, le texte de votre requête et les résultats sont perdus.

### Connexion à un cluster
<a name="query-editor-connect"></a>

**Pour se connecter à un cluster**

1. S'il n'existe aucune connexion au cluster, l'éditeur affiche **Aucun cluster n'a été connecté**. Choisissez **Connect** ou sélectionnez **\$1** (Ajouter) dans le volet **Cluster Explorer** pour vous connecter à un cluster existant.

1. (Facultatif) Connectez-vous à plusieurs clusters ou au même cluster en utilisant différents rôles.

### Explorez les objets du cluster
<a name="query-editor-explore"></a>

L'explorateur de clusters affiche toutes les connexions de cluster disponibles et vous permet de parcourir des objets tels que des bases de données, des schémas, des tables et des vues. Il fournit également des actions courantes telles que **Actualiser**, **Créer une table** et d'autres options spécifiques au contexte.

### Exécution de requêtes
<a name="query-editor-run-queries"></a>

**Pour exécuter une requête**

1. Dans le volet de l'onglet de l'éditeur de requêtes, entrez votre instruction SQL. Par exemple :

   ```
   SELECT * FROM public.orders LIMIT 10;
   ```

1. Vérifiez le **contexte du cluster actif** affiché en haut à droite de l'onglet de requête. Cela indique la connexion au cluster associée à l'onglet de requête actuel.

1. (Facultatif) Utilisez le menu déroulant des **connexions** pour passer en revue toutes les connexions disponibles ou passer à un autre cluster. La modification de la connexion met à jour l'endroit où vos requêtes sont exécutées dans cet onglet.

1. Choisissez **Exécuter** pour exécuter la requête.

**Note**  
Chaque requête peut renvoyer jusqu'à 10 000 lignes dans le volet des résultats. Pour les ensembles de données plus volumineux, affinez votre requête à l'aide de filtres ou de limites.

### Examiner les résultats et les plans d'exécution
<a name="query-editor-view-results"></a>

Une fois la requête exécutée, passez en revue le résultat dans le **panneau Résultats** en bas de l'éditeur. Par défaut, chaque exécution de requête affiche l'onglet **Résultats (table)**, qui affiche le résultat de la requête sous forme de tableau.

Pour obtenir le plan d'exécution des requêtes, exécutez `EXPLAIN ANALYZE` ou obtenez `EXPLAIN ANALYZE VERBOSE` des informations supplémentaires sur les performances des requêtes. Pour plus de détails sur les plans d'exécution, consultez[Lecture des plans Aurora SQL EXPLAIN](reading-dsql-explain-plans.md).

**Astuce**  
La `EXPLAIN ANALYZE VERBOSE` commande affiche les estimations d'utilisation du DPU, y compris les valeurs de calcul, de lecture, d'écriture et de total du DPU, offrant ainsi une visibilité immédiate sur les ressources consommées par les instructions SQL individuelles.