Interrogazione dei dati in una collaborazione

In qualità di membro che può eseguire le interrogazioni, puoi eseguire una delle seguenti operazioni:

• Crea manualmente una query SQL utilizzando l'editor di codice SQL.

• Utilizza l'interfaccia utente di Analysis Builder per creare una query senza dover scrivere codice SQL.

• Utilizza un modello di analisi approvato.

Quando il membro che può eseguire una query SQL sulle tabelle della collaborazione, AWS Clean Rooms assume i ruoli pertinenti per accedere alle tabelle per suo conto. AWS Clean Rooms applica le regole di analisi necessarie alla query di input e al relativo output.

AWS Clean Rooms supporta query SQL che possono essere diverse dagli altri motori di query. Per le specifiche, vedere AWS Clean Rooms SQL Reference. Se desideri eseguire query su tabelle di dati protette con privacy differenziale, devi assicurarti che le query siano compatibili con la struttura di query generica di Differential Privacy. AWS Clean Rooms

Nota

Quando si utilizza Cryptographic Computing for Clean Rooms, non tutte le operazioni SQL generano risultati validi. Ad esempio, è possibile eseguire un comando COUNT su una colonna crittografata, ma eseguire un comando SUM su numeri crittografati genera errori. Inoltre, le interrogazioni potrebbero produrre risultati errati. Ad esempio, le interrogazioni con colonne SUM sigillate producono errori. Tuttavia, un'GROUPBYinterrogazione su colonne sigillate sembra avere esito positivo, ma produce gruppi diversi da quelli prodotti da un'GROUPBYinterrogazione su testo in chiaro.

I seguenti argomenti spiegano come interrogare i dati in una collaborazione utilizzando la AWS Clean Rooms console.

Per informazioni su come interrogare i dati o visualizzare le query chiamando direttamente l'operazione AWS Clean Rooms StartProtectedQuery API o utilizzando gli AWS SDK, consulta l'AWS Clean Rooms API Reference.

Per informazioni sulla registrazione delle query, consulta. Registrazione delle query AWS Clean Rooms

Nota

Se si esegue una query su tabelle di dati crittografate, i risultati delle colonne crittografate vengono crittografati.

Per informazioni sulla ricezione dei risultati delle query, vedereRicezione dei risultati delle query.

Utilizzo dell'editor di codice SQL

In qualità di membro in grado di eseguire query, puoi creare una query manualmente scrivendo codice SQL nell'editor di codice SQL. L'editor di codice SQL si trova nella sezione Analisi della scheda Query della AWS Clean Rooms console.

L'editor di codice SQL viene visualizzato per impostazione predefinita. Se desideri utilizzare il generatore di analisi per creare query, consulta. Utilizzo del generatore di analisi

Importante

Se inizi a scrivere una query SQL nell'editor di codice e poi attivi l'interfaccia utente di Analysis Builder, la query non viene salvata.

AWS Clean Rooms supporta molti comandi, funzioni e condizioni SQL. Per ulteriori informazioni, vedere AWS Clean Rooms SQL Reference.

Suggerimento

Se viene eseguita una manutenzione pianificata mentre è in esecuzione una query, la query viene terminata e ripristinata. È necessario riavviare la query.

Per creare la query manualmente utilizzando l'editor di codice SQL

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

2. Nel riquadro di navigazione a sinistra, scegli Collaborazioni.

3. Scegli la collaborazione con lo status di Query relativo alle abilità dei membri.

4. Nella scheda Interrogazioni, vai alla sezione Analisi.

   Nota

   La sezione Analisi viene visualizzata solo se il membro che può ricevere i risultati e il membro responsabile del pagamento dei costi di elaborazione delle query hanno aderito alla collaborazione come membri attivi.

5. Nella scheda Interrogazioni, in Tabelle, visualizza l'elenco delle tabelle e il tipo di regola di analisi associato (regola di analisi di aggregazione, regola di analisi dell'elenco o regola di analisi personalizzata).

   Nota

   Se non vedi le tabelle che ti aspetti nell'elenco, potrebbe essere per i seguenti motivi:

   • Le tabelle non sono state associate.

   • Le tabelle non hanno una regola di analisi configurata.

6. (Facoltativo) Per visualizzare lo schema e i controlli delle regole di analisi della tabella, espandi la tabella selezionando l'icona del segno più (+).

