

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Soglie minime di aggregazione
<a name="custom-min-agg-thresholds"></a>

L'aggregazione dei dati è una tecnica di miglioramento della privacy che aiuta a imporre l'anonimizzazione impedendo alle query di restituire risultati su individui o piccoli gruppi. Quando le soglie minime di aggregazione sono configurate nelle tabelle, AWS Clean Rooms elimina i risultati che non soddisfano la soglia minima specificata dal fornitore di dati.

**Topics**
+ [Soglie di aggregazione](#custom-min-agg-aggregation-thresholds)
+ [Sovrascrivere la soglia minima di aggregazione per colonne di output specifiche](#custom-min-agg-output-override)
+ [Consentire espressioni annidate nelle funzioni aggregate](#custom-min-agg-nested-expressions)
+ [Configurazione delle soglie minime di aggregazione nella console](#custom-min-agg-console)
+ [Considerazioni e limitazioni](#custom-min-agg-considerations)

## Soglie di aggregazione
<a name="custom-min-agg-aggregation-thresholds"></a>

È possibile configurare le soglie minime di aggregazione in una regola di analisi personalizzata per la tabella configurata. I fornitori di dati specificano i `identityColumns` e i`minimumIdentityCount`, N. I valori supportati per `minimumIdentityCount` sono compresi tra 2 e 100.000. Il `identityColumns` valore deve essere un tipo `string``varchar`, o`char`. Le soglie minime di aggregazione assicurano che ogni riga del risultato di una query SQL abbia almeno N soggetti di dati distinti che vi contribuiscono. Per informazioni su come `identityColumns` interagisce con i filtri di interrogazione, consulta. [Controlli di confronto](custom-comparison-controls.md)

L'esempio seguente imposta la soglia minima di aggregazione su 100 con `user_id` come valore: `identityColumns`

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

## Sovrascrivere la soglia minima di aggregazione per colonne di output specifiche
<a name="custom-min-agg-output-override"></a>

Le colonne di output hanno livelli di sensibilità diversi e i fornitori di dati possono applicare `minimumIdentityCount` valori diversi a seconda della colonna di output. Ad esempio, `campaign_id` potrebbe essere una colonna a bassa sensibilità con una soglia minima di 5 soggetti di dati distinti, mentre `postal_code` e `income_bracket` ottenere una soglia minima di 100 perché sono colonne ad alta sensibilità.

Accetta un'eccezione per colonna`0`, che esenta quella colonna di output dall'aggregazione minima o da un valore compreso tra 2 e 100.000.

L'esempio seguente imposta un'eccezione alla soglia di aggregazione minima per la colonna: `campaign_id`

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

## Consentire espressioni annidate nelle funzioni aggregate
<a name="custom-min-agg-nested-expressions"></a>

L'autorizzazione delle espressioni all'interno delle funzioni di aggregazione aumenta il rischio che gli interessati possano essere nuovamente identificati nelle interrogazioni effettuate in camera bianca. L'impostazione predefinita per `allowedAggregateExpressionType` è`COLUMNS_ONLY`, consigliata come configurazione avanzata per la privacy. Con questa impostazione, solo le colonne sono accettate all'interno di una funzione di aggregazione, ad esempio:
+ SUM(costo)
+ COUNT(DISTINCTcampaign\_id)

In alternativa, per le collaborazioni in cui il query runner è un partner affidabile, puoi consentire `ANY_EXPRESSION` una funzione di aggregazione interna. Questa impostazione aumenta la flessibilità delle query SQL che possono essere eseguite sui dati, ma introduce rischi per la privacy perché i query runner possono isolare piccoli gruppi all'interno di una funzione di aggregazione.

**È richiesta la revisione della privacy e della conformità**  
Prima di consentire le funzioni aggregate `ANY_EXPRESSION` interne, consultate i team addetti alla privacy, alla sicurezza, agli aspetti legali e alla conformità per assicurarvi che siano conformi ai requisiti della vostra organizzazione.

Di seguito è riportato un esempio di espressione in una funzione di aggregazione generalmente considerata sicura:
+ SUM(costo \* quantità)

Di seguito è riportato un esempio di espressione in una funzione di aggregazione considerata un rischio per la privacy:
+ SUM(CASEWHENzip\_code = '10001' stipendio 0) THEN ELSE END

Quello che segue è un esempio completo: `aggregationThresholds`

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

## Configurazione delle soglie minime di aggregazione nella console
<a name="custom-min-agg-console"></a>

Le soglie minime di aggregazione vengono configurate come parte dell'aggiunta di una regola di analisi personalizzata a una tabella configurata, dopo che la tabella configurata esiste. Per il flusso guidato completo delle regole di analisi personalizzate, consulta. [Aggiungere una regola di analisi personalizzata a una tabella (flusso guidato)](add-analysis-rule.md#add-custom-analysis-rule-wizard)

**Per configurare le soglie minime di aggregazione**

1. Accedi a Console di gestione AWS e apri la console all' AWS Clean Rooms indirizzo. [ https://console.aws.amazon.com/cleanrooms ](https://console.aws.amazon.com/cleanrooms/home)

1. Nel riquadro di navigazione a sinistra, scegli ** Tabelle**, quindi scegli la tabella configurata.

1. Nella pagina dei dettagli della tabella configurata, scegli ** Configura regola di analisi**.

1. Per il tipo di regola di ** analisi**, scegli ** Personalizzato**.

1. Scegli ** Rivedi ogni nuova analisi ** o ** Consenti qualsiasi analisi da parte di collaboratori ** specifici. I passaggi rimanenti seguono il percorso ** Consenti qualsiasi analisi da parte di collaboratori ** specifici.

1. Scegli ** Aggiungi account AWS ** per configurare quali partner possono inviare analisi su questa tabella configurata, quindi scegli quale consentire Account AWS .

1. Su ** Specifica i controlli dei risultati dell'analisi: opzionale**, per ** applicare le soglie di aggregazione? **, scegli Sì. ** **

1. Configura la soglia minima di aggregazione.

   1. Scegli la tua colonna relativa all'identità. La colonna dell'identità deve essere di `char` tipo `string``varchar`, o.

   1. Specifica il numero minimo di identità. I valori supportati sono compresi tra 2 e 100.000.

   1. **Il tipo aggregato ** è preconfigurato per ** Count distinct. **

1. Per ** consentire espressioni annidate nelle funzioni aggregate? **, l'impostazione predefinita è ** No. ** Se questa opzione viene lasciata disattivata, la configurazione migliora la privacy. Per ulteriori informazioni, consulta [Consentire espressioni annidate nelle funzioni aggregate](#custom-min-agg-nested-expressions).

1. (Facoltativo) Configura le sostituzioni delle colonne di output.

   1. Scegli ** Aggiungi sostituzione colonna. **

   1. Scegli la colonna di output dall'elenco a discesa.

   1. Specifica il numero minimo di identità. I valori supportati `0` consentono di esentare la colonna dall'aggregazione minima o tra 2 e 100.000.

   Per ulteriori informazioni, consulta [Sovrascrivere la soglia minima di aggregazione per colonne di output specifiche](#custom-min-agg-output-override).

1. (Consigliato) Configura le colonne consentite per il confronto.

   1. Per impostazione predefinita, tutte le colonne sono idonee per il confronto. La configurazione esplicita delle colonne consentite per il confronto letterale e da colonna a colonna è una configurazione migliorata in termini di privacy.

   1. Scegli ** Elenco personalizzato. **

   1. Scegli quali colonne sono consentite per il confronto letterale. Ad esempio, l'attivazione della `state` colonna consente al gestore della query di eseguire una query con un filtro letterale, ad esempio. `WHERE state = 'New York'`

   1. Scegli quali colonne possono essere utilizzate per il confronto da colonna a colonna. Ad esempio, l'attivazione della `state` colonna consente al gestore della query di eseguire un'unione tra tabelle con un confronto tra colonne, ad esempio. `JOIN my_table t ON t.state = partner_table.state`

   Per ulteriori informazioni, consulta [Controlli di confronto](custom-comparison-controls.md).

1. Scegli **Next (Successivo)**.

1. Scegli **Next (Successivo)**. La privacy differenziale è disattivata e non è supportata con soglie di aggregazione minime o controlli di confronto. Per ulteriori informazioni, consulta [Limitazioni](custom-considerations.md#custom-limitations).

1. Rivedi la configurazione delle regole di analisi personalizzate.

1. Scegli ** Configura regola di analisi**.

1. Associa la tabella configurata a una collaborazione. Per ulteriori informazioni, consulta [Fase 2: Associare una tabella configurata](associate-configured-table.md#associate-config-table).

## Considerazioni e limitazioni
<a name="custom-min-agg-considerations"></a>

Quando si utilizzano soglie minime di aggregazione, si applicano considerazioni e limitazioni. Per l'elenco completo, consulta [Considerazioni e limitazioni](custom-considerations.md).