Interrogation à l'aide du générateur d'analyse

Vous pouvez utiliser le générateur d'analyse pour créer des requêtes sans avoir à écrire de SQL code. Avec le générateur d'analyse, vous pouvez créer une requête pour une collaboration qui possède :

• Une table unique qui utilise la règle d'analyse d'agrégation sans JOIN obligation

• Deux tables (une pour chaque membre) qui utilisent toutes deux la règle d'analyse d'agrégation

• Deux tables (une pour chaque membre) qui utilisent toutes deux la règle d'analyse de liste

• Deux tables (une pour chaque membre) qui utilisent toutes deux la règle d'analyse d'agrégation et deux tables (une pour chaque membre) qui utilisent toutes deux la règle d'analyse de liste

Si vous souhaitez écrire des SQL requêtes manuellement, consultezInterrogation de tables configurées à l'aide de l'éditeur de SQL code.

Le générateur d'analyse apparaît sous forme d'option d'interface utilisateur du générateur d'analyse dans la section Analyse de l'onglet Requêtes de la AWS Clean Rooms console.

Important

Si vous activez l'interface utilisateur du générateur d'analyse, que vous commencez à créer une requête dans le générateur d'analyse, puis que vous désactivez l'interface utilisateur du générateur d'analyse, votre requête n'est pas enregistrée.

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.

Les rubriques suivantes expliquent comment utiliser le générateur d'analyse.

Utiliser le générateur d'analyse pour interroger une seule table (agrégation)

Cette procédure explique comment utiliser l'interface utilisateur du générateur d'analyse dans la AWS Clean Rooms console pour créer une requête. La requête concerne une collaboration comportant une seule table qui utilise la règle d'analyse d'agrégation sans JOIN requis.

Pour utiliser le générateur d'analyse pour interroger une seule table

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, sous Tables, consultez la table et le type de règle d'analyse associé. (Le type de règle d'analyse doit être la règle d'analyse d'agrégation.)

   Note

   Si le tableau que vous attendez ne s'affiche pas, c'est peut-être pour les raisons suivantes :

   • La table n'a pas été associée.

   • Aucune règle d'analyse n'est configurée dans le tableau.

5. Dans la section Analyse, activez l'interface utilisateur du générateur d'analyse.

6. Créez une requête.

   Si vous souhaitez voir toutes les mesures d'agrégation, passez à l'étape 9.

   1. Pour Choose metrics, passez en revue les métriques agrégées qui ont été présélectionnées par défaut et supprimez toute métrique si nécessaire.

   2. (Facultatif) Pour Ajouter des segments — facultatif, choisissez un ou plusieurs paramètres.

      Note

      Ajouter des segments : cette option n'est affichée que si des dimensions sont spécifiées pour le tableau.

   3. (Facultatif) Pour Ajouter des filtres : facultatif, choisissez Ajouter un filtre, puis choisissez un paramètre, un opérateur et une valeur.

      Pour ajouter d'autres filtres, choisissez Ajouter un autre filtre.

      Pour supprimer un filtre, choisissez Supprimer.

      Note

      ORDER BY n'est pas pris en charge pour les requêtes d'agrégation.

      Seul le AND l'opérateur est pris en charge dans les filtres.

   4. (Facultatif) Pour Ajouter une description — facultatif, entrez une description pour aider à identifier la requête dans la liste des requêtes.

7. Développez le SQLcode de prévisualisation.

   1. Affichez le SQL code généré à partir du générateur d'analyse.

   2. Pour copier le SQL code, choisissez Copier.

   3. Pour modifier le SQL code, choisissez Modifier dans l'éditeur de SQL code.

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

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

Utilisez le générateur d'analyse pour interroger deux tables (agrégation ou liste)

Cette procédure décrit comment utiliser le générateur d'analyse de la AWS Clean Rooms console pour créer une requête pour une collaboration qui possède :

• Deux tables (une pour chaque membre) qui utilisent toutes deux la règle d'analyse d'agrégation

• Deux tables (une pour chaque membre) qui utilisent toutes deux la règle d'analyse de liste

• Deux tables (une pour chaque membre) qui utilisent toutes deux la règle d'analyse d'agrégation et deux tables (une pour chaque membre) qui utilisent toutes deux la règle d'analyse de liste

Pour utiliser le générateur d'analyse pour interroger deux tables

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, sous Tables, consultez les deux tables et le type de règle d'analyse associé (règle d'analyse d'agrégation ou règle d'analyse de liste).

   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.

5. Dans la section Analyse, activez l'interface utilisateur du générateur d'analyse.

6. Créez une requête.

   Si la collaboration contient deux tables qui utilisent la règle d'analyse d'agrégation et deux tables qui utilisent la règle d'analyse de liste, choisissez d'abord Agrégation ou Liste, puis suivez les instructions en fonction de la règle d'analyse sélectionnée.

   Si les deux tables utilisent la règle d'analyse d'agrégation

   Si les deux tables utilisent la règle d'analyse de liste

   Pour Choose metrics, passez en revue les métriques agrégées qui ont été présélectionnées par défaut et supprimez toute métrique si nécessaire. Pour Match records, sélectionnez un ou plusieurs enregistrements. Note Lorsque vous utilisez le générateur d'analyse, vous ne pouvez effectuer de correspondance que sur une seule paire de colonnes. (Facultatif) Pour Ajouter des segments — facultatif, choisissez un ou plusieurs paramètres. Note Ajouter des segments : cette option n'est affichée que si des dimensions sont spécifiées pour le tableau. (Facultatif) Pour Ajouter des filtres : facultatif, choisissez Ajouter un filtre, puis choisissez un paramètre, un opérateur et une valeur. Pour ajouter d'autres filtres, choisissez Ajouter un autre filtre. Pour supprimer un filtre, choisissez Supprimer. Note ORDER BY n'est pas pris en charge pour les requêtes d'agrégation. Seul le AND l'opérateur est pris en charge dans les filtres. (Facultatif) Pour Ajouter une description — facultatif, entrez une description pour aider à identifier la requête dans la liste des requêtes récentes.

   Pour Choisir les attributs, passez en revue les attributs de liste qui ont été présélectionnés par défaut et supprimez toute métrique si nécessaire. Pour Match records, sélectionnez un ou plusieurs enregistrements. Note Lorsque vous utilisez le générateur d'analyse, vous ne pouvez effectuer de correspondance que sur une seule paire de colonnes. (Facultatif) Pour Ajouter des filtres : facultatif, choisissez Ajouter un filtre, puis choisissez un paramètre, un opérateur et une valeur. Pour ajouter d'autres filtres, choisissez Ajouter un autre filtre. Pour supprimer un filtre, choisissez Supprimer. Note LIMIT n'est pas pris en charge pour les requêtes de liste. Seul le AND l'opérateur est pris en charge dans les filtres. (Facultatif) Pour Ajouter une description — facultatif, entrez une description pour aider à identifier la requête dans la liste des requêtes récentes.

7. Développez le SQLcode de prévisualisation.

   1. Affichez le SQL code généré à partir du générateur d'analyse.

   2. Pour copier le SQL code, choisissez Copier.

   3. Pour modifier le SQL code, choisissez Modifier dans l'éditeur de SQL code.

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

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