

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à.

# Interrogazione di tabelle configurate utilizzando l'editor di codice SQL
<a name="use-sql-editor"></a>

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).