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 à 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 code SQL. 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](analysis-rules-aggregation.md) 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](glossary.md#glossary-agg-analysis-rule)
+ Deux tables (une pour chaque membre) qui utilisent toutes deux la [règle d'analyse de liste](glossary.md#glossary-list-analysis-rule)
+ 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 requêtes SQL manuellement, consultez[Interrogation de tables configurées à l'aide de l'éditeur de code SQL](use-sql-editor.md).
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 Analyse** 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.
**Topics**
+ [Utiliser le générateur d'analyse pour interroger une seule table (agrégation)](#use-analysis-builder-one-table)
+ [Utilisez le générateur d'analyse pour interroger deux tables (agrégation ou liste)](#use-analysis-builder-two-tables)
## 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](analysis-rules-aggregation.md) sans JOIN obligation.
**Pour utiliser le générateur d'analyse pour interroger une seule table**
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 les **capacités de vos membres** ont le statut **Exécuter des requêtes**.
1. 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, c'est peut-être pour les raisons suivantes :
La table n'a pas été [associée](associate-configured-table.md).
Aucune [règle d'analyse n'est configurée](add-analysis-rule.md) dans le tableau.
1. Dans la section **Analyse**, activez l'**interface utilisateur du générateur d'analyse**.
1. 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.
1. (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.
1. (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.
1. (Facultatif) Pour **Ajouter une description — facultatif**, entrez une description pour aider à identifier la requête dans la liste des requêtes.
1. Développez le **code SQL de prévisualisation**.
1. Affichez le code SQL généré à partir du générateur d'analyse.
1. Pour copier le code SQL, choisissez **Copier**.
1. Pour modifier le code SQL, choisissez **Modifier dans l'éditeur de code SQL**.
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. 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).
## 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](analysis-rules-aggregation.md)
+ Deux tables (une pour chaque membre) qui utilisent toutes deux la [règle d'analyse de liste](analysis-rules-list.md)
+ 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 à 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 les **capacités de vos membres** ont le statut **Exécuter des requêtes**.
1. Dans l'onglet **Analyse**, sous **Tables**, visualisez 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](associate-configured-table.md).
Aucune [règle d'analyse n'est configurée pour](add-analysis-rule.md) les tables.
1. Dans la section **Analyse**, activez l'**interface utilisateur du générateur d'analyse**.
1. 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.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/clean-rooms/latest/userguide/query-data-analysis-builder.html)
1. Développez le **code SQL de prévisualisation**.
1. Affichez le code SQL généré à partir du générateur d'analyse.
1. Pour copier le code SQL, choisissez **Copier**.
1. Pour modifier le code SQL, choisissez **Modifier dans l'éditeur de code SQL**.
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. 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).