

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.

# Interrogation de tables configurées à l'aide de l'éditeur de code SQL
<a name="use-sql-editor"></a>

En tant que membre habilité à effectuer des requêtes, vous pouvez créer une requête manuellement en écrivant du code SQL dans l'éditeur de code SQL. L'éditeur de code SQL se trouve dans la section **Analyse** de l'onglet **Analyse** de la AWS Clean Rooms console. 

L'éditeur de code SQL s'affiche par défaut. Si vous souhaitez utiliser le générateur d'analyse pour créer des requêtes, consultez[Interrogation à l'aide du générateur d'analyse](query-data-analysis-builder.md). 

**Important**  
Si vous commencez à écrire une requête SQL dans l'éditeur de code, puis que vous activez l'**interface utilisateur du générateur d'analyse**, votre requête n'est pas enregistrée.

AWS Clean Rooms prend en charge de nombreuses commandes, fonctions et conditions SQL. Pour plus d'informations, consultez la [référence AWS Clean Rooms SQL](https://docs.aws.amazon.com/clean-rooms/latest/sql-reference/sql-reference.html). 

**Astuce**  
Si une maintenance planifiée a lieu pendant l'exécution d'une requête, celle-ci est interrompue et annulée. Vous devez relancer la requête. 

**Pour interroger les tables configurées à l'aide de l'éditeur de code SQL**

