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.
# Ajouter une règle d'analyse à une table configurée
Les sections suivantes décrivent comment ajouter une règle d'analyse à votre table configurée. En définissant les règles d'analyse, vous pouvez autoriser le membre autorisé à exécuter des requêtes correspondant à une règle d'analyse spécifique prise en charge par. AWS Clean Rooms
AWS Clean Rooms prend en charge les types de règles d'analyse suivants :
+ [Règle d'analyse d'agrégation](analysis-rules-aggregation.md)
+ [Règle d'analyse des listes](analysis-rules-list.md)
+ [Règle d'analyse personnalisée dans AWS Clean Rooms](analysis-rules-custom.md)
Il ne peut y avoir qu'une seule règle d'analyse par table configurée. Vous pouvez configurer la règle d'analyse à tout moment avant d'associer les tables configurées à la collaboration.
**Important**
Si vous utilisez l'informatique cryptographique pour la collaboration Clean Rooms et que vous avez chiffré des tables de données, la règle d'analyse que vous ajoutez à la table configurée cryptée doit être cohérente avec la manière dont les données ont été cryptées. Par exemple, si vous avez chiffré les données pour SELECT (règle d'analyse d'agrégation), vous ne devez pas ajouter la règle d'analyse pour JOIN (règle d'analyse de liste).
**Topics**
+ [Ajouter une règle d'analyse d'agrégation à une table (flux guidé)](#add-agg-analysis-rule-console-wizard)
+ [Ajouter une règle d'analyse de liste à un tableau (flux guidé)](#add-list-analysis-rule-console-wizard)
+ [Ajouter une règle d'analyse personnalisée à un tableau (flux guidé)](#add-custom-analysis-rule-wizard)
+ [Ajouter une règle d'analyse à une table (éditeur JSON)](#add-analysis-rule-console-json-editor)
+ [Étapes suivantes](#add-analysis-rule-next-step)
## Ajouter une règle d'analyse d'agrégation à une table (flux guidé)
La *règle d'analyse d'agrégation* autorise les requêtes qui regroupent les statistiques sans révéler d'informations au niveau des lignes en utilisant COUNT et en utilisant des AVG dimensions facultatives. SUM
Cette procédure décrit le processus d'ajout d'une règle d'analyse d'agrégation à votre table configurée à l'aide de l'option **Flux guidé** de la AWS Clean Rooms console.
**Note**
Les tables configurées à l'aide de sources de données autres que S3 ne prennent en charge que [les règles d'analyse personnalisées](#add-custom-analysis-rule-wizard).
**Pour ajouter la règle d'analyse d'agrégation à une table (flux guidé)**
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, choisissez **Tables**.
1. Choisissez le tableau configuré.
1. Sur la page détaillée de la table configurée, choisissez **Configurer la règle d'analyse**.
1. Dans **Étape 1 : Choisissez le type de règle d'analyse**, sous **Type de règle d'analyse**, choisissez l'option **Agrégation**.
1. Sous **Méthode de création**, sélectionnez **Flux guidé**, puis **Suivant**.
1. Dans **Étape 2 : Spécifier les contrôles de requête**, pour les **fonctions d'agrégation** :
1. Choisissez une **fonction d'agrégation** dans le menu déroulant :
+ **COMPTER**
+ **DÉCOMPTE DISTINCT**
+ **SUM**
+ **SOMME DISTINCTE**
+ **AVG**
1. Choisissez les colonnes qui peuvent être utilisées dans la **fonction d'agrégation** dans le menu déroulant **Colonnes**.
1. (Facultatif) Choisissez **Ajouter une autre fonction** pour ajouter une autre fonction d'agrégation et associer une ou plusieurs colonnes à cette fonction.
**Note**
Au moins une fonction d'agrégation est requise.
1. (Facultatif) Choisissez **Supprimer** pour supprimer une fonction d'agrégation.
1. Pour les **commandes Join**,
1. Choisissez une option pour **Autoriser la table elle-même à être interrogée** :
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/clean-rooms/latest/userguide/add-analysis-rule.html)
1. Sous **Spécifier les colonnes de jointure**, choisissez les colonnes que vous souhaitez autoriser à utiliser dans l'INNERJOINinstruction.
Cette *option est facultative* si vous avez sélectionné **Oui** à l'étape précédente.
1. Sous **Spécifier les opérateurs autorisés pour la mise en correspondance**, choisissez quels opérateurs, le cas échéant, peuvent être utilisés pour faire correspondre plusieurs colonnes de jointure. Si vous sélectionnez deux JOIN colonnes ou plus, l'un de ces opérateurs est requis.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/clean-rooms/latest/userguide/add-analysis-rule.html)
1. *(Facultatif)* Pour les **contrôles de dimension**, dans la liste déroulante **Spécifier les colonnes de dimension**, choisissez les colonnes que vous souhaitez autoriser à utiliser dans l'instruction SELECT, ainsi que dans les ORDER BY parties WHERE GROUPBY, et de la requête.
**Note**
La fonction d'agrégation ou les colonnes de jointure ne peuvent pas être utilisées comme colonnes de **dimension**.
1. Pour les **fonctions scalaires**, choisissez une option pour **Quelles fonctions scalaires souhaitez-vous autoriser** ?
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/clean-rooms/latest/userguide/add-analysis-rule.html)
Pour de plus amples informations, veuillez consulter [Fonctions scalaires](analysis-rules-aggregation.md#scalar-functions).
1. Choisissez **Suivant**.
1. Dans **Étape 3 : Spécifier les contrôles des résultats de requête**, pour les **contraintes d'agrégation** :
1. Sélectionnez la liste déroulante pour chaque **nom de colonne**.
1. Sélectionnez la liste déroulante pour chaque **nombre minimum de valeurs distinctes** qui doivent être respectées pour que chaque ligne de sortie soit renvoyée, une fois la COUNT DISTINCT fonction appliquée à celle-ci.
1. Choisissez **Ajouter une contrainte** pour ajouter d'autres contraintes d'agrégation.
1. (Facultatif) Choisissez **Supprimer** pour supprimer une contrainte d'agrégation.
1. Pour les **analyses supplémentaires appliquées aux résultats**, sélectionnez une option en fonction de votre objectif.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/clean-rooms/latest/userguide/add-analysis-rule.html)
1. Choisissez **Suivant**.
1. Dans **Étape 4 : révision et configuration**, passez en revue les sélections que vous avez effectuées lors des étapes précédentes, modifiez-les si nécessaire, puis choisissez **Configurer la règle d'analyse**.
Un message de confirmation s'affiche indiquant que vous avez correctement configuré une règle d'analyse d'agrégation pour la table.
## Ajouter une règle d'analyse de liste à un tableau (flux guidé)
La *règle d'analyse de liste* autorise les requêtes qui produisent des listes au niveau des lignes indiquant le chevauchement entre la table associée et une table du membre autorisé à effectuer la requête.
Cette procédure décrit le processus d'ajout de la règle d'analyse de liste à votre table configurée à l'aide de l'option **Flux guidé** de la AWS Clean Rooms console.
**Note**
Les tables configurées à l'aide de sources de données autres que S3 ne prennent en charge que [les règles d'analyse personnalisées](#add-custom-analysis-rule-wizard).
**Pour ajouter une règle d'analyse de liste à un tableau (flux guidé)**
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, choisissez **Tables**.
1. Choisissez le tableau configuré.
1. Sur la page détaillée de la table configurée, choisissez **Configurer la règle d'analyse**.
1. Sous **Étape 1 : Choisissez le type de règle d'****analyse, sous Type de règle d'**analyse, choisissez l'option **Liste**.
1. Sous **Méthode de création**, sélectionnez **Flux guidé**, puis **Suivant**.
1. Dans **Étape 2 : Spécifier les contrôles de requête**, pour les **contrôles de jointure** :
1. Sous **Spécifier les colonnes de jointure**, choisissez les colonnes que vous souhaitez autoriser à utiliser dans l'INNERJOINinstruction.
1. Sous **Spécifier les opérateurs autorisés pour la mise en correspondance**, choisissez quels opérateurs, le cas échéant, peuvent être utilisés pour faire correspondre plusieurs colonnes de jointure. Si vous sélectionnez deux JOIN colonnes ou plus, l'un de ces opérateurs est requis.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/clean-rooms/latest/userguide/add-analysis-rule.html)
1. *(Facultatif)* Pour les **contrôles de liste**, dans la **liste déroulante Spécifier** les colonnes de liste, choisissez les colonnes que vous souhaitez autoriser à utiliser dans le résultat de la requête (c'est-à-dire utilisées dans l'SELECTinstruction) ou utilisées pour filtrer les résultats (c'est-à-dire l'WHEREinstruction).
1. Choisissez **Suivant**.
1. Dans **Étape 3 : Spécifier les contrôles des résultats de requête**, pour **Analyses supplémentaires appliquées à la sortie**, sélectionnez une option en fonction de votre objectif.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/clean-rooms/latest/userguide/add-analysis-rule.html)
1. Dans **Étape 4 : révision et configuration**, passez en revue les sélections que vous avez effectuées lors des étapes précédentes, modifiez-les si nécessaire, puis choisissez **Configurer la règle d'analyse**.
Un message de confirmation s'affiche indiquant que vous avez correctement configuré une règle d'analyse de liste pour la table.
## Ajouter une règle d'analyse personnalisée à un tableau (flux guidé)
La règle d'analyse personnalisée permet d'effectuer des requêtes ou des PySpark tâches SQL personnalisées sur une table configurée. La règle d'analyse personnalisée est requise si vous utilisez :
+ [Modèles d'analyse](create-analysis-template.md) permettant d'autoriser un ensemble spécifique de requêtes ou de PySpark tâches SQL préapprouvées ou un ensemble spécifique de comptes pouvant fournir des requêtes utilisant vos données.
+ [AWS Clean Rooms Confidentialité différentielle](differential-privacy.md) pour protéger contre les tentatives d'identification des utilisateurs.
+ Sources de données autres que S3, telles qu'Amazon Athena ou Snowflake.
Cette procédure décrit le processus d'ajout de la règle d'analyse personnalisée à votre table configurée à l'aide de l'option **Flux guidé** de la AWS Clean Rooms console.
**Pour ajouter une règle d'analyse personnalisée à un tableau (flux guidé)**
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, choisissez **Tables**.
1. Choisissez le tableau configuré.
1. Sur la page détaillée de la table configurée, choisissez **Configurer la règle d'analyse**.
1. Dans **Étape 1 : Choisissez le type de règle d'analyse**, sous **Type de règle d'analyse**, choisissez l'option **Personnalisée**.
1. Sous **Méthode de création**, sélectionnez **Flux guidé**, puis **Suivant**.
1. Dans **Étape 2 : Spécifier les contrôles d'analyse**, pour les **contrôles d'analyse directe**, choisissez une option en fonction de votre objectif.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/clean-rooms/latest/userguide/add-analysis-rule.html)
1. Dans **Étape 3 : Spécifier les contrôles des résultats d'analyse**,
1. Pour les **contrôles des résultats des Job**, notez qu'aucun contrôle de résultat supplémentaire n'est pris en charge.
1. Sous **Contrôles des résultats de la requête**, pour **Colonnes non autorisées en sortie**, choisissez les colonnes que vous souhaitez autoriser dans le résultat de la requête, en fonction de votre objectif.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/clean-rooms/latest/userguide/add-analysis-rule.html)
1. Pour les **analyses supplémentaires appliquées à la sortie**, choisissez si des analyses supplémentaires peuvent être appliquées à la sortie de la requête, en fonction de votre objectif.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/clean-rooms/latest/userguide/add-analysis-rule.html)
1. Choisissez **Suivant**.
1. (Facultatif) À **l'étape 4 : définir la confidentialité différentielle**, déterminez si vous souhaitez activer ou désactiver la confidentialité différentielle.
La confidentialité différentielle est une technique mathématiquement éprouvée pour protéger vos données contre les attaques de réidentification.
**Note**
AWS Clean Rooms La confidentialité différentielle n'est disponible que pour les collaborations dans lesquelles les données sont stockées dans Amazon S3.
Pour la **confidentialité différentielle**, choisissez d'activer ou de désactiver la confidentialité différentielle, en fonction de votre objectif.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/clean-rooms/latest/userguide/add-analysis-rule.html)
1. Dans **Étape 5 : révision et configuration**, passez en revue les sélections que vous avez effectuées lors des étapes précédentes, modifiez-les si nécessaire, puis choisissez **Configurer la règle d'analyse**.
Un message de confirmation s'affiche indiquant que vous avez correctement configuré une règle d'analyse personnalisée pour la table.
## Ajouter une règle d'analyse à une table (éditeur JSON)
La procédure suivante montre comment ajouter une règle d'analyse à une table à l'aide de l'option de l'**éditeur JSON** dans la AWS Clean Rooms console.
**Note**
Les tables configurées à l'aide de sources de données autres que S3 ne prennent en charge que [les règles d'analyse personnalisées](#add-custom-analysis-rule-wizard).
**Pour ajouter une agrégation, une liste ou une règle d'analyse personnalisée à une table (éditeur JSON)**
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, choisissez **Tables**.
1. Choisissez le tableau configuré.
1. Sur la page détaillée de la table configurée, choisissez **Configurer la règle d'analyse**.
1. Dans **Étape 1 : Choisissez le type de règle d'****analyse, sous Type de règle** d'analyse, choisissez l'option **Agrégation**, **Liste** ou **Personnalisée**.
1. Sous **Méthode de création**, sélectionnez l'**éditeur JSON**, puis cliquez sur **Suivant**.
1. À **l'étape 2 : Spécifier les contrôles**, vous pouvez choisir d'insérer une structure de requête (**Insérer un modèle**) ou d'insérer un fichier (**Importer depuis un fichier**).
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/clean-rooms/latest/userguide/add-analysis-rule.html)
1. Choisissez **Suivant**.
1. Dans **Étape 3 : révision et configuration**, passez en revue les sélections que vous avez effectuées lors des étapes précédentes, modifiez-les si nécessaire, puis choisissez **Configurer la règle d'analyse**.
Vous recevez un message de confirmation indiquant que vous avez correctement configuré une règle d'analyse pour la table.
## Étapes suivantes
Maintenant que vous avez configuré une règle d'analyse pour votre table configurée, vous êtes prêt à :
+ [Associer une table configurée à une collaboration](associate-configured-table.md)
+ [Interroger les tables de données](running-sql-queries.md) (en tant que membre pouvant effectuer des requêtes)