Configurazione di una regola di analisi in una tabella configurata

Le sezioni seguenti descrivono come configurare una regola di analisi nella tabella configurata. Definendo le regole di analisi, è possibile autorizzare il membro che può eseguire query a eseguire query che corrispondono a una regola di analisi specifica supportata da. AWS Clean Rooms

AWS Clean Roomssupporta i seguenti tipi di regole di analisi: aggregazione, elenco e personalizzata.

Può esserci una sola regola di analisi per tabella configurata.

Importante

Se si utilizza Cryptographic Computing per la collaborazione Clean Rooms e la collaborazione prevede tabelle di dati crittografate, la regola di analisi aggiunta alla tabella configurata crittografata deve essere coerente con il modo in cui i dati sono stati crittografati. Ad esempio, se hai crittografato i dati per SELECT (regola di analisi di aggregazione), non dovresti aggiungere la regola di analisi per JOIN (regola di analisi dell'elenco).

Per comprendere i tipi di regole di analisi disponibili inAWS Clean Rooms, vedereRegole di analisi in AWS Clean Rooms.

Per ulteriori informazioni sulla regola di analisi di aggregazione, vedereRegola di analisi di aggregazione.

Per ulteriori informazioni sulla regola di analisi degli elenchi, vedereRegola di analisi delle liste.

Per ulteriori informazioni sulla regola di analisi personalizzata, vedereRegola di analisi personalizzata in AWS Clean Rooms.

Dopo aver esaminato e compreso queste sezioni, è possibile eseguire le seguenti procedure:

Configurazione di una regola di analisi di aggregazione in una tabella (flusso guidato)

La regola di analisi di aggregazione consente di eseguire query che aggregano le statistiche senza rivelare informazioni a livello di riga utilizzando COUNT funzioni e dimensioni opzionali. SUM AVG

Questa procedura descrive il processo di aggiunta di una regola di analisi di aggregazione alla tabella configurata utilizzando l'opzione Flusso guidato nella console. AWS Clean Rooms

Per aggiungere la regola di analisi di aggregazione a una tabella (flusso guidato)

1. Accedi AWS Management Console e apri la AWS Clean Roomsconsole con il tuo Account AWS (se non l'hai ancora fatto).

2. Nel riquadro di navigazione a sinistra, scegli Tabelle configurate.

3. Scegli la tabella configurata.

4. Nella pagina di dettaglio della tabella configurata, scegli Configura regola di analisi.

5. Nel Passaggio 1: Scegli il tipo, in Tipo, lascia selezionata l'opzione Aggregazione per impostazione predefinita.

6. In Metodo di creazione, seleziona Flusso guidato, quindi scegli Avanti.

7. Nella Fase 2: Specificate i controlli di interrogazione, per le funzioni di aggregazione:

   1. Scegli una funzione di aggregazione dal menu a discesa:

      • CONTARE

      • CONTA DISTINTO

      • SUM

      • SOMMA DISTINTA

      • AVG

   2. Scegli quali colonne possono essere utilizzate nella funzione Aggregate dal menu a discesa Colonne.

   3. (Facoltativo) Scegli Aggiungi un'altra funzione per aggiungere un'altra funzione di aggregazione e associare una o più colonne a quella funzione.

      Nota

      È richiesta almeno una funzione di aggregazione.

   4. (Facoltativo) Scegliete Rimuovi per rimuovere una funzione aggregata.

8. Per i controlli Join,

   1. Scegli un'opzione per Consenti alla tabella di essere interrogata da sola:

      Se scegli...	Quindi...
      No, è possibile interrogare solo la sovrapposizione	La tabella può essere interrogata solo se unita a una tabella di proprietà del membro che può eseguire la query.
      Sì	La tabella può essere interrogata da sola o quando è unita ad altre tabelle.

   2. In Specificare le colonne di unione, scegliete le colonne di cui desiderate consentire l'uso nell'INNERJOINistruzione.

      Questo è facoltativo se hai selezionato Sì nel passaggio precedente.

   3. In Specificare gli operatori consentiti per la corrispondenza, scegli quali operatori, se presenti, possono essere utilizzati per la corrispondenza su più colonne di unione. Se selezioni due o più JOIN colonne, è necessario uno di questi operatori.

      Se scegli...	Quindi...
      E	Puoi includere AND nelle condizioni di INNER JOIN partita per unire una colonna a un'altra colonna tra le tabelle.
      OPPURE	Puoi includere OR nelle condizioni di INNER JOIN partita per combinare più corrispondenze di colonne tra tabelle. Questo operatore logico è utile per ottenere un tasso di corrispondenza più elevato.

9. (Facoltativo) Per i controlli Dimension, nel menu a discesa Specificare le colonne di dimensione, scegli le colonne di cui desideri consentire l'utilizzo nell'istruzione SELECT e nelle ORDER BY parti della query. WHERE GROUP BY

   Nota

   La funzione di aggregazione o le colonne di unione non possono essere utilizzate come colonne Dimension.

10. Per le funzioni scalari, scegli un'opzione per Quali funzioni scalari vuoi consentire?

    Se scegli...	Quindi...
    Il tutto attualmente supportato da AWS Clean Rooms	Sono consentite tutte le funzioni scalari attualmente supportate daAWS Clean Rooms. Puoi scegliere Visualizza elenco per visualizzare l'intero elenco di funzioni scalari supportate in. AWS Clean Rooms
    Un elenco personalizzato	È possibile personalizzare le funzioni scalari da consentire. Scegli una o più opzioni dal menu a discesa Specificare le funzioni scalari consentite.
    Nessuno	Non vuoi consentire alcuna funzione scalare.

    Per ulteriori informazioni, consulta Funzioni scalari.

11. Seleziona Next (Successivo).

12. Nel Passaggio 3: Specificare i controlli dei risultati delle query, per i vincoli di aggregazione:

    1. Seleziona l'elenco a discesa per ogni nome di colonna.

    2. Seleziona l'elenco a discesa per ogni Numero minimo di valori distinti che devono essere soddisfatti per ogni riga di output da restituire, dopo l'applicazione della COUNT DISTINCT funzione.

    3. Scegli Aggiungi vincolo per aggiungere altri vincoli di aggregazione.

    4. (Facoltativo) Scegliete Rimuovi per rimuovere un vincolo di aggregazione.

13. Seleziona Avanti.

14. Nel Passaggio 4: revisione e configurazione, rivedi le selezioni effettuate per i passaggi precedenti, modifica se necessario, quindi scegli Configura regola di analisi.

Viene visualizzato un messaggio di conferma che hai configurato correttamente una regola di analisi di aggregazione nella tabella.

Configurazione di una regola di analisi dell'elenco su una tabella (flusso guidato)

La regola di analisi degli elenchi consente di eseguire query che generano elenchi a livello di riga della sovrapposizione tra la tabella associata e una tabella del membro che può eseguire l'interrogazione.

Questa procedura descrive il processo di aggiunta della regola di analisi dell'elenco alla tabella configurata utilizzando l'opzione Flusso guidato nella console. AWS Clean Rooms

Per aggiungere una regola di analisi dell'elenco a una tabella (flusso guidato)

1. Accedi a AWS Management Console e apri la AWS Clean Roomsconsole con il tuo Account AWS (se non l'hai ancora fatto).

2. Nel riquadro di navigazione a sinistra, scegli Tabelle configurate.

3. Scegli la tabella configurata.

4. Nella pagina di dettaglio della tabella configurata, scegli Configura regola di analisi.

5. Nel Passaggio 1: Scegli il tipo, in Tipo, scegli l'opzione Elenco.

6. In Metodo di creazione, seleziona Flusso guidato, quindi scegli Avanti.

7. Nel Passaggio 2: Specificare i controlli di interrogazione, per i controlli Join:

   1. In Specificare le colonne di unione, scegliete le colonne di cui desiderate consentire l'uso nell'INNERJOINistruzione.

   2. In Specificare gli operatori consentiti per la corrispondenza, scegli quali operatori, se presenti, possono essere utilizzati per la corrispondenza su più colonne di unione. Se selezioni due o più JOIN colonne, è necessario uno di questi operatori.

      Se scegli...	Quindi...
      E	Puoi includere AND nelle condizioni di INNER JOIN partita per unire una colonna a un'altra colonna tra le tabelle.
      OPPURE	Puoi includere OR nelle condizioni di INNER JOIN partita per combinare più corrispondenze di colonne tra tabelle. Questo operatore logico è utile per ottenere un tasso di corrispondenza più elevato.

8. (Facoltativo) Per i controlli List, nel menu a discesa Specificare le colonne dell'elenco, scegliete quali colonne desiderate che vengano utilizzate nell'output della query (ovvero, utilizzate nell'SELECTistruzione) o utilizzate per filtrare i risultati (ovvero, l'WHEREistruzione).

9. Seleziona Avanti.

10. Nel Passaggio 3: revisione e configurazione, rivedi le selezioni effettuate per i passaggi precedenti, modificale se necessario, quindi scegli Configura regola di analisi.

Viene visualizzato un messaggio di conferma che è stata configurata correttamente una regola di analisi dell'elenco per la tabella.

Configurazione di una regola di analisi personalizzata su una tabella (flusso guidato)

La regola di analisi personalizzata abilita query SQL personalizzate su una tabella configurata. La regola di analisi personalizzata è necessaria se si utilizzano modelli di analisi o privacy differenziale.

Questa procedura descrive il processo di aggiunta della regola di analisi personalizzata alla tabella configurata utilizzando l'opzione Flusso guidato nella AWS Clean Rooms console.

Per aggiungere una regola di analisi personalizzata a una tabella (flusso guidato)

1. Accedi a AWS Management Console e apri la AWS Clean Roomsconsole con il tuo Account AWS (se non l'hai ancora fatto).

2. Nel riquadro di navigazione a sinistra, scegli Tabelle configurate.

3. Scegli la tabella configurata.

4. Nella pagina di dettaglio della tabella configurata, scegli Configura regola di analisi.

5. Nel Passaggio 1: Scegli il tipo, in Tipo, scegli l'opzione Personalizzata.

6. In Metodo di creazione, seleziona Flusso guidato, quindi scegli Avanti.

7. Nel Passaggio 2: Imposta la privacy differenziale, stabilisci se desideri attivare o disattivare la privacy differenziale. La privacy differenziale è una tecnica matematicamente collaudata per proteggere i dati dagli attacchi di reidentificazione.

   1. Per la privacy differenziale:

      Se tu...	Allora scegli...
      Disponi di dati a livello utente e desideri proteggerli dai tentativi di reidentificazione	Accendi
      Non dispongono di dati a livello utente o non necessitano di protezione contro i tentativi di reidentificazione	Spegnere

   2. Se hai scelto di attivare la privacy differenziale, seleziona la colonna Identificatore utente che contiene l'identificatore univoco degli utenti, ad esempio la user_id colonna di cui desideri proteggere la privacy. Se desideri attivare la privacy differenziale per due o più tabelle in una collaborazione, devi configurare la stessa colonna della colonna User identifier in entrambe le regole di analisi per mantenere una definizione coerente degli utenti tra le tabelle. In caso di configurazione errata, il membro che può eseguire la query riceve un messaggio di errore indicante che ci sono due colonne tra cui scegliere per calcolare il numero di contributi degli utenti (ad esempio, il numero di impressioni pubblicate da un utente) durante l'esecuzione della query.

   3. Seleziona Avanti.

8. Nel passaggio 3: Specificare i controlli di interrogazione,

   1. Per il tipo di controllo:

      Se vuoi ...	Quindi scegli...
      Esamina ogni nuovo modello di analisi prima che venga eseguito sulla tabella configurata	Esamina ogni nuova analisi prima che possa essere eseguita su questa tabella
      Consenti l'esecuzione di qualsiasi modello di analisi o interrogazione diretta sulla tabella configurata	Consenti l'esecuzione senza revisione di tutte le query create da collaboratori specifici su questa tabella

   2. Seleziona una delle seguenti opzioni:

      Se hai scelto...	Quindi...
      Esamina ogni nuova analisi prima di consentirne l'esecuzione su questa tabella	In Modelli di analisi consentiti, scegli Aggiungi modello di analisi, quindi scegli il modello di collaborazione e di analisi appropriato dagli elenchi a discesa.
      Consenti l'esecuzione senza revisione di tutte le query create da collaboratori specifici su questa tabella	In Account AWSConsentito creare qualsiasi query, scegli Aggiungi Account AWS, quindi scegli l'ID appropriatoAccount AWS.

9. Seleziona Avanti.

10. Nel Passaggio 4: revisione e configurazione, rivedi le selezioni effettuate per i passaggi precedenti, modifica se necessario, quindi scegli Configura regola di analisi.

Viene visualizzato un messaggio di conferma che è stata configurata correttamente una regola di analisi personalizzata per la tabella.

Configurazione della regola di analisi su una tabella (editor JSON)

La procedura seguente mostra come aggiungere una regola di analisi a una tabella utilizzando l'opzione dell'editor JSON nella console. AWS Clean Rooms

Per configurare un'aggregazione, un elenco o una regola di analisi personalizzata a una tabella (editor JSON)

1. Accedi AWS Management Console e apri la AWS Clean Roomsconsole con il tuo Account AWS (se non l'hai ancora fatto).

2. Nel riquadro di navigazione a sinistra, scegli Tabelle configurate.

3. Scegli la tabella configurata.

4. Nella pagina di dettaglio della tabella configurata, scegli Configura regola di analisi.

5. Nel Passaggio 1: Scegli il tipo, in Tipo, scegli l'opzione Aggregazione, Elenco o Personalizzata.

6. In Metodo di creazione, seleziona Editor JSON, quindi scegli Avanti.

7. Nel Passaggio 2: Specificazione dei controlli, puoi scegliere di inserire una struttura di query (Inserisci modello) o inserire un file (Importa da file).

   Se scegli...	Quindi...
   Inserisci modello	Specificate i parametri per la regola di analisi selezionata nella definizione della regola di analisi. Puoi premere Ctrl + Barra spaziatrice per abilitare il completamento automatico. Per ulteriori informazioni sui parametri delle regole di analisi di aggregazione, vedere. Regola di analisi dell'aggregazione: controlli di interrogazione Per ulteriori informazioni sui parametri delle regole di analisi degli elenchi, vedereRegola di analisi delle liste: controlli di interrogazione.
   Importazione da file	Seleziona il tuo file JSON dall'unità locale. Seleziona Apri. La definizione della regola di analisi mostra la regola di analisi del file caricato.

8. Seleziona Avanti.

9. Nel Passaggio 3: revisione e configurazione, rivedi le selezioni effettuate per i passaggi precedenti, modifica se necessario, quindi scegli Configura regola di analisi.

Riceverai un messaggio di conferma che hai configurato correttamente una regola di analisi per la tabella.

Passaggi successivi

Ora che hai configurato una regola di analisi per la tabella configurata, sei pronto per:

• Associare una tabella configurata a una collaborazione

• Interroga le tabelle di dati (come membro che può eseguire interrogazioni)