1. Connectez-vous à la AWS Clean Rooms console AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/cleanrooms](https://console.aws.amazon.com/cleanrooms/home).

1. Dans le volet de navigation de gauche, sélectionnez **Collaborations**.

1. Choisissez la collaboration dont le statut de **capacité de vos membres** est défini sur **Exécuter des requêtes**.

1. Dans l'onglet **Analyse**, sous **Tables**, consultez la liste des tables et le type de règle d'analyse associé (règle d'**analyse d'agrégation, règle** **d'analyse de liste** ou **règle d'analyse personnalisée**).
**Note**  
Si les tables attendues ne figurent pas dans la liste, c'est peut-être pour les raisons suivantes :  
Les tables n'ont pas été [associées](associate-configured-table.md).
Aucune [règle d'analyse n'est configurée pour](add-analysis-rule.md) les tables.

1. (Facultatif) Pour afficher le schéma et les contrôles des règles d'analyse du tableau, développez le tableau en sélectionnant l'icône du signe plus (**\$1**).

1. Dans la section **Analyse**, pour le **mode Analyse**, sélectionnez **Écrire du code SQL**.
**Note**  
La section **Analyse** s'affiche uniquement si le membre qui peut recevoir les résultats et le membre chargé de payer les coûts de calcul des requêtes ont rejoint la collaboration en tant que membre actif.

1. Créez la requête en la saisissant dans l'éditeur de code SQL.

   Pour plus d'informations sur les commandes et fonctions SQL prises en charge, consultez la [référence AWS Clean Rooms SQL.](https://docs.aws.amazon.com/clean-rooms/latest/sql-reference/sql-reference.html) 

   Vous pouvez également utiliser les options suivantes pour créer votre requête.

------
#### [ Use an example query ]

   Pour utiliser un exemple de requête

   1. Sélectionnez les trois points verticaux à côté du tableau.

   1. Sous **Insérer dans l'éditeur**, sélectionnez **Exemple de requête**.
**Note**  
L'insertion d'une **requête d'exemple** l'ajoute à la requête déjà présente dans l'éditeur.

      L'exemple de requête apparaît. Toutes les tables répertoriées sous **Tables** sont incluses dans la requête. 

   1. Modifiez les valeurs de l'espace réservé dans la requête.

------
#### [ Insert column names or functions ]

   Pour insérer un nom ou une fonction de colonne

   1. Sélectionnez les trois points verticaux à côté d'une colonne.

   1. Sous **Insérer dans l'éditeur**, sélectionnez **Nom de colonne**.

   1. Pour insérer manuellement une fonction autorisée sur une colonne, 

      1. Sélectionnez les trois points verticaux à côté d'une colonne.

      1. Sélectionnez **Insérer dans l'éditeur**.

      1. Sélectionnez le nom de la fonction autorisée (par exemple INNER JOINSUM,SUM DISTINCT, ouCOUNT).

   1. Appuyez sur **Ctrl** \$1 **Espace** pour afficher les schémas de table dans l'éditeur de code.
**Note**  
Les membres autorisés à effectuer des requêtes peuvent consulter et utiliser les colonnes de partition dans chaque association de tables configurée. Assurez-vous que la colonne de partition est étiquetée en tant que colonne de partition dans la AWS Glue table sous-jacente à la table configurée.

   1. Modifiez les valeurs de l'espace réservé dans la requête.

------

1. Spécifiez le **type de travailleur** pris en charge et le **nombre de travailleurs**. 

   Vous pouvez choisir le type d'instance et le nombre d'instances (travailleurs) pour exécuter vos requêtes SQL. 

   Pour le CR.1X, vous pouvez sélectionner jusqu'à 128 travailleurs ou un minimum de 4 travailleurs. 

   Pour le CR.4X, vous pouvez sélectionner jusqu'à 32 travailleurs ou un minimum de 4 travailleurs. 

   Utilisez le tableau suivant pour déterminer le type et le nombre de travailleurs dont vous avez besoin pour votre cas d'utilisation.    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/clean-rooms/latest/userguide/use-sql-editor.html)
**Note**  
Les différents types de travailleurs et le nombre de travailleurs entraînent des coûts associés. Pour en savoir plus sur les tarifs, consultez la section [AWS Clean Rooms Tarifs](https://aws.amazon.com/clean-rooms/pricing/).

1. Pour **Envoyer les résultats à**, spécifiez qui peut recevoir les résultats. 
**Note**  
Pour recevoir des résultats, le membre de la collaboration doit être configuré en tant que destinataire des résultats et doit participer activement à la collaboration (**statut : actif**)

1. (Membre autorisé à interroger uniquement) La case **Utiliser vos paramètres de résultats par défaut** est cochée par défaut. Gardez cette option sélectionnée si vous souhaitez conserver vos paramètres de résultats par défaut.

   Si vous souhaitez définir des paramètres de résultats différents pour cette requête, décochez la case **Utiliser vos paramètres de résultats par défaut**, puis choisissez ce qui suit. 

   1. **Format du résultat** (**CSV** ou **PARQUET**)

   1. **Fichiers de résultats** (**simples** ou **multiples**)

   1. **Destination des résultats dans Amazon S3**

   Chaque membre autorisé à recevoir des résultats peut spécifier un **format de résultat****, des fichiers** de **résultats et une destination de résultats différents dans Amazon S3**.

1. Pour définir les **propriétés de Spark** :

   1. Développez les **propriétés Spark**.

   1. Choisissez **Ajouter des propriétés Spark**.

   1. Dans la boîte de dialogue **des propriétés de Spark**, choisissez un **nom de propriété** dans la liste déroulante et entrez une **valeur**.

   Le tableau suivant fournit une définition pour chaque propriété.

   Pour plus d'informations sur les propriétés de Spark, consultez la section [Propriétés de Spark](https://spark.apache.org/docs/latest/configuration.html#spark-properties) dans la documentation d'Apache Spark.     
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/clean-rooms/latest/userguide/use-sql-editor.html)

1. Cliquez sur **Exécuter**.
**Note**  
Vous ne pouvez pas exécuter la requête si le membre qui peut recevoir les résultats n'a pas configuré les paramètres des résultats de la requête.

1. Consultez les **résultats**. 

   Pour de plus amples informations, veuillez consulter [Réception et utilisation des résultats d'analyse](receive-query-results.md).

1. Continuez à ajuster les paramètres et réexécutez votre requête, ou cliquez sur le bouton **\$1** pour démarrer une nouvelle requête dans un nouvel onglet.

**Note**  
AWS Clean Rooms vise à fournir un message d'erreur clair. Si un message d'erreur ne contient pas suffisamment de détails pour vous aider à résoudre le problème, contactez l'équipe chargée du compte. Fournissez-leur une description de la façon dont l'erreur s'est produite et du message d'erreur (y compris les éventuels identifiants). Pour de plus amples informations, veuillez consulter [Résolution des problèmes AWS Clean Rooms](troubleshooting.md).