Utilizzo di SQL Runner per creare query ed esplorazioni

SQL Runner consente di accedere direttamente al database e di sfruttare tale accesso in diversi modi. Con SQL Runner, puoi navigare facilmente tra le tabelle dello schema, utilizzare un'esplorazione ad hoc da una query SQL, eseguire query descrittive prescritte sui dati, visualizzare la cronologia di SQL Runner, scaricare i risultati, condividere query, aggiungere a un progetto LookML come tabella derivata ed eseguire altre attività utili.

In questa pagina viene descritto come eseguire query in SQL Runner, creare esplorazioni ad hoc e come utilizzare SQL Runner per eseguire il debug delle query. Consulta queste altre pagine della documentazione per informazioni su:

Esecuzione delle query in SQL Runner

Per eseguire una query sul database, puoi scrivere la query SQL da zero, utilizzare un'esplorazione per creare la query o eseguire una query su un modello LookML. Puoi anche utilizzare la cronologia per eseguire nuovamente una query precedente.

Scrivere una query SQL da zero

Puoi utilizzare SQL Runner per scrivere ed eseguire le tue query SQL sul tuo database. Looker passa la query al tuo database esattamente come l'hai scritta, quindi assicurati che la sintassi della query SQL sia valida per il dialetto del database. Ad esempio, ogni dialetto ha funzioni SQL leggermente diverse con parametri specifici che devono essere passati alla funzione.

  1. Inserisci una query SQL nella casella di testo sotto la barra Query.
  2. Facoltativamente, seleziona un nome di tabella o un campo dall'elenco dei campi per includerlo nella query nella posizione del cursore.
  3. Seleziona Esegui per eseguire la query sul tuo database.
  4. Visualizza i risultati nell'area Risultati. SQL Runner caricherà fino a 5000 righe del set di risultati della query. Per i dialetti SQL che supportano il flusso di dati, puoi scaricare i risultati per visualizzare l'intero set di risultati.

Alcuni programmi SQL consentono di eseguire più query in una serie. Tuttavia, puoi eseguire una sola query alla volta in SQL Runner. SQL Runner ha anche un limite di 65.535 caratteri per le query, compreso lo spazio vuoto.

Dopo aver eseguito una query, puoi aggiungerla a un progetto, ottenere il LookML per una tabella derivata o condividere la query.

Puoi anche utilizzare SQL Runner per provare nuove query o testare query esistenti. L'evidenziazione degli errori di SQL Runner consente di testare ed eseguire il debug delle query.

Utilizzo di un'esplorazione per creare una query SQL

Puoi anche utilizzare un'esplorazione per creare una query e ottenere il comando SQL per quella query da utilizzare in SQL Runner:

  1. Da un'esplorazione, seleziona la scheda SQL dalla barra Dati.
  2. La query SQL verrà visualizzata sotto la barra Dati.
  3. Seleziona Apri in SQL Runner o Spiega in SQL Runner per aprire la query in SQL Runner.

Dopo aver aggiunto una query alla casella di testo sotto la barra Query, puoi selezionare Esegui per eseguire una query sul database. In alternativa, puoi modificare la query e poi eseguire la nuova.

Creazione di visualizzazioni con SQL Runner

Se l'amministratore di Looker ha abilitato la funzionalità di Labs SQL Runner Vis, puoi creare visualizzazioni direttamente in SQL Runner.

Se SQL Runner Vis è abilitato, i riquadri di SQL Runner vengono riorganizzati. Il riquadro di visualizzazione si trova in alto, il riquadro dei risultati al centro e il riquadro delle query in basso.

  1. Dopo aver creato ed eseguito una query SQL, puoi aprire la scheda Visualizzazione per vederla e scegliere un tipo di visualizzazione, proprio come faresti nella pagina Esplora.
  2. Puoi modificare la visualizzazione utilizzando il menu Impostazioni.
  3. Puoi condividere le visualizzazioni create con SQL Runner condividendo l'URL. Eventuali personalizzazioni apportate utilizzando il menu Impostazioni della visualizzazione verranno salvate e il link non cambierà.

