Scrivere query ed esplorare i dati nell'editor SQL

L'interfaccia utente di Azure Databricks include un editor SQL che è possibile usare per creare query, esplorare i dati disponibili e creare visualizzazioni. È anche possibile condividere le query salvate con altri membri del team nell'area di lavoro. Questo articolo illustra come usare l'editor SQL per scrivere, eseguire e gestire query. Una nuova versione dell'editor SQL è disponibile in anteprima pubblica. Per informazioni su come abilitare e usare il nuovo editor SQL, vedere Collaborare con i colleghi usando il nuovo editor SQL.

Dopo aver aperto l'editor, è possibile creare una query SQL o esplorare i dati disponibili. L'editor di testo supporta il completamento automatico, la formattazione automatica e vari altri tasti di scelta rapida.

È possibile aprire più query usando le schede di query nella parte superiore dell'editor di testo. Ogni scheda query include controlli per l'esecuzione della query, il contrassegno della query come preferito e la connessione a un'istanza di SQL warehouse. Per le query, sono inoltre disponibili le opzioni Salva, Pianifica, o Condividi.

Aprire l'editor SQL

Per aprire l'editor SQL nell'interfaccia utente di Azure Databricks, fare clic su Editor SQL nella barra laterale.

L'editor SQL si apre all'ultima query aperta. Se non esiste alcuna query o tutte le query sono state chiuse in modo esplicito, verrà aperta una nuova query. Viene automaticamente denominato Nuova Query e il timestamp di creazione viene aggiunto nel titolo.

Connessione all’ambiente di calcolo

Per eseguire query, è necessario disporre almeno delle autorizzazioni CAN USE per un'istanza di SQL warehouse in esecuzione. È possibile usare l'elenco a discesa nella parte superiore dell'editor per visualizzare le opzioni disponibili. Per filtrare il list, immettere testo nella casella di testo.

La prima volta che si crea una query, la list dei warehouse SQL disponibili viene visualizzata in ordine alfabetico. L'ultima istanza di SQL warehouse usata viene selezionata alla successiva creazione di una query.

L'icona accanto a SQL warehouse indica lo stato:

• In esecuzione
• Avvio
• Arrestato

L'istanza di SQL warehouse selezionata verrà riavviata automaticamente quando si esegue la query. Vedere Avviare un'istanza di SQL warehouse per informazioni su altri modi per avviare un'istanza di SQL warehouse.

Esplorare gli oggetti dati nell'editor SQL

Se si dispone dell'autorizzazione di lettura dei metadati, il browser schema nell'editor SQL mostra i database disponibili e tables. È anche possibile esplorare gli oggetti dati da Esplora Catalog.

È possibile spostarsi tra oggetti di database Catalogregolati da Unity in Catalog Explorer senza calcolo attivo. Per esplorare i dati nel hive_metastore e in altri catalogs non gestiti da Unity Catalog, è necessario collegarsi alle risorse di calcolo con i privilegi appropriati. Vedere Governance dei dati con Unity Catalog.

Fare clic sull'icona nella parte superiore del browser schema per refreshschema. È possibile filtrare il schema digitando stringhe di filtro nella casella di ricerca.

Fare clic su un nome di table per visualizzare il columns per tale table.

Creare una query

È possibile immettere testo per creare una query nell'editor SQL. È possibile insert elementi dal browser schema per fare riferimento a catalogs e tables.

1. Digitare la query nell'editor SQL.

   L'editor SQL supporta il completamento automatico. Durante la digitazione, il completamento automatico suggerisce i completamenti. Ad esempio, se un completamento valido nella posizione del cursore è un column, il completamento automatico suggerisce un nome column. Se si digita select * from table_name as t where t., il completamento automatico riconosce che t è un alias per table_name e suggerisce il columns all'interno di table_name.

   

2. (Facoltativo) Al termine dell'azione di modifica, fare clic su Salva. Per impostazione predefinita, la query viene salvata nella home folder dell'utente oppure è possibile select un percorso diverso. Fare quindi clic su Salva.

Attivare e disattivare il completamento automatico

Il completamento automatico in tempo reale può completare i token schema, gli identificatori della sintassi di query (come SELECT e JOIN), e i titoli dei frammenti di query . È abilitata per impostazione predefinita, a meno che il database schema non superi i cinquemila token (tables o columns).

Usare l'interruttore sotto l'editor SQL per attivare o disattivare il completamento automatico in tempo reale.