7. Crea la query digitandola nell'editor di codice SQL.

   (Facoltativo) Se desideri utilizzare una query di esempio

   (Facoltativo) Se si desidera inserire nomi o funzioni di colonna

   Seleziona i tre punti verticali accanto alla tabella. In Inserisci nell'editor, scegli Interrogazione di esempio. Nota L'inserimento di una query di esempio aggiunge la query già presente nell'editor. Viene visualizzato l'esempio di interrogazione. Tutte le tabelle elencate in Tabelle sono incluse nella query. Modificate i valori segnaposto nella query.

   Seleziona i tre punti verticali accanto a una colonna. In Inserisci nell'editor, scegli Nome colonna. Per inserire manualmente una funzione consentita su una colonna, seleziona i tre punti verticali accanto a una colonna, seleziona Inserisci nell'editor, quindi seleziona il nome della funzione consentita (ad esempio INNER JOIN SUMDISTINCT, SUM oCOUNT). Premi Ctrl + Spazio per visualizzare gli schemi delle tabelle nell'editor di codice. Nota I membri che possono eseguire query possono visualizzare e utilizzare le colonne delle partizioni in ogni associazione di tabelle configurata. Assicurati che la colonna della partizione sia etichettata come colonna di partizione nella AWS Glue tabella sottostante la tabella configurata. Modifica i valori segnaposto nella query.

8. Seleziona Esegui.

   Nota

   Non è possibile eseguire la query se il membro che può ricevere i risultati non ha configurato le impostazioni dei risultati della query.

9. Continua a modificare i parametri ed esegui nuovamente la query oppure scegli il pulsante + per iniziare una nuova query in una nuova scheda.

Nota

AWS Clean Rooms mira a fornire messaggi di errore chiari. Se un messaggio di errore non contiene dettagli sufficienti per aiutarti a risolvere il problema, contatta il team dell'account. Fornisci loro una descrizione di come si è verificato l'errore e il messaggio di errore (inclusi eventuali identificatori). Per ulteriori informazioni, consulta Risoluzione dei problemi AWS Clean Rooms.

Utilizzo del generatore di analisi

È possibile utilizzare il generatore di analisi per creare query senza dover scrivere codice SQL. Con Analysis Builder, puoi creare una query per una collaborazione che abbia:

• Una singola tabella che utilizza la regola di analisi di aggregazione senza che sia richiesto JOIN

• Due tabelle (una per ogni membro) che utilizzano entrambe la regola di analisi di aggregazione

• Due tabelle (una per ogni membro) che utilizzano entrambe la regola di analisi delle liste

• Due tabelle (una per ciascun membro) che utilizzano entrambe la regola di analisi di aggregazione e due tabelle (una per ciascun membro) che utilizzano entrambe la regola di analisi dell'elenco

Se desideri scrivere manualmente le query SQL, consulta. Utilizzo dell'editor di codice SQL

Analysis Builder viene visualizzato come opzione dell'interfaccia utente di Analysis Builder nella sezione Analisi della scheda Queries della console. AWS Clean Rooms

Importante

Se attivi l'interfaccia utente di Analysis Builder, inizi a creare una query in Analysis Builder e poi disattivi l'interfaccia utente di Analysis Builder, la query non viene salvata.

Suggerimento

Se viene eseguita una manutenzione pianificata mentre una query è in esecuzione, la query viene terminata e ripristinata. È necessario riavviare la query.

I seguenti argomenti spiegano come utilizzare l'Analysis Builder.

Argomenti

• Utilizzate il generatore di analisi per interrogare una singola tabella (aggregazione)
• Utilizza il generatore di analisi per interrogare due tabelle (aggregazione o elenco)

Utilizzate il generatore di analisi per interrogare una singola tabella (aggregazione)

Questa procedura dimostra come utilizzare l'interfaccia utente di Analysis Builder nella AWS Clean Rooms console per creare una query. La query è per una collaborazione che ha una singola tabella che utilizza la regola di analisi di aggregazione senza necessità. JOIN

Per utilizzare il generatore di analisi per interrogare una singola tabella

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

2. Nel riquadro di navigazione a sinistra, scegli Collaborazioni.

3. Scegli la collaborazione con lo status di Query relativo alle abilità dei membri.

4. Nella scheda Query, in Tabelle, visualizza la tabella e il tipo di regola di analisi associato. (Il tipo di regola di analisi deve essere la regola di analisi di aggregazione.)

   Nota

   Se non vedi la tabella che ti aspetti, potrebbe essere per i seguenti motivi:

   • La tabella non è stata associata.

   • La tabella non ha una regola di analisi configurata.

5. Nella sezione Analisi, attiva l'interfaccia utente di Analysis Builder.

