Ajouter une règle d'analyse à une table configurée - AWS Clean Rooms

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 :

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

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.

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 avec votre Compte AWS (si vous ne l'avez pas encore fait).

  2. Dans le volet de navigation de gauche, sélectionnez Tables configurées.

  3. Choisissez le tableau configuré.

  4. Sur la page détaillée de la table configurée, choisissez Configurer la règle d'analyse.

  5. À l'étape 1 : Choisissez le type, sous Type, laissez l'option d'agrégation sélectionnée par défaut.

  6. Sous Méthode de création, sélectionnez Flux guidé, puis Suivant.

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

      • COUNT

      • COUNT DISTINCT

      • SUM

      • SUM DISTINCT

      • AVG

    2. Choisissez les colonnes qui peuvent être utilisées dans la fonction d'agrégation dans le menu déroulant Colonnes.

    3. (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.

    4. (Facultatif) Choisissez Supprimer pour supprimer une fonction d'agrégation.

  8. Pour les commandes Join,

    1. Choisissez une option pour Autoriser la table elle-même à être interrogée :

      Si vous choisissez… Alors...
      Non, seul le chevauchement peut être interrogé La table ne peut être interrogée que lorsqu'elle est jointe à une table appartenant au membre qui peut effectuer la requête.
      Oui La table peut être interrogée seule ou lorsqu'elle est jointe à d'autres tables.
    2. 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.

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

      Si vous choisissez… Alors...
      AND Vous pouvez inclure AND dans le INNER JOIN match des conditions permettant de joindre une colonne à une autre entre les tables.
      OU Vous pouvez inclure OR dans les conditions de INNER JOIN correspondance pour combiner plusieurs correspondances de colonnes entre les tables. Cet opérateur logique est utile pour obtenir un taux de correspondance plus élevé.
  9. (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'SELECTinstruction, 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.

  10. Pour les fonctions scalaires, choisissez une option pour Quelles fonctions scalaires souhaitez-vous autoriser ?

    Si vous choisissez… Alors...
    Tous sont actuellement pris en charge par AWS Clean Rooms Vous autorisez toutes les fonctions scalaires actuellement prises en charge par AWS Clean Rooms.
    • Vous pouvez choisir Afficher la liste pour voir la liste complète des fonctions scalaires prises en charge dans AWS Clean Rooms.

    Une liste personnalisée Vous pouvez personnaliser les fonctions scalaires à autoriser.
    • Choisissez une ou plusieurs options dans la liste déroulante Spécifier les fonctions scalaires autorisées.

    Aucun Vous ne souhaitez autoriser aucune fonction scalaire.

    Pour de plus amples informations, veuillez consulter Fonctions scalaires.

  11. Choisissez Suivant.

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

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

    3. Choisissez Ajouter une contrainte pour ajouter d'autres contraintes d'agrégation.

    4. (Facultatif) Choisissez Supprimer pour supprimer une contrainte d'agrégation.

  13. Pour les analyses supplémentaires appliquées aux résultats, sélectionnez une option en fonction de votre objectif.

    Votre objectif Option recommandée
    Autoriser uniquement les requêtes directes sur cette table. Empêchez l'exécution d'analyses supplémentaires sur les résultats des requêtes. La table ne peut être utilisée que pour des requêtes directes. Non autorisé
    Autorisez mais n'exigez pas à la fois des requêtes directes et des analyses supplémentaires sur cette table. Autorisé
    Exiger que la table ne puisse être utilisée que dans des requêtes directes traitées avec l'une des analyses supplémentaires requises. Les requêtes directes sur cette table doivent être traitées ultérieurement avant de pouvoir être renvoyées. Obligatoire
  14. Choisissez Suivant.

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

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 avec votre Compte AWS (si vous ne l'avez pas encore fait).

  2. Dans le volet de navigation de gauche, sélectionnez Tables configurées.

  3. Choisissez le tableau configuré.

  4. Sur la page détaillée de la table configurée, choisissez Configurer la règle d'analyse.

  5. À l'étape 1 : Choisissez le type, sous Type, choisissez l'option Liste.

  6. Sous Méthode de création, sélectionnez Flux guidé, puis Suivant.

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

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

      Si vous choisissez… Alors...
      AND Vous pouvez inclure AND dans le INNER JOIN match des conditions permettant de joindre une colonne à une autre entre les tables.
      OU Vous pouvez inclure OR dans les conditions de INNER JOIN correspondance pour combiner plusieurs correspondances de colonnes entre les tables. Cet opérateur logique est utile pour obtenir un taux de correspondance plus élevé.
  8. (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).

  9. Choisissez Suivant.

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

    Votre objectif Option recommandée
    Autoriser uniquement les requêtes directes sur cette table. Empêchez l'exécution d'analyses supplémentaires sur les résultats des requêtes. La table ne peut être utilisée que pour des requêtes directes. Non autorisé
    Autorisez mais n'exigez pas à la fois des requêtes directes et des analyses supplémentaires sur cette table. Autorisé
    Exiger que la table ne puisse être utilisée que dans des requêtes directes traitées avec l'une des analyses supplémentaires requises. Les requêtes directes sur cette table doivent être traitées ultérieurement avant de pouvoir être renvoyées. Obligatoire
  11. 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 SQL des requêtes personnalisées sur une table configurée. La règle d'analyse personnalisée est requise si vous utilisez :

  • modèles d'analyse : pour autoriser un ensemble spécifique de SQL requêtes préapprouvées ou un ensemble spécifique de comptes pouvant fournir des requêtes utilisant vos données

  • confidentialité différentielle — pour protéger contre les tentatives d'identification des utilisateurs

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 avec votre Compte AWS (si vous ne l'avez pas encore fait).

  2. Dans le volet de navigation de gauche, sélectionnez Tables configurées.

  3. Choisissez le tableau configuré.

  4. Sur la page détaillée de la table configurée, choisissez Configurer la règle d'analyse.

  5. À l'étape 1 : Choisissez le type, sous Type, choisissez l'option Personnalisée.

  6. Sous Méthode de création, sélectionnez Flux guidé, puis Suivant.

  7. À l'étape 2 : 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.

    1. Pour une confidentialité différentielle :

      Si tu... Ensuite, choisissez...
      Disposez de données de niveau utilisateur et vous souhaitez être protégé contre les tentatives de réidentification Allumez
      Vous ne disposez pas de données de niveau utilisateur ou n'avez pas besoin de protection contre les tentatives de réidentification Éteindre
    2. Si vous avez choisi d'activer la confidentialité différentielle, sélectionnez la colonne Identifiant utilisateur qui contient l'identifiant unique de vos utilisateurs, par exemple la user_id colonne dont vous souhaitez protéger la confidentialité.

      Pour activer la confidentialité différentielle pour deux tables ou plus dans le cadre d'une collaboration, vous devez configurer la même colonne que la colonne Identifiant utilisateur dans les deux règles d'analyse afin de conserver une définition cohérente des utilisateurs entre les tables. En cas de mauvaise configuration, le membre autorisé à effectuer une requête reçoit un message d'erreur indiquant qu'il a le choix entre deux colonnes afin de calculer le nombre de contributions des utilisateurs (par exemple, le nombre d'impressions publicitaires effectuées par un utilisateur) lors de l'exécution de la requête.

    3. Choisissez Suivant.

  8. Dans Étape 3 : Spécifier les contrôles de requête,

    1. Pour Type de contrôle, choisissez une option en fonction de votre objectif.

      Votre objectif Option
      Passez en revue chaque nouveau modèle d'analyse avant de l'exécuter sur votre table configurée Passez en revue chaque nouvelle analyse avant de l'autoriser à être exécutée sur cette table
      Permettez d'exécuter n'importe quel modèle d'analyse ou requête directe sur votre table configurée Autoriser toutes les requêtes créées par des collaborateurs spécifiques à s'exécuter sans révision sur ce tableau
    2. Sélectionnez l'une des méthodes suivantes :

      Si tu as choisi... Alors...
      Passez en revue chaque nouvelle analyse avant de l'autoriser à être exécutée sur cette table Sous Modèles d'analyse autorisés à être exécutés, choisissez Ajouter un modèle d'analyse, puis choisissez le modèle de collaboration et d'analyse appropriés dans les listes déroulantes.
      Autoriser toutes les requêtes créées par des collaborateurs spécifiques à s'exécuter sans révision sur ce tableau Sous Comptes AWS Autorisé à créer une requête, choisissez Ajouter Compte AWS, puis choisissez l'Compte AWS ID approprié.
  9. Choisissez Suivant.

  10. Dans Étape 4 : Spécifier les contrôles des résultats de requête,

    1. Pour les colonnes non autorisées en sortie, choisissez-en une en fonction de votre objectif.

      Votre objectif Option recommandée
      Autoriser le renvoi de toutes les colonnes dans les sorties de requête Aucun
      Interdire le renvoi de certaines colonnes dans les résultats des requêtes Liste personnalisée
    2. Sélectionnez l'une des méthodes suivantes :

      Si tu as choisi... Alors...
      Aucun Passez à Analyses supplémentaires appliquées à la sortie
      Liste personnalisée Sous Spécifier les colonnes interdites, choisissez les colonnes que vous souhaitez supprimer des résultats de requête.
    3. Pour les analyses supplémentaires appliquées à la sortie, sélectionnez une option en fonction de votre objectif.

      Votre objectif Option recommandée
      Autoriser uniquement les requêtes directes sur cette table. Empêchez l'exécution d'analyses supplémentaires sur les résultats des requêtes. La table ne peut être utilisée que pour des requêtes directes. Non autorisé
      Autorisez mais n'exigez pas à la fois des requêtes directes et des analyses supplémentaires sur cette table. Autorisation
      Exiger que la table ne puisse être utilisée que dans des requêtes directes traitées avec l'une des analyses supplémentaires requises. Les requêtes directes sur cette table doivent être traitées ultérieurement avant de pouvoir être renvoyées. Obligatoire
  11. Choisissez Suivant.

  12. 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 (JSONéditeur)

La procédure suivante montre comment ajouter une règle d'analyse à une table à l'aide de l'option d'JSONéditeur de la AWS Clean Rooms console.

Pour ajouter une agrégation, une liste ou une règle d'analyse personnalisée à une table (JSONéditeur)
  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 Tables configurées.

  3. Choisissez le tableau configuré.

  4. Sur la page détaillée de la table configurée, choisissez Configurer la règle d'analyse.

  5. À l'étape 1 : Choisissez le type, sous Type, choisissez l'option Agrégation, Liste ou Personnalisation.

  6. Sous Méthode de création, sélectionnez JSONéditeur, puis cliquez sur Suivant.

  7. À 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).

    Si vous choisissez… Alors...
    Insérer un modèle
    1. Spécifiez les paramètres de la règle d'analyse sélectionnée dans la définition de la règle d'analyse.

    2. Vous pouvez appuyer sur Ctrl + barre d'espace pour activer la saisie automatique.

    Pour plus d'informations sur les paramètres des règles d'analyse d'agrégation, consultezRègle d'analyse d'agrégation : contrôles des requêtes.

    Pour plus d'informations sur les paramètres des règles d'analyse de liste, consultezRègle d'analyse des listes : contrôles des requêtes.

    Importer depuis un fichier
    1. Sélectionnez votre JSON fichier sur votre disque local.

    2. Choisissez Ouvrir.

      La définition de la règle d'analyse affiche la règle d'analyse du fichier chargé.

  8. Choisissez Suivant.

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