• Per disattivare il completamento automatico in tempo reale, premere Ctrl + Spazio o fare clic sul pulsante sotto l'editor SQL.

Salva query

Il pulsante Salva in alto a destra dell'editor SQL salva la query.

Modificare più query

Per impostazione predefinita, l'editor SQL usa schede in modo da poter modificare più query contemporaneamente. Per aprire una nuova scheda, fare clic su +, quindi selectCrea una nuova query o Apri una query esistente. Fare clic su Apri query esistente per visualizzare le list delle query salvate. Clicca su Le Mie Richieste o Preferiti per filtrare il list delle query. Nella riga contenente la query che si desidera visualizzare fare clic su Apri.

Eseguire una singola query o più query

Per eseguire una query o tutte le query:

1. Select un SQL warehouse.

2. Evidenziare una query nell'editor SQL (se nel riquadro query sono presenti più query).

3. Premere Ctrl/Cmd + Invio oppure fare clic su Esegui (1000) per visualizzare i risultati come table nel riquadro dei risultati.

   

Terminare una query

Per terminare una query durante l'esecuzione, fare clic su Annulla. Un amministratore può arrestare una query in esecuzione avviata da un altro utente visualizzando la query Termina una query in esecuzione.

Opzioni di query

È possibile usare il menu contestuale kebab nella parte superiore dell'editor di query per accedere alle opzioni di menu per clonare, ripristinare, formattare e modificare le informazioni sulle query.

Ripristinare la query salvata

Quando si modifica una query, viene visualizzata un'opzione Ripristina modifiche nel menu di scelta rapida per la query. È possibile fare clic su Ripristina per tornare alla versione salvata.

Eliminazione e ripristino di query

Per spostare una query nel cestino:

• Fare clic sul menu Kebab di scelta rapida accanto alla query nell'editor SQL e selectSposta nel Cestino.
• Fare clic su Sposta nel cestino per confermare.

Per restore una query dalla cartella del cestino:

1. In Tutte le query listfare clic su .
2. Cliccare su una query.
3. Fare clic sul menu di scelta rapida kebab in alto a destra dell'editor SQL e fare clic su Restore.

Set descrizione della query e visualizza le informazioni sulla query

Per set una descrizione della query:

1. Fare clic sul menu contestuale kebab accanto alla query e fare clic su Modifica informazioni query.

   

2. Nella casella Descrizione immettere una descrizione. Fare quindi clic su Salva. È anche possibile visualizzare la cronologia della query, inclusa la creazione e l'aggiornamento, in questa finestra di dialogo.

Query preferite e tag

È possibile usare preferiti e tag per filtrare gli elenchi di query e dashboard visualizzati nella pagina di destinazione di Databricks SQL e negli elenchi query e dashboard.

Preferiti: per aggiungere una query ai preferiti, fare clic sulla stella a sinistra del titolo in Queries list. La stella diventerà gialla.

Tag: è possibile contrassegnare query e dashboard con qualsiasi stringa significativa per l'organizzazione.

Aggiungere un tag

Aggiungere tag nell'editor di query.

1. Fare clic sul menu contestuale kebab accanto alla query e fare clic su Modifica informazioni query. Viene visualizzata una finestra di dialogo Informazioni query.

2. Se la query non ha tag applicati,Aggiungi alcuni tag viene visualizzato nella casella di testo where appariranno i tag. Per creare un nuovo tag, digitarlo nella casella. Per immettere più tag, premere tabulazioni tra le voci.

   

3. Fare clic su Salva per applicare i tag e chiudere la finestra di dialogo.

tag Remove

1. Fare clic sul menu contestuale kebab accanto alla query e fare clic su Modifica informazioni query.
2. Fare clic su X su qualsiasi tag che desideri remove.
3. Fare clic su Salva per chiudere la finestra di dialogo.

Visualizza i risultati delle query

Dopo l'esecuzione di una query, i risultati vengono visualizzati nel riquadro sottostante. Il Nuovo risultato è ON per le nuove query. Se necessario, fare clic sull'elenco a discesa per disattivarla. Le immagini in questa sezione usano il nuovo risultato table.

È possibile interagire ed esplorare i risultati della query usando il riquadro dei risultati. Il riquadro dei risultati include le funzionalità seguenti per l'esplorazione dei risultati:

Visualizzazioni, filtri e parameters

