View a markdown version of this page

Effectuer des requêtes à l'aide du générateur d'analyses - AWS Clean Rooms
Utiliser le générateur d'analyse pour interroger une seule table (agrégation)Utilisez le générateur d'analyse pour interroger deux tables (agrégation ou liste)

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.

Effectuer des requêtes à l'aide du générateur d'analyses

Vous pouvez utiliser le générateur d'analyse pour créer des requêtes sans avoir à écrire de code SQL. À l'aide du générateur d'analyses, 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 qu'aucun JOIN ne soit requis

  • 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 des listes

  • 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 manuellement des requêtes SQL, consultezInterroger les tables configurées à l'aide de l'éditeur de code SQL.

Le générateur d'analyse apparaît en tant qu'option d'interface utilisateur du générateur d'analyses dans la section Analyse de l'onglet Analyse de la AWS Clean Rooms console.

Important

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

Astuce

Si une maintenance planifiée a lieu alors qu'une requête est en cours d'exécution, celle-ci est arrêtée 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 montre 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 qui possède une table unique qui utilise la règle d'analyse d'agrégation sans aucune JOIN exigence.

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

Connectez-vous à Console de gestion AWS et ouvrez la AWS Clean Rooms console à l'adresse https://console.aws.amazon.com/cleanrooms.

  1. Dans le volet de navigation de gauche, choisissez Collaborations.

  2. Choisissez la collaboration dont le statut «  Vos capacités de membre » est défini sur Exécuter des requêtes.

  3. Dans l'onglet Analyse, sous Tables, affichez le tableau 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, cela peut être dû aux raisons suivantes :

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

  5. 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 — facultatif n'est affiché 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 BYn'est pas pris en charge pour les requêtes d'agrégation.

      Seul l'ANDopérateur est pris en charge dans les filtres.

    4. (Facultatif) Pour Ajouter une description : facultatif, entrez une description permettant d'identifier la requête dans la liste des requêtes.

  6. Développez le code SQL de prévisualisation.

    1. Affichez le code SQL généré par le générateur d'analyse.

    2. Pour copier le code SQL, choisissez Copier.

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

  7. (Facultatif) Dans Compute Payer, sélectionnez le membre de la collaboration qui prend en charge les coûts de calcul des requêtes.

    Note

    S'il n'y a qu'un seul payeur candidat pour le calcul des requêtes dans la collaboration, ce payeur est défini par défaut sur ce payeur.

  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 exécutez à nouveau 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 le message d'erreur (y compris les identificateurs éventuels). 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 des listes

  • 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

Connectez-vous à Console de gestion AWS et ouvrez la AWS Clean Rooms console à l'adresse https://console.aws.amazon.com/cleanrooms.

  1. Dans le volet de navigation de gauche, choisissez Collaborations.

  2. Choisissez la collaboration dont le statut «  Vos capacités de membre » est défini sur Exécuter des requêtes.

  3. Dans l'onglet Analyse, sous Tables, affichez les deux tableaux et le type de règle d'analyse qui leur est associé (règle d'analyse d'agrégation ou règle d'analyse de liste).

    Note

    Si les tableaux que vous attendez ne figurent pas dans la liste, cela peut être dû aux raisons suivantes :

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

  5. 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 des listes

    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. Pour Match records, choisissez un ou plusieurs enregistrements.

      Note

      Lorsque vous utilisez le générateur d'analyse, vous ne pouvez faire correspondre qu'une seule paire de colonnes.

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

      Note

      Ajouter des segments — facultatif n'est affiché que si des dimensions sont spécifiées pour le tableau.

    4. (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 BYn'est pas pris en charge pour les requêtes d'agrégation.

      Seul l'ANDopérateur est pris en charge dans les filtres.

    5. (Facultatif) Pour Ajouter une description : facultatif, entrez une description permettant d'identifier la requête dans la liste des requêtes récentes.

    1. Pour Choisir les attributs, passez en revue les attributs de la liste qui ont été présélectionnés par défaut et supprimez toute métrique si nécessaire.

    2. Pour Match records, choisissez un ou plusieurs enregistrements.

      Note

      Lorsque vous utilisez le générateur d'analyse, vous ne pouvez faire correspondre qu'une seule paire de colonnes.

    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

      LIMITn'est pas pris en charge pour les requêtes de liste.

      Seul l'ANDopérateur est pris en charge dans les filtres.

    4. (Facultatif) Pour Ajouter une description : facultatif, entrez une description permettant d'identifier la requête dans la liste des requêtes récentes.

  6. Développez le code SQL de prévisualisation.

    1. Affichez le code SQL généré par le générateur d'analyse.

    2. Pour copier le code SQL, choisissez Copier.

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

  7. (Facultatif) Dans Compute Payer, sélectionnez le membre de la collaboration qui prend en charge les coûts de calcul des requêtes.

    Note

    S'il n'y a qu'un seul payeur candidat pour le calcul des requêtes dans la collaboration, ce payeur est défini par défaut sur ce payeur.

  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 exécutez à nouveau 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 le message d'erreur (y compris les identificateurs éventuels). Pour de plus amples informations, veuillez consulter Résolution des problèmes AWS Clean Rooms.