Amazon Redshift non supporterà più la creazione di nuovi Python UDFs a partire dalla Patch 198. Python esistente UDFs continuerà a funzionare fino al 30 giugno 2026. Per ulteriori informazioni, consulta il [post del blog](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/).
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à.
# Creazione di query con Amazon Redshift
È possibile inserire una query nell'editor o selezionare una query salvata dall'elenco **Query** e scegliere **Esegui**.
Per impostazione predefinita, **Limite 100** è impostato per limitare i risultati a 100 righe. È possibile disattivare questa opzione per restituire un set di risultati più ampio. Se si disattiva questa opzione, è possibile includere l'opzione LIMITE nell'istruzione SQL se si desidera evitare set di risultati molto grande. Per ulteriori informazioni, consultare [Clausola ORDINA PER](https://docs.aws.amazon.com/redshift/latest/dg/r_ORDER_BY_clause.html) nella *Guida per gli sviluppatori di database di Amazon Redshift*.
Per visualizzare un piano di query nell'area dei risultati, attivare **Spiega**. Attiva **Explain graph** (Grafico Explain) affinché nei risultati venga visualizzata anche una rappresentazione grafica del piano Explain.
Per salvare una query nella cartella **Query**, scegliere **Salva**.
Per una query riuscita, viene visualizzato un messaggio di successo. Se la query restituisce informazioni, i risultati vengono visualizzati nella sezione **Risultati**. Se il numero di risultati supera l'area di visualizzazione, i numeri vengono visualizzati nella parte superiore dell'area dei risultati. È possibile scegliere i numeri per visualizzare le pagine successive dei risultati.
È possibile filtrare e ordinare **Risultato** per ogni colonna. Per inserire i criteri di filtro nell'intestazione della colonna dei risultati, passa il mouse sopra la colonna per visualizzare un menu () dove è possibile inserire i criteri per filtrare la colonna.
Se la query contiene un errore, l'editor di query v2 visualizza un messaggio di errore nell'area dei risultati. Il messaggio fornisce informazioni su come correggere la query.
È possibile esportare o copiare i risultati della query utilizzando il menu contestuale (pulsante destro del mouse) nell'area dei risultati come indicato di seguito:
+ Scegli **Copia in** e **JSON** o **CSV** per scaricare le righe selezionate in un file.
+ Scegli **Copia righe** per copiare le righe selezionate negli appunti.
+ Scegli **Copia righe con intestazioni** per copiare le righe selezionate con intestazioni di colonna negli appunti.
Puoi scegliere **Esporta** nell’area dei risultati, quindi scegli **JSON** o **CSV** per scaricare l’intero insieme di risultati di riga in un file. Il numero di righe nel set di risultati potrebbe essere limitato dall'opzione **Limite** o dalla clausola SQL `limit` nella query. La dimensione massima del set di risultati scaricato è 5 MB.
È inoltre possibile utilizzare i tasti di scelta rapida Ctrl\+C su Windows o Cmd\+C su macOS per copiare i dati dalla pagina dei risultati corrente negli appunti. Se ci sono righe selezionate, la cella con lo stato attivo viene copiata negli appunti. Se ci sono righe selezionate, queste ultime vengono copiate negli appunti.
Per aggiungere una nuova scheda della query, selezionare l'icona , quindi **Editor**, che appare nella riga con le schede della query. È possibile che la scheda della query utilizzi `Isolated session`. Con una sessione isolata, i risultati di un comando SQL in una scheda dell'editor, ad esempio la creazione di una tabella temporanea, non sono visibili in un'altra scheda dell'editor. Quando si apre una scheda nell'editor di query v2, per impostazione predefinita viene usata una sessione isolata.
**Per eseguire una query**
1. Nell'area della query effettuare una delle seguenti operazioni:
+ Inserisci una query.
+ Incolla una query copiata.
+ Selezionare la cartella **Query**, aprire dal menu contestuale (tasto destro del mouse) una query salvata e scegliere **Aprire una query**.
1. Conferma di aver scelto il valore corretto di **Cluster** o **Workgroup** (Gruppo di lavoro) e **Database** per l'SQL che intendi eseguire.
Inizialmente, puoi scegliere **Cluster** o **Workgroup** (Gruppo di lavoro) nella struttura ad albero. Nella stessa struttura, scegli anche **Database**.
Puoi modificare i valori nei campi **Cluster** o **Gruppo di lavoro** e **Database** all’interno di ogni scheda dell’editor mediante il controllo a discesa accanto all’intestazione **Sessione isolata**.
Per ogni scheda dell'editor, è possibile scegliere se eseguire il codice SQL in una **sessione isolata**. Una sessione isolata dispone di una propria connessione a un database. È possibile utilizzarla per eseguire comandi SQL isolati rispetto alle altre sessioni dell'editor di query. Per ulteriori informazioni sulle connessioni, consulta [Apertura editor di query v2](query-editor-v2-open.md).
1. Scegli **Esegui**.
L'area **Risultati** si apre e visualizza i risultati della query.
**Per visualizzare il piano di spiegazione per una query**
1. Seleziona la query.
1. Attivare **Spiega**.
Per impostazione predefinita, anche **Spiega il grafico** è attivato.
1. Scegli **Esegui**.
La query viene eseguita e il piano di spiegazione viene visualizzato nell'area **Risultato** della query.
L'editor di query v2 supporta le seguenti funzionalità:
+ È possibile autorizzare query con più istruzioni SQL in un'unica scheda di query. Le query vengono eseguite in serie e vengono aperte più schede dei risultati per ogni query.
+ È possibile autorizzare query con variabili di sessione e tabelle temporanee.
+ È possibile autorizzare query con parametri sostituibili designati da `${{{parameter}}}`. È possibile autorizzare la query SQL con più parametri sostituibili e utilizzare lo stesso parametro in più posizioni nell'istruzione SQL.
Quando la query viene eseguita, viene visualizzata una finestra per inserire il valore del parametro. Ogni volta che si esegue la query, viene visualizzata la finestra per immettere i valori dei parametri.
Per vedere un esempio, consulta [Esempio: vendite superiori a un parametro specifico](#query-editor-v2-example-sales-qtysold-greater-than-parameter).
+ Viene eseguito automaticamente un controllo delle versioni delle query. È possibile scegliere una versione precedente di una query da eseguire.
+ Non è necessario attendere il completamento di una query prima di continuare con il flusso di lavoro. Le query continuano ad essere eseguite anche se si chiude l'editor di query.
+ Quando si creano query, è supportato il completamento automatico dei nomi di schema, tabella e colonna.
L'editor SQL supporta le seguenti caratteristiche:
+ Le parentesi iniziali e finali utilizzate in SQL hanno colori corrispondenti. Le linee verticali sono mostrate nell'editor per aiutare ad abbinare le parentesi.
+ Puoi comprimere ed espandere sezioni dell'SQL.
+ Puoi ricercare e sostituire il testo nell'SQL.
+ È possibile utilizzare i tasti di scelta rapida per diverse attività comuni di modifica.
+ Gli errori SQL sono evidenziati nell'editor per facilitare l'individuazione delle aree problematiche.
Per una demo delle caratteristiche dell'editor, guarda il video seguente.
[](http://www.youtube.com/watch?v=9JAq0yDs0YE)
## Esempi di query
Di seguito vengono fornite le descrizioni dei vari tipi di query che è possibile eseguire.
I dati utilizzati in molte di queste query provengono dallo schema di esempio `tickit`. Per ulteriori informazioni sul caricamento dei dati di esempio in `tickit`, consulta [Caricamento dei dati in un database](query-editor-v2-loading.md). Per informazioni sui dati di esempio `tickit`, consulta [Database di esempio](https://docs.aws.amazon.com/redshift/latest/dg/c_sampledb.html) nella *Guida per gli sviluppatori di database di Amazon Redshift*.
Quando si eseguono queste query di esempio, confermare di aver scelto il database corretto nell'editor, ad esempio `sample_data_dev`.
**Topics**
+ [Esempio: impostazione delle variabili di sessione](#query-editor-v2-example-set-session-variable)
+ [Esempio: migliore evento per vendite totali](#query-editor-v2-example-top-event-sales)
+ [Esempio: vendite superiori a un parametro specifico](#query-editor-v2-example-sales-qtysold-greater-than-parameter)
+ [Esempio: Creazione di una tabella temporanea](#query-editor-v2-example-create-temporary-table)
+ [Esempio: selezione da una tabella temporanea](#query-editor-v2-example-select-from-temporary-table)
### Esempio: impostazione delle variabili di sessione
Il comando seguente imposta il parametro di configurazione del server `search_path` *pubblico* per la sessione. Per ulteriori informazioni, consultare [IMPOSTA](https://docs.aws.amazon.com/redshift/latest/dg/r_SET.html) e [search\_path](https://docs.aws.amazon.com/redshift/latest/dg/r_search_path.html) nella *Guida per gli sviluppatori di database di Amazon Redshift*.
```
set search_path to public;
```
### Esempio: migliore evento per vendite totali
La seguente query trova l'evento con il maggior numero di vendite.
```
select eventname, count(salesid) totalorders, sum(pricepaid) totalsales
from sales, event
where sales.eventid=event.eventid
group by eventname
order by 3;
```
Di seguito è riportato un elenco parziale dei risultati.
```
eventname totalorders totalsales
White Christmas 20 9352
Joshua Radin 38 23469
Beach Boys 58 30383
Linda Ronstadt 56 35043
Rascal Flatts 76 38214
Billy Idol 67 40101
Stephenie Meyer 72 41509
Indigo Girls 57 45399
...
```
### Esempio: vendite superiori a un parametro specifico
La seguente query rileva le vendite in cui la quantità venduta è superiore al parametro specificato da `${numberoforders}`. Quando il valore del parametro è `7`, il risultato è di 60 righe. Quando si esegue la query, l'editor di query v2 visualizza la finestra **Modulo di esecuzione della query** per raccogliere il valore dei parametri nell'istruzione SQL.
```
select salesid, qtysold
from sales
where qtysold > ${numberoforders}
order by 2;
```
Di seguito è riportato un elenco parziale dei risultati.
```
salesid qtysold
20005 8
21279 8
130232 8
42737 8
74681 8
67103 8
105533 8
91620 8
121552 8
...
```
### Esempio: Creazione di una tabella temporanea
La seguente istruzione crea la tabella temporanea *eventsalestemp* selezionando le informazioni dalle tabelle *vendite* e *evento*.
```
create temporary table eventsalestemp as
select eventname, count(salesid) totalorders, sum(pricepaid) totalsales
from sales, event
where sales.eventid=event.eventid
group by eventname;
```
### Esempio: selezione da una tabella temporanea
La seguente istruzione seleziona eventi, ordini totali e vendite totali dalla tabella temporanea *eventsalstemp*, ordinato per ordini totali.
```
select eventname, totalorders, totalsales
from eventsalestemp
order by 2;
```
Di seguito è riportato un elenco parziale dei risultati.
```
eventname totalorders totalsales
White Christmas 20 9352
Joshua Radin 38 23469
Martina McBride 50 52932
Linda Ronstadt 56 35043
Indigo Girls 57 45399
Beach Boys 58 30383
...
```