View a markdown version of this page

Seuils d'agrégation minimaux - 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.

Seuils d'agrégation minimaux

L'agrégation des données est une technique renforçant la confidentialité qui permet de renforcer l'anonymisation en empêchant les requêtes de renvoyer des résultats concernant des individus ou de petits groupes. Lorsque des seuils d'agrégation minimaux sont configurés sur vos tables, AWS Clean Rooms supprime les résultats qui n'atteignent pas le seuil minimum spécifié par le fournisseur de données.

Seuils d'agrégation

Vous pouvez configurer des seuils d'agrégation minimaux dans une règle d'analyse personnalisée pour votre table configurée. Les fournisseurs de données spécifient le identityColumns et leminimumIdentityCount, N. Les valeurs prises en charge minimumIdentityCount sont comprises entre 2 et 100 000. La identityColumns valeur doit être un stringvarchar, ou un char type. Les seuils d'agrégation minimaux garantissent qu'au moins N sujets de données distincts contribuent à chaque ligne du résultat d'une requête SQL. Pour plus d'informations sur la manière dont les filtres de requête identityColumns interagissent, consultezContrôles de comparaison.

L'exemple suivant définit le seuil d'agrégation minimum à 100 avec user_id comme identityColumns valeur :

{ "aggregationThresholds": [ { "identityColumns": [ "user_id" ], "minimumIdentityCount": 100, "type": "COUNT_DISTINCT" } ] }

Remplacer le seuil d'agrégation minimum pour des colonnes de sortie spécifiques

Les colonnes de sortie ont des niveaux de sensibilité différents et les fournisseurs de données peuvent appliquer minimumIdentityCount des valeurs différentes en fonction de la colonne de sortie. Par exemple, il campaign_id peut s'agir d'une colonne à faible sensibilité avec un seuil minimum de 5 sujets de données distincts, tandis que postal_code et income_bracket obtenir un seuil minimum de 100 car il s'agit de colonnes à haute sensibilité.

Un remplacement par colonne est accepté0, ce qui exempte cette colonne de sortie de l'agrégation minimale ou d'une valeur comprise entre 2 et 100 000.

L'exemple suivant définit une dérogation au seuil d'agrégation minimum pour la campaign_id colonne :

{ "outputColumnThresholds": [ { "outputColumnName": "campaign_id", "minimumIdentityCount": 5 } ] }

Autoriser les expressions imbriquées dans les fonctions d'agrégation

L'autorisation d'expressions dans les fonctions d'agrégation augmente le risque que les personnes concernées puissent être réidentifiées dans les requêtes en salle blanche. Le paramètre par défaut pour allowedAggregateExpressionType estCOLUMNS_ONLY, qui est recommandé comme configuration de confidentialité améliorée. Avec ce paramètre, seules les colonnes sont acceptées dans une fonction d'agrégation, telle que :

  • SUM(coût)

  • COUNT(DISTINCTidentifiant_campagne)

Sinon, pour les collaborations où l'exécuteur de requêtes est un partenaire de confiance, vous pouvez ANY_EXPRESSION l'autoriser dans une fonction d'agrégation. Ce paramètre augmente la flexibilité des requêtes SQL qui peuvent être exécutées sur vos données, mais présente un risque de confidentialité car les exécuteurs de requêtes peuvent isoler de petits groupes au sein d'une fonction d'agrégation.

Examen de la confidentialité et de la conformité requis

Avant d'autoriser les fonctions d'agrégation ANY_EXPRESSION internes, consultez vos équipes chargées de la confidentialité, de la sécurité, des affaires juridiques et de la conformité pour vous assurer que cela est conforme aux exigences de votre organisation.

Voici un exemple d'expression dans une fonction d'agrégation qui est généralement considérée comme sûre :

  • SUM(coût * quantité)

Voici un exemple d'expression d'une fonction d'agrégation considérée comme présentant un risque pour la confidentialité :

  • SUM(CASEWHENzip_code = « 10001 » THEN salaire 0) ELSE END

Voici un aggregationThresholds exemple complet :

{ "aggregationThresholds": [ { "identityColumns": [ "user_id" ], "minimumIdentityCount": 100, "type": "COUNT_DISTINCT", "allowedAggregateExpressionType": "COLUMNS_ONLY", "outputColumnThresholds": [ { "outputColumnName": "campaign_id", "minimumIdentityCount": 5 } ] } ] }

