Interrogation de tables configurées à l'aide de l'éditeur de SQL code

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

L'éditeur de SQL code est affiché par défaut. Si vous souhaitez utiliser le générateur d'analyse pour créer des requêtes, consultezUtilisation du générateur d'analyse.

Important

Si vous commencez à écrire une SQL requête 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 SQL commandes, fonctions et conditions. Pour plus d'informations, consultez la AWS Clean Rooms SQLréférence.

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 SQL de code

1. Connectez-vous à la AWS Clean Rooms console AWS Management Console et ouvrez-la avec votre Compte AWS (si vous ne l'avez pas encore fait).

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

3. Choisissez la collaboration dont le statut de compétences de vos membres est Query.

4. Dans l'onglet Requêtes, accédez à la section Analyse.

   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.

5. Dans l'onglet Requêtes, 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.

   • Aucune règle d'analyse n'est configurée pour les tables.

6. (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 (+).

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

   (Facultatif) Si vous souhaitez utiliser un exemple de requête

   (Facultatif) Si vous souhaitez insérer des noms de colonnes ou des fonctions

   Sélectionnez les trois points verticaux à côté du tableau. Sous Insérer dans l'éditeur, sélectionnez Exemple de requête. Note L'insertion d'une requête d'exemple ajoute la requête déjà dans l'éditeur. L'exemple de requête apparaît. Toutes les tables répertoriées sous Tables sont incluses dans la requête. Modifiez les valeurs de l'espace réservé dans la requête.

   Sélectionnez les trois points verticaux à côté d'une colonne. Sous Insérer dans l'éditeur, sélectionnez Nom de colonne. Pour insérer manuellement une fonction autorisée sur une colonne, sélectionnez les trois points verticaux à côté d'une colonne, sélectionnez Insérer dans l'éditeur, puis sélectionnez le nom de la fonction autorisée (par exemple INNER JOINSUM, SUMDISTINCT, ouCOUNT). Appuyez sur Ctrl + 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. Modifiez les valeurs de l'espace réservé dans la requête.

8. Pour la livraison des résultats, spécifiez qui peut recevoir les résultats dans Envoyer les résultats à.

9. 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.

10. Consultez les résultats.

    Pour de plus amples informations, veuillez consulter Utilisation des résultats de requête.

11. Continuez à ajuster les paramètres et réexécutez votre requête, ou cliquez sur le bouton + 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.