6. Crea una query.

   Se desideri visualizzare tutte le metriche di aggregazione, vai al passaggio 9.

   1. Per Scegli le metriche, esamina le metriche aggregate che sono state preselezionate per impostazione predefinita e rimuovi qualsiasi metrica, se necessario.

   2. (Facoltativo) Per Aggiungi segmenti: facoltativo, scegli uno o più parametri.

      Nota

      Aggiungi segmenti: l'opzione opzionale viene visualizzata solo se sono specificate le dimensioni per la tabella.

   3. (Facoltativo) Per Aggiungi filtri: facoltativo, scegliete Aggiungi filtro, quindi scegliete un parametro, un operatore e un valore.

      Per aggiungere altri filtri, scegli Aggiungi un altro filtro.

      Per rimuovere un filtro, scegli Rimuovi.

      Nota

      ORDER BYnon è supportato per le query di aggregazione.

      Nei filtri è supportato solo AND l'operatore.

   4. (Facoltativo) Per Aggiungi descrizione: facoltativo, inserisci una descrizione per identificare l'interrogazione nell'elenco delle interrogazioni.

7. Espandi il codice SQL di anteprima.

   1. Visualizzate il codice SQL generato dall'Analysis Builder.

   2. Per copiare il codice SQL, scegliete Copia.

   3. Per modificare il codice SQL, scegli Modifica nell'editor di codice SQL.

8. Seleziona Esegui.

   Nota

   Non puoi eseguire la query se il membro che può ricevere i risultati non ha configurato le impostazioni dei risultati della query.

9. Continua a modificare i parametri ed esegui nuovamente la query oppure scegli il pulsante + per iniziare una nuova query in una nuova scheda.

Nota

AWS Clean Rooms mira a fornire messaggi di errore chiari. Se un messaggio di errore non contiene dettagli sufficienti per aiutarti a risolvere il problema, contatta il team dell'account. Fornisci loro una descrizione di come si è verificato l'errore e il messaggio di errore (inclusi eventuali identificatori). Per ulteriori informazioni, consulta Risoluzione dei problemi AWS Clean Rooms.

Utilizza il generatore di analisi per interrogare due tabelle (aggregazione o elenco)

Questa procedura descrive come utilizzare l'Analysis Builder nella AWS Clean Rooms console per creare una query per una collaborazione che abbia:

• Due tabelle (una per ogni membro) che utilizzano entrambe la regola di analisi di aggregazione

• Due tabelle (una per ogni membro) che utilizzano entrambe la regola di analisi delle liste

• Due tabelle (una per ciascun membro) che utilizzano entrambe la regola di analisi di aggregazione e due tabelle (una per ciascun membro) che utilizzano entrambe la regola di analisi dell'elenco

Per utilizzare il generatore di analisi per interrogare due tabelle

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

2. Nel riquadro di navigazione a sinistra, scegli Collaborazioni.

3. Scegli la collaborazione per la quale le abilità dei tuoi membri sono impostate sullo stato Query.