Configuration des seuils d'agrégation minimaux dans la console

Vous configurez des seuils d'agrégation minimaux dans le cadre de l'ajout d'une règle d'analyse personnalisée à une table configurée, une fois que celle-ci existe. Pour le flux guidé par les règles d'analyse personnalisées complet, consultezAjouter une règle d'analyse personnalisée à un tableau (flux guidé).

Pour configurer des seuils d'agrégation minimaux
  1. Connectez-vous à Console de gestion AWS et ouvrez la AWS Clean Rooms console à l'adresse https://console.aws.amazon.com/cleanrooms.

  2. Dans le volet de navigation de gauche, choisissez Tables, puis choisissez la table que vous avez configurée.

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

  4. Pour Type de règle d'analyse, choisissez Personnalisé.

  5. Choisissez Revoir chaque nouvelle analyse ou Autoriser toute analyse par des collaborateurs spécifiques. Les étapes restantes suivent le chemin Autoriser toute analyse par des collaborateurs spécifiques.

  6. Choisissez Ajouter un compte AWS pour configurer les partenaires qui peuvent soumettre des analyses sur cette table configurée, puis choisissez celui Compte AWS à autoriser.

  7. Sur Spécifier les contrôles des résultats d'analyse : facultatif, pour Appliquer les seuils d'agrégation ? , choisissez Oui.

  8. Configurez le seuil d'agrégation minimum.

    1. Choisissez votre colonne d'identité. La colonne d'identité doit être de char type A stringvarchar, ou.

    2. Spécifiez votre nombre d'identité minimum. Les valeurs prises en charge sont comprises entre 2 et 100 000.

    3. Le type d'agrégat est préconfiguré pour Count distinct.

  9. Pour Autoriser les expressions imbriquées dans les fonctions d'agrégation ? , la valeur par défaut est Non. Si cette option est désactivée, la configuration de confidentialité améliorée est activée. Pour de plus amples informations, veuillez consulter Autoriser les expressions imbriquées dans les fonctions d'agrégation.

  10. (Facultatif) Configurez les remplacements de colonne de sortie.

    1. Choisissez Ajouter un remplacement de colonne.

    2. Choisissez votre colonne de sortie dans la liste déroulante.

    3. Spécifiez votre nombre d'identité minimum. Les valeurs prises en charge visent 0 à exempter la colonne de l'agrégation minimale, soit entre 2 et 100 000.

    Pour de plus amples informations, veuillez consulter Remplacer le seuil d'agrégation minimum pour des colonnes de sortie spécifiques.

  11. (Recommandé) Configurez les colonnes autorisées pour la comparaison.

    1. Par défaut, toutes les colonnes peuvent être comparées. La configuration explicite des colonnes autorisées pour la comparaison littérale et colonne à colonne constitue une configuration de confidentialité améliorée.

    2. Choisissez Liste personnalisée.

    3. Choisissez les colonnes autorisées pour la comparaison littérale. Par exemple, autoriser la state colonne permet au lanceur de requêtes d'exécuter une requête avec un filtre littéral, tel queWHERE state = 'New York'.

    4. Choisissez les colonnes qui peuvent être utilisées pour la comparaison colonne à colonne. Par exemple, autoriser la state colonne permet au lanceur de requêtes d'exécuter une jointure entre tables avec une comparaison de colonnes, telle queJOIN my_table t ON t.state = partner_table.state.

    Pour de plus amples informations, veuillez consulter Contrôles de comparaison.

  12. Choisissez Suivant.

  13. Choisissez Suivant. La confidentialité différentielle est désactivée et n'est pas prise en charge avec des seuils d'agrégation minimaux ou des contrôles de comparaison. Pour de plus amples informations, veuillez consulter Limitations.

  14. Passez en revue la configuration de vos règles d'analyse personnalisées.

  15. Choisissez Configurer la règle d'analyse.

  16. Associez le tableau configuré à une collaboration. Pour de plus amples informations, veuillez consulter Étape 2 : associer une table configurée.

Considérations et restrictions

Des considérations et des limites s'appliquent lorsque vous utilisez des seuils d'agrégation minimaux. Pour obtenir la liste complète, consultez Considérations et restrictions.