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à.
# Esecuzione di query SQL
**Nota**
Puoi eseguire le query solo se il membro responsabile del pagamento dei costi di elaborazione delle query ha aderito alla collaborazione come membro attivo.
In qualità di [membro che può eseguire interrogazioni](glossary.md#glossary-member-who-can-query), puoi eseguire una query SQL nei seguenti modi:
+ Creazione manuale di una query SQL utilizzando l'editor di codice SQL.
+ Utilizzo di un [modello di analisi](create-analysis-template.md) SQL approvato.
+ Utilizzo dell'**interfaccia utente di Analysis Builder** per creare una query senza dover scrivere codice SQL.
Quando il membro che può eseguire una query esegue 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.
Le regole di analisi e i vincoli di output vengono applicati automaticamente. AWS Clean Rooms restituisce solo i risultati conformi alle regole di analisi definite.
AWS Clean Rooms supporta query SQL che possono essere diverse dagli altri motori di query. Per le specifiche, vedere [AWS Clean Rooms SQL Reference.](https://docs.aws.amazon.com/clean-rooms/latest/sql-reference/sql-reference.html) 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](analysis-rules-custom.md#dp-query-structure-syntax) di Differential Privacy. AWS Clean Rooms
**Nota**
Quando si utilizza [Cryptographic Computing for Clean Rooms](crypto-computing.md), 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.
Al [membro che paga i costi di elaborazione delle query](glossary.md#glossary-member-paying-for-query-compute) viene addebitato il costo delle query eseguite nell'ambito della collaborazione.
Il membro che può eseguire le interrogazioni può selezionare più [membri che possono ricevere risultati](glossary.md#glossary-member-who-can-receive-results) per ricevere i risultati di una singola query. Per ulteriori informazioni, consulta [Interrogazione di tabelle configurate utilizzando l'editor di codice SQL](use-sql-editor.md). Per informazioni generali sulla ricezione dei risultati delle interrogazioni, vedere[Ricezione e utilizzo dei risultati delle analisi](receive-query-results.md).
## Prerequisiti
Prima di eseguire una query SQL, assicurati di disporre di quanto segue:
+ Un'iscrizione attiva alla AWS Clean Rooms collaborazione
+ Accesso ad almeno una tabella configurata nella collaborazione
+ Conferma che il membro responsabile dei costi di elaborazione delle query è un membro attivo della collaborazione
Per informazioni su come interrogare i dati o visualizzare le query chiamando direttamente l'operazione AWS Clean Rooms [StartProtectedQuery API](https://docs.aws.amazon.com/clean-rooms/latest/apireference/API_StartProtectedQuery.html) o utilizzando la AWS SDKs, consulta l'[AWS Clean Rooms API](https://docs.aws.amazon.com/clean-rooms/latest/apireference/Welcome.html) Reference.
Per informazioni sulla registrazione delle query, vedere. [Registrazione dell'analisi AWS Clean Rooms](query-logs.md)
**Nota**
Se si esegue una query su tabelle di dati [crittografate](glossary.md#glossary-encryption), i risultati delle colonne crittografate vengono crittografati.
## Configurazione delle proprietà Spark per le query SQL
AWS Clean Rooms consente di personalizzare facoltativamente il comportamento di runtime di Spark configurando le proprietà Spark supportate per le query SQL. Queste proprietà consentono di ottimizzare le prestazioni, l'utilizzo della memoria e i parametri di esecuzione delle query. Con questa funzionalità, hai un maggiore controllo sul modo in cui vengono elaborate le query basate su Spark, consentendone l'ottimizzazione in base ai requisiti specifici del carico di lavoro.
Ora puoi regolare impostazioni come le partizioni shuffle, le soglie di broadcast join e i parametri di esecuzione delle query adattive direttamente dalla console. AWS Clean Rooms Questa funzionalità è particolarmente utile per query complesse o set di dati di grandi dimensioni in cui le configurazioni predefinite potrebbero non essere ottimali. Ottimizzando queste proprietà di Spark, puoi potenzialmente migliorare le prestazioni delle query, ridurre il consumo di risorse e gestire meglio l'utilizzo della memoria per le analisi di collaborazione basate su Spark.
**Per sfruttare questa funzionalità, troverai una nuova sezione delle proprietà di Spark nell'interfaccia di interrogazione.** Puoi selezionare da un elenco di proprietà supportate e specificare valori personalizzati. [Puoi anche configurare le proprietà Spark a livello di codice utilizzando l'API. StartProtectedQuery ](https://docs.aws.amazon.com/clean-rooms/latest/apireference/API_StartProtectedQuery.html) Questa opzione di configurazione avanzata consente agli analisti e agli ingegneri di dati di ottimizzare le loro query per una maggiore efficienza e scalabilità.
Per ulteriori informazioni sulle proprietà di Spark, inclusi i valori predefiniti, consulta Spark [Properties nella documentazione di Apache Spark](https://spark.apache.org/docs/latest/configuration.html#spark-properties).
I seguenti argomenti spiegano come interrogare i dati in una collaborazione utilizzando la console. AWS Clean Rooms
**Topics**
+ [Prerequisiti](#sql-queries-prereqs)
+ [Configurazione delle proprietà Spark per le query SQL](#spark-properties-config)
+ [Interrogazione di tabelle configurate utilizzando l'editor di codice SQL](use-sql-editor.md)
+ [Interrogazione delle tabelle di mappatura degli ID utilizzando l'editor di codice SQL](query-id-mapping-tables.md)
+ [Interrogazione di tabelle configurate utilizzando un modello di analisi SQL](use-analysis-template.md)
+ [Esecuzione di interrogazioni con il generatore di analisi](query-data-analysis-builder.md)
+ [Visualizzazione dell'impatto della privacy differenziale](query-data-with-diff-privacy.md)
+ [Visualizzazione delle query recenti](view-queries-console.md)
+ [Visualizzazione dei dettagli delle query](view-query-details.md)
# Interrogazione di tabelle configurate utilizzando l'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 **Analisi** 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. [Esecuzione di interrogazioni con il generatore di analisi](query-data-analysis-builder.md)
**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](https://docs.aws.amazon.com/clean-rooms/latest/sql-reference/sql-reference.html).
**Suggerimento**
Se viene eseguita una manutenzione pianificata mentre è in esecuzione una query, la query viene terminata e ripristinata. È necessario riavviare la query.
**Per interrogare le tabelle configurate utilizzando l'editor di codice SQL**
1. Accedi a Console di gestione AWS e apri la AWS Clean Rooms console all'indirizzo [https://console.aws.amazon.com/cleanrooms.](https://console.aws.amazon.com/cleanrooms/home)
1. **Nel riquadro di navigazione a sinistra, scegli Collaborazioni.**
1. Scegli la collaborazione per la quale è stato **assegnato lo status di Membro** **Esegui interrogazioni**.
1. Nella scheda **Analisi**, 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](associate-configured-table.md).
Le tabelle non hanno una [regola di analisi configurata](add-analysis-rule.md).
1. (Facoltativo) Per visualizzare lo schema e i controlli delle regole di analisi della tabella, espandi la tabella selezionando l'icona del segno più (**\$1**).
1. Nella sezione **Analisi**, per la **modalità Analisi**, seleziona **Scrivi codice SQL**.
**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.
1. Crea la query digitandola nell'editor di codice SQL.
Per ulteriori informazioni sui comandi e le funzioni SQL supportati, consulta [AWS Clean Rooms SQL Reference.](https://docs.aws.amazon.com/clean-rooms/latest/sql-reference/sql-reference.html)
È inoltre possibile utilizzare le seguenti opzioni per creare la query.
------
#### [ Use an example query ]
Per utilizzare una query di esempio
1. Seleziona i tre punti verticali accanto alla tabella.
1. In **Inserisci nell'editor**, scegli **Interrogazione di esempio**.
**Nota**
L'inserimento di una **query di esempio** la aggiunge alla query già presente nell'editor.
Viene visualizzato l'esempio di interrogazione. Tutte le tabelle elencate in **Tabelle** sono incluse nella query.
1. Modificate i valori segnaposto nella query.
------
#### [ Insert column names or functions ]
Per inserire il nome o la funzione di una colonna
1. Seleziona i tre punti verticali accanto a una colonna.
1. In **Inserisci nell'editor**, scegli **Nome colonna**.
1. Per inserire manualmente una funzione consentita su una colonna,
1. Seleziona i tre punti verticali accanto a una colonna.
1. Seleziona **Inserisci nell'editor**.
1. Seleziona il nome della funzione consentita (ad esempio INNER JOINSUM,SUM DISTINCT, oCOUNT).
1. Premi **Ctrl** \$1 **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.
1. Modifica i valori segnaposto nella query.
------
1. Specificare il **tipo di lavoratore** supportato e il **numero di** lavoratori.
È possibile scegliere il tipo di istanza e il numero di istanze (worker) per eseguire le query SQL.
Per CR.1X, puoi selezionare fino a 128 lavoratori o un minimo di 4 lavoratori.
Per CR.4X, puoi selezionare fino a 32 lavoratori o un minimo di 4 lavoratori.
Utilizza la tabella seguente per determinare il tipo e il numero di lavoratori necessari per il tuo caso d'uso.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/clean-rooms/latest/userguide/use-sql-editor.html)
**Nota**
Diversi tipi di lavoratori e numero di lavoratori hanno costi associati. Per ulteriori informazioni sui prezzi, consulta la pagina [AWS Clean Rooms dei prezzi](https://aws.amazon.com/clean-rooms/pricing/).
1. Per **Invia risultati a**, specifica chi può ricevere risultati.
**Nota**
Per ricevere risultati, il membro della collaborazione deve essere configurato come destinatario dei risultati e deve essere un partecipante attivo alla collaborazione (**Stato: Attivo**)
1. (Solo membro che può eseguire interrogazioni) La casella di controllo **Usa le impostazioni dei risultati predefinite** è selezionata per impostazione predefinita. Mantieni selezionata questa opzione se desideri mantenere le impostazioni predefinite dei risultati.
Se desideri specificare impostazioni di risultato diverse per questa query, deseleziona la casella di controllo **Usa le impostazioni dei risultati predefinite**, quindi scegli quanto segue.
1. **Formato dei risultati** **(**CSV** o PARQUET)**
1. **File dei risultati** (**singoli** o **multipli**)
1. **Destinazione dei risultati in Amazon S3**
Ogni membro che può ricevere risultati può specificare un **formato di risultato****, file** di **risultati e destinazione dei risultati diversi in Amazon S3**.
1. Per specificare le proprietà di **Spark:**
1. **Espandi le proprietà di Spark.**
1. Scegli **Aggiungi proprietà Spark**.
1. **Nella finestra di dialogo delle **proprietà di Spark**, scegli **il nome di una proprietà** dall'elenco a discesa e inserisci un valore.**
La tabella seguente fornisce una definizione per ogni proprietà.
Per ulteriori informazioni sulle proprietà di Spark, consulta [Spark Properties nella documentazione](https://spark.apache.org/docs/latest/configuration.html#spark-properties) di Apache Spark.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/clean-rooms/latest/userguide/use-sql-editor.html)
1. Scegli **Esegui**.
**Nota**
Non è possibile eseguire la query se il membro che può ricevere i risultati non ha configurato le impostazioni dei risultati della query.
1. Visualizza i **risultati**.
Per ulteriori informazioni, consulta [Ricezione e utilizzo dei risultati delle analisi](receive-query-results.md).
1. Continua a modificare i parametri ed esegui nuovamente la query oppure scegli il pulsante **\$1** 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](troubleshooting.md).
# Interrogazione delle tabelle di mappatura degli ID utilizzando l'editor di codice SQL
La procedura seguente descrive come eseguire una query di join multitavola sulla tabella di mappatura degli ID per unirla `sourceId` a. `targetId`
Prima di eseguire una query sulla tabella di mappatura degli ID, è necessario che la tabella di mappatura degli ID sia stata compilata correttamente.
**Per interrogare le tabelle di mappatura degli ID utilizzando l'editor di codice SQL**
1. Accedi a Console di gestione AWS e apri la AWS Clean Rooms console all'indirizzo [https://console.aws.amazon.com/cleanrooms.](https://console.aws.amazon.com/cleanrooms/home)
1. **Nel riquadro di navigazione a sinistra, scegli Collaborazioni.**
1. Scegli la collaborazione per la quale è stato **assegnato lo status di Membro** **Esegui interrogazioni**.
1. Nella scheda **Analisi**, 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.
1. Nella scheda **Analisi**, in **Tabelle, visualizza l'elenco delle tabelle** di mappatura degli ID (in **Gestito da AWS Clean Rooms**) e il tipo di regola di analisi associato (regola di analisi della **tabella di mappatura ID**).
**Nota**
Se non vedi le tabelle di mappatura degli ID che ti aspetti nell'elenco, è possibile che le tabelle di mappatura degli ID non siano state compilate correttamente. Per ulteriori informazioni, consulta [Compilazione di una tabella di mappatura degli ID esistente](populate-id-mapping-table.md).
1. Crea la query digitandola nell'editor di codice SQL.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/clean-rooms/latest/userguide/query-id-mapping-tables.html)
1. Specificare il **tipo di lavoratore** supportato e il **numero di** lavoratori.
Utilizza la tabella seguente per determinare il tipo e il numero di lavoratori necessari per il tuo caso d'uso.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/clean-rooms/latest/userguide/query-id-mapping-tables.html)
**Nota**
Diversi tipi di lavoratori e numero di lavoratori hanno costi associati. Per ulteriori informazioni sui prezzi, consulta la pagina [AWS Clean Rooms dei prezzi](https://aws.amazon.com/clean-rooms/pricing/).
1. Scegli **Esegui**.
**Nota**
Non puoi eseguire la query se il membro che può ricevere i risultati non ha configurato le impostazioni dei risultati della query.
1. Visualizza i **risultati**.
Per ulteriori informazioni, consulta [Ricezione e utilizzo dei risultati delle analisi](receive-query-results.md).
1. Continua a modificare i parametri ed esegui nuovamente la query oppure scegli il pulsante **\$1** 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](troubleshooting.md).
# Interrogazione di tabelle configurate utilizzando un modello di analisi SQL
Questa procedura dimostra come utilizzare un modello di analisi nella AWS Clean Rooms console per interrogare le tabelle configurate con la regola di analisi **personalizzata**.
**Per utilizzare un modello di analisi SQL per interrogare le tabelle configurate con la regola di analisi **personalizzata****
1. Accedi a Console di gestione AWS e apri la AWS Clean Rooms console all'indirizzo [https://console.aws.amazon.com/cleanrooms.](https://console.aws.amazon.com/cleanrooms/home)
1. **Nel riquadro di navigazione a sinistra, scegli Collaborazioni.**
1. Scegli la collaborazione per la quale è stato **assegnato lo status di Membro** **Esegui interrogazioni**.
1. Nella scheda **Analisi**, nella sezione **Tabelle, visualizza le tabelle** e il tipo di regola di analisi associato (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](associate-configured-table.md).
Le tabelle non hanno una [regola di analisi configurata](add-analysis-rule.md).
1. Nella sezione **Analisi**, per la **modalità Analisi**, seleziona **Esegui modelli di analisi**, quindi scegli il modello di analisi dall'elenco a discesa.
1. **I parametri del modello di analisi SQL verranno inseriti automaticamente nella definizione.**
1. Specificare il **tipo di lavoratore** supportato e il **numero di lavoratori**.
Utilizza la tabella seguente per determinare il tipo e il numero di lavoratori necessari per il tuo caso d'uso.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/clean-rooms/latest/userguide/use-analysis-template.html)
**Nota**
Diversi tipi di lavoratori e numero di lavoratori hanno costi associati. Per ulteriori informazioni sui prezzi, consulta la pagina [AWS Clean Rooms dei prezzi](https://aws.amazon.com/clean-rooms/pricing/).
1. Specificate le **proprietà Spark** supportate.
1. Seleziona **Aggiungi proprietà Spark**.
1. **Nella finestra di dialogo delle **proprietà di Spark**, scegli **il nome di una proprietà** dall'elenco a discesa e inserisci un valore.**
La tabella seguente fornisce una definizione per ogni proprietà.
Per ulteriori informazioni sulle proprietà di Spark, consulta [Spark Properties nella documentazione](https://spark.apache.org/docs/latest/configuration.html#spark-properties) di Apache Spark.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/clean-rooms/latest/userguide/use-analysis-template.html)
1. Scegli **Esegui**.
**Nota**
Non è possibile eseguire la query se il membro che può ricevere i risultati non ha configurato le impostazioni dei risultati della query.
1. Continua a modificare i parametri ed esegui nuovamente la query oppure scegli il pulsante **\$1** per iniziare una nuova query in una nuova scheda.
# Esecuzione di interrogazioni con il generatore di analisi
Puoi utilizzare Analysis Builder 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](analysis-rules-aggregation.md) senza che sia richiesto JOIN
+ Due tabelle (una per ogni membro) che utilizzano entrambe la regola di analisi di [aggregazione](glossary.md#glossary-agg-analysis-rule)
+ Due tabelle (una per ogni membro) che utilizzano entrambe la regola di [analisi degli elenchi](glossary.md#glossary-list-analysis-rule)
+ 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. [Interrogazione di tabelle configurate utilizzando l'editor di codice SQL](use-sql-editor.md)
Il generatore di analisi viene visualizzato come opzione dell'**interfaccia utente di Analysis builder** nella sezione **Analisi** della scheda **Analisi** 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.
**Topics**
+ [Utilizzate il generatore di analisi per interrogare una singola tabella (aggregazione)](#use-analysis-builder-one-table)
+ [Utilizza il generatore di analisi per interrogare due tabelle (aggregazione o elenco)](#use-analysis-builder-two-tables)
## 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à](analysis-rules-aggregation.md). JOIN
**Per utilizzare il generatore di analisi per interrogare una singola tabella**
Accedi a Console di gestione AWS e apri la AWS Clean Rooms console all'indirizzo [https://console.aws.amazon.com/cleanrooms.](https://console.aws.amazon.com/cleanrooms/home)
1. **Nel riquadro di navigazione a sinistra, scegli Collaborazioni.**
1. Scegli la collaborazione per la quale è stato **assegnato lo status di Membro** **Esegui interrogazioni**.
1. Nella scheda **Analisi**, 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](associate-configured-table.md).
La tabella non ha una [regola di analisi configurata](add-analysis-rule.md).
1. Nella sezione **Analisi**, attiva l'**interfaccia utente di Analysis Builder**.
1. 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.
1. (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.
1. (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.
1. (Facoltativo) Per **Aggiungi descrizione: facoltativo**, inserisci una descrizione per identificare l'interrogazione nell'elenco delle interrogazioni.
1. Espandi il **codice SQL di anteprima**.
1. Visualizza il codice SQL generato dal generatore di analisi.
1. Per copiare il codice SQL, scegli **Copia**.
1. Per modificare il codice SQL, scegli **Modifica nell'editor di codice SQL**.
1. Scegli **Esegui**.
**Nota**
Non puoi eseguire la query se il membro che può ricevere i risultati non ha configurato le impostazioni dei risultati della query.
1. Continua a modificare i parametri ed esegui nuovamente la query oppure scegli il pulsante **\$1** 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](troubleshooting.md).
## 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](analysis-rules-aggregation.md)
+ Due tabelle (una per ogni membro) che utilizzano entrambe la regola di [analisi degli elenchi](analysis-rules-list.md)
+ 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**
Accedi a Console di gestione AWS e apri la AWS Clean Rooms console all'indirizzo [https://console.aws.amazon.com/cleanrooms.](https://console.aws.amazon.com/cleanrooms/home)
1. **Nel riquadro di navigazione a sinistra, scegli Collaborazioni.**
1. Scegli la collaborazione per la quale le **abilità del tuo socio sono impostate** sullo stato **Run queries..**
1. Nella scheda **Analisi**, 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](associate-configured-table.md).
Le tabelle non hanno una [regola di analisi configurata](add-analysis-rule.md).
1. Nella sezione **Analisi**, attiva l'**interfaccia utente di Analysis Builder**.
1. 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.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/clean-rooms/latest/userguide/query-data-analysis-builder.html)
1. Espandi il **codice SQL di anteprima**.
1. Visualizza il codice SQL generato dal generatore di analisi.
1. Per copiare il codice SQL, scegli **Copia**.
1. Per modificare il codice SQL, scegli **Modifica nell'editor di codice SQL**.
1. Scegli **Esegui**.
**Nota**
Non puoi eseguire la query se il membro che può ricevere i risultati non ha configurato le impostazioni dei risultati della query
1. Continua a modificare i parametri ed esegui nuovamente la query oppure scegli il pulsante **\$1** 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](troubleshooting.md).
# Visualizzazione dell'impatto della 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 non è disponibile un budget sufficiente per la privacy. 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 Console di gestione AWS e apri la AWS Clean Rooms console all'indirizzo [https://console.aws.amazon.com/cleanrooms.](https://console.aws.amazon.com/cleanrooms/home)
1. **Nel riquadro di navigazione a sinistra, scegli Collaborazioni.**
1. Scegli la collaborazione per la quale i **dati del tuo socio** sono impostati sullo stato **Esegui interrogazioni**.
1. Nella scheda **Analisi**, 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.
1. 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 query eseguite negli ultimi 90 giorni nella scheda **Analisi**.
**Nota**
Se la tua unica abilità di iscrizione è **Contribute data** e non sei il [membro che paga i costi di calcolo delle query](glossary.md#glossary-member-paying-for-query-compute), la scheda **Analisi** non viene visualizzata sulla console.
**Per visualizzare le interrogazioni recenti**
Accedi a Console di gestione AWS e apri la AWS Clean Rooms console all'indirizzo [https://console.aws.amazon.com/cleanrooms.](https://console.aws.amazon.com/cleanrooms/home)
1. **Nel riquadro di navigazione a sinistra, scegli Collaborazioni.**
1. Scegli una collaborazione.
1. Nella scheda **Analisi**, in **Analisi**, seleziona **Tutte le interrogazioni** dal menu a discesa e visualizza le query eseguite negli ultimi 90 giorni.
1. **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
Puoi visualizzare i dettagli della query come membro che può eseguire le query o come membro che può ricevere risultati.
**Per visualizzare i dettagli della query**
1. Accedi a Console di gestione AWS e apri la AWS Clean Rooms console all'indirizzo [https://console.aws.amazon.com/cleanrooms.](https://console.aws.amazon.com/cleanrooms/home)
1. **Nel riquadro di navigazione a sinistra, scegli Collaborazioni.**
1. Scegli una collaborazione.
1. Nella scheda **Analisi**, effettuate una delle seguenti operazioni:
+ Scegliete il pulsante di opzione per l'interrogazione specifica che desiderate visualizzare, quindi scegliete **Visualizza dettagli**.
+ Scegli l'**ID della query protetta**.
1. 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**.