4. Nella scheda Query, in Tabelle, visualizza le due tabelle e il tipo di regola di analisi associato (regola di analisi di aggregazione o regola di analisi dell'elenco).

   Nota

   Se non vedi le tabelle che ti aspetti nell'elenco, potrebbe essere per i seguenti motivi:

   • Le tabelle non sono state associate.

   • Le tabelle non hanno una regola di analisi configurata.

5. Nella sezione Analisi, attiva l'interfaccia utente di Analysis Builder.

6. Crea una query.

   Se la collaborazione contiene due tabelle che utilizzano la regola di analisi di aggregazione e due tabelle che utilizzano la regola di analisi delle liste, scegli prima Aggregazione o Elenco, quindi segui le istruzioni in base alla regola di analisi selezionata.

   Se le due tabelle utilizzano la regola di analisi di aggregazione

   Se le due tabelle utilizzano la regola di analisi dell'elenco

   Per Choose metrics, esamina le metriche aggregate che sono state preselezionate per impostazione predefinita e rimuovi qualsiasi metrica, se necessario. Per i record Match, scegli uno o più record. Nota Quando si utilizza il generatore di analisi, è possibile eseguire la corrispondenza solo su una singola coppia di colonne. (Facoltativo) Per Aggiungi segmenti: facoltativo, scegli uno o più parametri. Nota Aggiungi segmenti: l'opzione opzionale viene visualizzata solo se sono specificate le dimensioni per la tabella. (Facoltativo) Per Aggiungi filtri: facoltativo, scegli Aggiungi filtro, quindi scegli un parametro, un operatore e un valore. Per aggiungere altri filtri, scegli Aggiungi un altro filtro. Per rimuovere un filtro, scegli Rimuovi. Nota ORDER BYnon è supportato per le query di aggregazione. Nei filtri è supportato solo AND l'operatore. (Facoltativo) Per Aggiungi descrizione: facoltativo, inserisci una descrizione per identificare l'interrogazione nell'elenco delle interrogazioni recenti.

   Per Scegli gli attributi, esamina gli attributi dell'elenco che sono stati preselezionati per impostazione predefinita e rimuovi qualsiasi metrica, se necessario. Per i record Match, scegli uno o più record. Nota Quando si utilizza il generatore di analisi, è possibile eseguire la corrispondenza solo su una singola coppia di colonne. (Facoltativo) Per Aggiungi filtri: facoltativo, scegli Aggiungi filtro, quindi scegli un parametro, un operatore e un valore. Per aggiungere altri filtri, scegli Aggiungi un altro filtro. Per rimuovere un filtro, scegli Rimuovi. Nota LIMITnon è supportato per le interrogazioni sugli elenchi. Nei filtri è supportato solo AND l'operatore. (Facoltativo) Per Aggiungi descrizione: facoltativo, inserisci una descrizione per identificare l'interrogazione nell'elenco delle interrogazioni recenti.

7. Espandi il codice SQL di anteprima.

   1. Visualizzate il codice SQL generato dall'Analysis Builder.

   2. Per copiare il codice SQL, scegliete Copia.

   3. Per modificare il codice SQL, scegli Modifica nell'editor di codice SQL.

8. Seleziona Esegui.

   Nota

   Non puoi eseguire la query se il membro che può ricevere i risultati non ha configurato le impostazioni dei risultati della query

9. Continua a modificare i parametri ed esegui nuovamente la query oppure scegli il pulsante + per iniziare una nuova query in una nuova scheda.

Nota

AWS Clean Rooms mira a fornire messaggi di errore chiari. Se un messaggio di errore non contiene dettagli sufficienti per aiutarti a risolvere il problema, contatta il team dell'account. Fornisci loro una descrizione di come si è verificato l'errore e il messaggio di errore (inclusi eventuali identificatori). Per ulteriori informazioni, consulta Risoluzione dei problemi AWS Clean Rooms.

Interrogazione dei dati con privacy differenziale

In generale, la scrittura e l'esecuzione di query non cambiano quando è attivata la privacy differenziale. Tuttavia, non è possibile eseguire una query se il budget a disposizione per la privacy non è sufficiente. Man mano che esegui le query e utilizzi il budget per la privacy, puoi vedere approssimativamente quante aggregazioni puoi eseguire e in che modo ciò potrebbe influire sulle query future.

Per visualizzare l'impatto della privacy differenziale in una collaborazione

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

2. Nel riquadro di navigazione a sinistra, scegli Collaborazioni.

3. Scegli la collaborazione per la quale i dati del tuo socio sono impostati sullo stato Esegui interrogazioni.

4. Nella scheda Query, in Tabelle, visualizza il budget residuo per la privacy. Viene visualizzato come il numero stimato di funzioni di aggregazione rimanenti e l'utilità utilizzata (visualizzata come percentuale).

   Nota

   Il numero stimato di funzioni aggregate rimanenti e la percentuale di Utility utilizzata vengono visualizzati solo per il membro che può eseguire la query.

5. Scegliete Visualizza impatto per visualizzare la quantità di rumore iniettata nei risultati e approssimativamente quante funzioni di aggregazione è possibile eseguire.

Visualizzazione delle query recenti

Puoi visualizzare le interrogazioni eseguite negli ultimi 90 giorni nella scheda Interrogazioni recenti.

Nota

Se la tua unica abilità di membro è Contribute data e non sei il membro che paga i costi di elaborazione delle query, la scheda Interrogazioni non viene visualizzata sulla console.

Per visualizzare le interrogazioni recenti

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

2. Nel riquadro di navigazione a sinistra, scegli Collaborazioni.

3. Scegli una collaborazione.

4. Nella scheda Interrogazioni, in Interrogazioni, visualizza le interrogazioni eseguite negli ultimi 90 giorni.

5. Per ordinare le interrogazioni recenti in base allo stato, seleziona uno stato dall'elenco a discesa Tutti gli stati.

   Gli stati sono: Inviato, Avviato, Annullato, Operato correttamente, Non riuscito e Scaduto.

Visualizzazione dei dettagli delle query

È possibile visualizzare i dettagli della query come membro che può eseguire le query o come membro che può ricevere risultati.

Per visualizzare i dettagli dell'interrogazione

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

2. Nel riquadro di navigazione a sinistra, scegli Collaborazioni.

3. Scegli una collaborazione.

4. Nella scheda Interrogazioni, esegui una delle seguenti operazioni:

   • Scegli il pulsante di opzione per la query specifica che desideri visualizzare, quindi scegli Visualizza dettagli.

   • Scegli l'ID della query protetta.

5. Nella pagina dei dettagli della query,

   • Se sei il membro che può eseguire le query, visualizza i dettagli della query, il testo SQL e i risultati.

     Viene visualizzato un messaggio che conferma che i risultati della query sono stati consegnati al membro che può riceverli.

   • Se sei il membro che può ricevere i risultati, visualizza i dettagli della query e i risultati.