Fare clic su per aggiungere una visualizzazione, un filtro o un parametro. Vengono visualizzate le opzioni seguenti:

Visualizzazione: le visualizzazioni possono aiutare a esplorare il risultato set. Vedere Tipi di visualizzazione per un list completo dei tipi di visualizzazione disponibili.

Filtro: i filtri consentono di limit il risultato set dopo che una query è stata eseguita. È possibile applicare filtri per visualizzare in modo selettivo subset diversi dei dati. Vedere Filtri di query per informazioni su come usare i filtri.

Parametro: Parameters consente di limit il risultato set sostituendo values in una query durante l'esecuzione. Vedere Usare parameters di query per informazioni su come applicare parameters.

Modificare, scaricare o aggiungere a un dashboard

Fare clic su in una scheda dei risultati per visualizzare altre opzioni.

1. Fare clic su Modifica per personalizzare i risultati visualizzati nella visualizzazione.
2. Fare clic su Elimina per eliminare il nuovo record.
3. Fare clic su Duplica per clonare la scheda dei risultati.
4. Fare clic su Aggiungi al dashboard per copiare la query e la visualizzazione in un nuovo dashboard.
   • Questa azione crea un nuovo dashboard che include tutte le visualizzazioni associate alla query. Vedere Dashboard per informazioni su come modificare il dashboard.
   • Viene richiesto di scegliere un nome per il nuovo dashboard. Il dashboard importato viene salvato nella cartella utente.
   • Non è possibile aggiungere risultati a un dashboard esistente.
5. Fare clic su Aggiungi al dashboard legacy per aggiungere la scheda dei risultati a un dashboard legacy nuovo o esistente.
6. Fare clic su una delle opzioni di download per scaricare i risultati. Per altre informazioni e limiti, vedere la descrizione seguente.

Scaricare risultati: è possibile scaricare un risultato della query come file CSV, TSV o Excel.

È possibile scaricare fino a circa 1 GB di dati dei risultati da Databricks SQL in formato CSV e TSV e fino a 100.000 righe in un file Excel.

La dimensione finale del download del file potrebbe essere leggermente superiore o inferiore a 1 GB, perché il limit da 1 GB viene applicato a un passaggio precedente rispetto al download del file finale.

Esecuzioni precedenti

È possibile visualizzare le esecuzioni precedenti per la query, inclusa la sintassi di query completa. Le esecuzioni precedenti vengono aperte in modalità di sola lettura e includono i pulsanti Clona in una nuova query o Riprendi modifica. Questa scheda non mostra le esecuzioni pianificate.

Esplorare i risultati

I risultati della query restituiti vengono visualizzati sotto la query. La scheda Risultati non elaborati viene popolata con le righe restituite. È possibile usare filtri predefiniti per riordinare i risultati in modo crescente o decrescente values. È anche possibile usare il filtro per cercare le righe dei risultati che includono un valore specifico.

È possibile usare le tab nel pannello dei risultati per aggiungere visualizzazioni, filtri e parameters.

Filtrare il list di query salvate nelle query window

Nelle query window, puoi filtrare il list di tutte le query in base al list delle query che hai creato (Le mie query), ai preferiti e ai tag.

Automatizzare gli aggiornamenti

È possibile utilizzare il pulsante Pianificazione per set una cadenza automatica per le esecuzioni delle query. Gli aggiornamenti automatici consentono di mantenere aggiornati i dashboard e i report con i dati più recenti. Le query programmate possono anche abilitare gli avvisi SQL di Databricks, un tipo speciale di attività pianificata che invia notifiche quando un valore raggiunge una soglia specificata.

Vedere Pianificare una query.

Vedere Che cosa sono gli avvisi di SQL Databricks?.

Condivisione di query

Il pulsante Condividi consente di condividere la query con altri utenti nell'area di lavoro. Quando si esegue una condivisione, scegliere una delle opzioni seguenti:

• Esegui come proprietario (credentialsproprietario): questa impostazione significa che gli spettatori possono vedere gli stessi risultati della query come il proprietario della query. Questo vale per le esecuzioni di query pianificate o manuali.
• Esegui come visualizzatore (visualizzatori credentials): Questa impostazione limita i risultati alle autorizzazioni assegnate al visualizzatore.

Vedere Configurare le autorizzazioni per le query.

Passaggio successivo

Vedere Accedere e gestire le query salvate per informazioni su come usare le query con l'interfaccia utente di Azure Databricks.