Ci sono alcuni aspetti da tenere presente in merito al funzionamento delle visualizzazioni SQL Runner:

  • La tabella e la visualizzazione dei risultati interpretano qualsiasi campo numerico come misura.
  • Nella tabella e nella visualizzazione dei risultati viene sempre utilizzato il nome completo del campo. Pertanto, l'opzione Mostra nome completo campo nel menu Impostazioni non è attiva.
  • Per utilizzare campi personalizzati, calcoli tabulari, pivot, totali di colonne e subtotali, esplora la query SQL Runner.
  • Le visualizzazioni di mappe statiche (regioni) non sono supportate da quelle di SQL Runner, ma sono supportate le mappe che utilizzano dati di latitudine e longitudine (visualizzazioni di mappe e mappe statiche (punti).
  • Le visualizzazioni Timeline non sono supportate da quelle di SQL Runner.

Dimensioni pivot

Puoi modificare i risultati della query per eseguire il pivot in base a una o più dimensioni nelle visualizzazioni di SQL Runner. Per creare un pivot per un campo:

  1. Seleziona il menu a forma di ingranaggio di una colonna nell'area Risultati per visualizzare le opzioni della colonna.
  2. Seleziona Pivot Column (Colonna pivot).

I risultati sottoposti a pivot vengono mostrati nella visualizzazione SQL Runner.

I risultati nell'area Risultati non vengono visualizzati in una rotazione.

Per annullare il pivot dei risultati, seleziona il menu a forma di ingranaggio della colonna pivot e seleziona Svita colonna.

Modifica del tipo di campo

Quando visualizzi i risultati e la visualizzazione della query, SQL Runner interpreta automaticamente qualsiasi campo numerico come misura e qualsiasi campo non numerico come dimensione. Per eseguire l'override del tipo di campo predefinito e convertire una dimensione in una misura, o viceversa, segui questi passaggi:

  1. Seleziona il menu a forma di ingranaggio di una colonna nell'area Risultati per visualizzare le opzioni della colonna.
  2. Seleziona Converti in dimensione o Converti in misura per modificare il tipo di campo.

La visualizzazione mostrerà il nuovo tipo di campo.

Esecuzione di una query su un modello LookML

Puoi utilizzare SQL Runner per scrivere ed eseguire query SQL su un modello LookML, anziché direttamente sul tuo database. Quando crei la tua query su un modello, puoi utilizzare gli operatori di sostituzione LookML, ad esempio ${view_name.field_name} o ${view_name.SQL_TABLE_NAME}. In questo modo, ad esempio, si può risparmiare tempo quando si crea una query per la risoluzione dei problemi relativi a una tabella derivata.

Looker risolve tutte le sostituzioni LookML e poi passa la query al database, in modo che sia in SQL valido per il dialetto del database. Ad esempio, ogni dialetto ha funzioni SQL leggermente diverse con parametri specifici che devono essere passati alla funzione.

Per eseguire una query sul tuo modello LookML in SQL Runner:

  1. Seleziona la scheda Modello.
  2. Seleziona il modello su cui eseguire la query.
  3. Nella casella di testo sotto la barra Dati, inserisci la query SQL utilizzando i campi LookML.
  4. Facoltativamente, seleziona una visualizzazione nell'elenco per includerla nella query nella posizione del cursore.
  5. Per visualizzare l'elenco dei campi di una vista, selezionala nella sezione Viste. Facoltativamente, puoi selezionare un campo nell'elenco dei campi per includerlo nella query nella posizione del cursore.
  6. Nell'area Query SQL preparata, puoi visualizzare la query SQL risultante, creata dopo che qualsiasi sostituzione LookML è stata tradotta in SQL.
  7. Seleziona Esegui per eseguire la query sul tuo modello.
  8. Visualizza i risultati nell'area Risultati. SQL Runner carica fino a 5000 righe del set di risultati della query. Per i dialetti SQL che supportano i flussi di dati, puoi scaricare i risultati per visualizzare l'intero set di risultati.

Puoi utilizzare SQL Runner per provare nuove query, testare le query esistenti o aprire una nuova esplorazione dai risultati. L'evidenziazione degli errori di SQL Runner consente di testare ed eseguire il debug delle query.

Quando hai una query che ti piace, puoi condividerla e persino aggiungerla a un progetto LookML.

Visualizzazione del LookML di un campo da SQL Runner

Dall'elenco dei campi nella scheda Modello, puoi anche visualizzare il LookML di un campo. Passa il mouse sopra il campo nell'elenco dei campi e seleziona l'icona Looker a destra del nome del campo.

Looker apre l'IDE LookML e carica il file in cui è definito il campo.

Cronologia SQL Runner

Puoi anche visualizzare una cronologia recente di tutte le query eseguite in SQL Runner.

Per visualizzare la cronologia, seleziona la scheda Cronologia nella parte superiore del riquadro di navigazione. SQL Runner visualizza tutte le query eseguite sulla connessione al database. Il rosso indica una query che non è stata eseguita a causa di un errore.

Seleziona una query nella cronologia per compilarla in SQL Runner, quindi seleziona Esegui per eseguirla nuovamente.

Ordinamento della query

L'ordinamento di una tabella è indicato da una freccia verso l'alto o verso il basso accanto al nome del campo ordinato, a seconda che i risultati siano in ordine crescente o decrescente. Per ordinare le colonne in base a più colonne, tieni premuto il tasto Shift e seleziona le intestazioni di colonna nell'ordine che preferisci. L'ordinamento di un campo è indicato anche da un numero che ne distingue l'ordinamento rispetto agli altri campi, da una freccia accanto al nome del campo che mostra la direzione di ordinamento (crescente o decrescente) e da un popup che viene visualizzato quando passi il mouse sul nome di un campo.

Per ulteriori informazioni ed esempi, consulta la sezione Ordinamento dei dati nella pagina della documentazione Esplorazione dei dati in Looker.

Condivisione delle query

Puoi condividere una query in SQL Runner con un altro utente che dispone dell'accesso SQL Runner. Per condividere una query, copia l'URL nella barra degli indirizzi del browser.

Download dei risultati in corso...

Dopo aver eseguito la query SQL, puoi scaricare i risultati in diversi formati.

  1. Scrivi una query nella casella Query SQL. A questo punto non è necessario eseguire la query in SQL Runner.
  2. Seleziona Scarica dal menu a forma di ingranaggio in alto a destra.
  3. Seleziona il formato file per il download (file di testo, CSV, JSON e così via).

  4. Seleziona Apri nel browser per visualizzare i risultati in una nuova finestra del browser oppure seleziona Scarica per scaricarli in un file sul computer.

    Quando selezioni Apri nel browser o Scarica, Looker eseguirà nuovamente la query e poi eseguirà il download.

Per i dialetti SQL che supportano i flussi di dati, l'opzione Scarica di SQL Runner scaricherà l'intero set di risultati. Per i dialetti SQL che non supportano i flussi di dati, l'opzione SQL Runner Scarica consente di scaricare solo le righe della query visualizzate nella sezione Risultati (fino a 5000 righe).

Copia dei valori delle colonne

Puoi copiare i valori delle colonne dalla sezione Risultati di SQL Runner. Seleziona il menu a forma di ingranaggio di una colonna per copiare i valori negli appunti. Da qui puoi incollare i valori delle colonne in un file di testo, in un foglio di lavoro Excel o in un'altra posizione.

Se l'amministratore di Looker ha abilitato la funzionalità di Labs per SQL Runner Vis, sono disponibili anche altre opzioni nel menu dell'ingranaggio della colonna:

Puoi anche spostare, bloccare e ridimensionare manualmente le colonne nella tabella dei risultati.

Stime dei costi per le query SQL Runner

Per le connessioni BigQuery, MySQL, Amazon RDS per MySQL, Snowflake, Amazon Redshift, Amazon Aurora, PostgreSQL, Cloud SQL per PostgreSQL e Microsoft Azure PostgreSQL, SQL Runner fornisce una stima del costo della query. Dopo aver inserito la query SQL, SQL Runner calcolerà la quantità di dati richiesti dalla query e mostrerà le informazioni accanto al pulsante Esegui.

Per le connessioni BigQuery, MySQL e Amazon RDS per MySQL, le stime dei costi sono sempre abilitate. Per le connessioni ai database Snowflake, Amazon Redshift, Amazon Aurora, PostgreSQL, Cloud SQL per PostgreSQL e PostgreSQL di Microsoft Azure, devi abilitare l'opzione Stima dei costi per la connessione. Puoi attivare la Stima dei costi quando crei la connessione. Per le connessioni esistenti, puoi modificare la connessione dalla pagina Connessioni nella sezione Database del riquadro Amministrazione di Looker.

Creare un'esplorazione ad hoc

Da SQL Runner puoi ottenere rapidamente insight sui dati creando un'esplorazione ad hoc per una query SQL o una tabella di database. Puoi utilizzare l'esplorazione di Looker per selezionare i campi, aggiungere filtri, visualizzare i risultati e creare query SQL.

Esistono due modi per aprire un'esplorazione ad hoc da SQL Runner:

  • Esplora dai risultati della query di SQL Runner
  • Esplora dall'elenco di tabelle di SQL Runner

Esplorazione dai risultati delle query SQL Runner

SQL Runner consente di aprire un'esplorazione da una query SQL. Questa operazione crea un'esplorazione temporanea dalla query scritta in SQL Runner. Ciò ti consente di verificare ciò che viene restituito dalla query, nonché di visualizzare i risultati. Può essere utilizzata per qualsiasi query, ma è particolarmente utile per testare le query che prevedi di utilizzare per le tabelle derivate.

Se l'amministratore di Looker ha abilitato la funzionalità Labs SQL Runner Vis, puoi creare visualizzazioni direttamente in SQL Runner.

  1. Utilizza SQL Runner per creare la query SQL che vuoi utilizzare.
  2. Seleziona Esplora dal menu a forma di ingranaggio in alto a destra. Viene visualizzata una nuova esplorazione, in cui puoi esplorare la query SQL come se fosse una tabella salvata nel modello.
  3. Puoi copiare l'URL in questa esplorazione per condividerlo.
  4. Per aggiungere questa query come tabella derivata nel tuo progetto direttamente da qui, seleziona Aggiungi vista al progetto.

Creazione di campi personalizzati durante l'esplorazione in SQL Runner

Se hai accesso alla funzionalità campi personalizzati, puoi utilizzare questi campi per visualizzare i campi non modellati in SQL Runner. Come descritto nella sezione precedente, seleziona Esplora dal menu a forma di ingranaggio. Quindi, nel selettore campi, segui questi passaggi:

Esplorazione di una tabella elencata in SQL Runner

Utilizza l'opzione Tabella di esplorazione nella scheda Database per creare un'esplorazione ad hoc per qualsiasi tabella della connessione. In questo modo puoi utilizzare Looker su una tabella prima di modellarla, esplorandola come una vista LookML.

Dopo aver aperto un'esplorazione per la tabella, puoi decidere se aggiungerla al progetto. Puoi anche utilizzare la scheda SQL di Esplora per visualizzare le query SQL che Looker invia al database e quindi utilizzare il pulsante Apri in SQL Runner per riportare la query in SQL Runner.

  1. Seleziona la scheda Database.
  2. In SQL Runner, seleziona l'icona a forma di ingranaggio di una tabella, quindi seleziona Esplora tabella.
  3. Looker genera un modello temporaneo con una vista per la tabella e poi mostra l'esplorazione.
  4. Looker fornisce un campo dimensione per ogni colonna della tabella. Nello stesso modo in cui Looker genera un modello all'inizio di un progetto.
  5. Looker include automaticamente i periodi di tempo per tutti i campi delle date.
  6. Looker include anche una misura di conteggio.

Quando utilizzi l'opzione Esplora tabella, nessun file LookML è associato all'esplorazione: si tratta solo di una visualizzazione ad hoc della tabella.

Debug con SQL Runner

SQL Runner è utile anche per verificare gli errori SQL nelle query.

Evidenziazione dell'errore di SQL Runner

SQL Runner evidenzia la posizione degli errori nel comando SQL e include la posizione dell'errore nel messaggio di errore:

Le informazioni fornite sulla posizione varieranno a seconda del dialetto del database. Ad esempio, MySQL fornisce il numero di riga che contiene l'errore, mentre Redshift fornisce la posizione del carattere dell'errore. Altri dialetti di database potrebbero avere uno di questi o altri comportamenti.

SQL Runner evidenzia inoltre la posizione del primo errore di sintassi nel comando SQL sottolineandolo in rosso e contrassegnando la riga con una x. Tieni il puntatore sopra la x per visualizzare ulteriori informazioni sull'errore. Dopo aver risolto il problema, seleziona Esegui per vedere se la query contiene altri errori.

Utilizzo di SQL Runner per verificare gli errori nelle esplorazioni

Se riscontri errori di sintassi SQL in un'esplorazione, puoi utilizzare SQL Runner per determinare la posizione e il tipo di errore, ad esempio errori di ortografia o comandi mancanti.

  1. In Esplora, seleziona la scheda SQL della barra dei dati.
  2. Seleziona Apri in SQL Runner per aprire la query in SQL Runner.

Questa operazione copia l'SQL generato dall'esplorazione in SQL Runner. Come mostrato nella sezione Evidenziazione degli errori di SQL Runner, SQL Runner evidenzia la posizione degli errori nel comando SQL e include la posizione dell'errore nel messaggio di errore. È quindi possibile apportare modifiche ed eseguire nuovamente la query in SQL Runner fino a quando gli errori non sono stati corretti.

Utilizzo di SQL Runner per verificare gli errori nelle tabelle derivate

Per informazioni sull'utilizzo di SQL Runner per verificare gli errori SQL nelle tabelle derivate, consulta il post della community di Looker Utilizzo di SQL Runner per testare le tabelle derivate.