Utilizzo di SQL Runner per creare query ed esplorazioni

SQL Runner consente di accedere direttamente al tuo database e di utilizzarlo in vari modi. Con SQL Runner puoi esplorare facilmente le tabelle nello schema, utilizzare un'esplorazione ad hoc di una query SQL, eseguire query descrittive prescritte sui tuoi dati, visualizzare la cronologia di SQL Runner, scaricare i risultati, condividere query, aggiungere il 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 di documentazione per informazioni su:

Esecuzione di query in SQL Runner

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

Scrivere una query SQL da zero

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

  1. Fai clic nell'area della query SQL e digita il tuo comando SQL.
  2. In via facoltativa, puoi fare doppio clic su un nome o un campo della tabella nell'elenco dei campi per includerlo nella query nella posizione del cursore.
  3. Fai clic su 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 lo streaming, puoi scaricare i risultati per visualizzare l'intero set di risultati.

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

Quando disponi di una query che ti piace, puoi aggiungerla a un progetto, recuperare il LookML per una tabella derivata o condividere la query.

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

Utilizzare un'esplorazione per creare una query SQL

Puoi anche utilizzare un'esplorazione per creare una query, quindi ottenere il comando SQL per tale query da utilizzare in SQL Runner:

  1. Da un'esplorazione, fai clic sulla scheda SQL nella barra Dati.
  2. Seleziona il testo della query SQL e copialo in SQL Runner, oppure
  3. Fai clic su Apri in SQL Runner o Spiega in SQL Runner per aprire la query in SQL Runner.

Dopo aver aggiunto una query all'area di query SQL di SQL Runner, puoi fare clic su Esegui per eseguire la query sul database. In alternativa, puoi modificare la query ed eseguire la nuova query.

Creazione di visualizzazioni con SQL Runner

Se il tuo amministratore Looker ha abilitato la funzionalità SQL Runner Vis Labs, puoi creare visualizzazioni direttamente in SQL Runner.

Se gli elementi SQL Runner Vis sono abilitati, i riquadri SQL Runner sono riorganizzati. Il riquadro di visualizzazione viene visualizzato 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 visualizzarla e scegliere un tipo di visualizzazione, 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. Qualsiasi personalizzazione apportata utilizzando il menu Impostazioni della visualizzazione verrà salvata e il link non cambierà.

Ci sono alcuni aspetti da tenere in considerazione sul funzionamento delle visualizzazioni SQL Runner:

  • La tabella dei risultati e la visualizzazione interpretano qualsiasi campo numerico come una misura.
  • Il nome del campo completo viene sempre utilizzato nella tabella dei risultati e nella visualizzazione. Pertanto, l'opzione Mostra nome campo completo nel menu Impostazioni non è attiva.
  • Per utilizzare campi personalizzati, calcoli tabulari, pivot, totali delle colonne e subtotali, esplora dalla query SQL Runner.
  • Le visualizzazioni mappa statica (regioni) non sono supportate dalle visualizzazioni SQL Runner, tuttavia sono supportate le mappe che utilizzano dati di latitudine e longitudine (mappe e visualizzazioni mappa statica (punti).).
  • Le visualizzazioni della sequenza temporale non sono supportate dalle visualizzazioni SQL Runner.

Dimensioni pivot

Puoi modificare i risultati della query in pivot in base a una o più dimensioni nelle visualizzazioni SQL Runner. Per effettuare la rotazione di un campo:

  1. Fai clic sul menu a forma di ingranaggio di una colonna nell'area Risultati per visualizzare le opzioni della colonna.
  2. Fai clic su Colonna pivot.

I risultati sottoposti a pivot vengono visualizzati nella visualizzazione SQL Runner:

I risultati nell'area Risultati non appaiono pivot.

Per annullare il pivot, fai clic sul menu a forma di ingranaggio della colonna pivot e seleziona Colonna pivot:

Modificare il tipo di campo

Quando vengono visualizzati i risultati e la visualizzazione della query, SQL Runner interpreta automaticamente qualsiasi campo numerico come misura e ogni campo non numerico come dimensione. Puoi sostituire il tipo di campo predefinito e convertire una dimensione in una misura, o viceversa, in uno dei seguenti modi:

  1. Fai clic sul menu a forma di ingranaggio di una colonna nell'area Risultati per visualizzare le opzioni della colonna.
  2. Fai clic su Converti in dimensione o Converti in misurazione 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 una query su un modello, puoi utilizzare gli operatori di sostituzione di LookML, ad esempio ${view_name.field_name} o ${view_name.SQL_TABLE_NAME}. In questo modo è possibile risparmiare tempo quando si costruisce una query per risolvere i problemi di una tabella derivata, ad esempio.

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

Per eseguire una query sul modello LookML in SQL Runner:

  1. Fai clic sulla scheda Modello.
  2. Seleziona il modello per il quale vuoi eseguire la query.
  3. Fai clic nell'area Query SQL e inserisci la tua query SQL utilizzando i campi LookML.
  4. In via facoltativa, puoi fare doppio clic su una vista nell'elenco per includere la visualizzazione nella query in corrispondenza della posizione del cursore.
  5. Per visualizzare l'elenco dei campi di una vista, fai clic sulla vista nella sezione Viste. Facoltativamente, puoi fare doppio clic su 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 le eventuali sostituzioni di LookML sono state tradotte in SQL.
  7. Fai clic su Esegui per eseguire la query sul 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 lo streaming, puoi scaricare i risultati per visualizzare l'intero set di risultati.

Quando disponi di una query che ti piace, puoi aggiungerla a un progetto, recuperare il LookML per una tabella derivata o condividere la query.

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

Visualizzazione di un codice LookML da un campo da SQL Runner

Nell'elenco dei campi della scheda Model, puoi anche visualizzare il LookML di un campo. Passa il mouse sopra il campo nell'elenco dei campi e fai clic sull'icona di Looker a destra del nome del campo:

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

Cronologia esecutore SQL

Puoi anche visualizzare una cronologia recente di tutte le query che hai eseguito in SQL Runner.

Per vedere la cronologia, fai clic sulla scheda Cronologia nella parte superiore del riquadro di navigazione. SQL Runner mostra tutte le query eseguite sulla connessione al database. Rosso indica una query che non è stata eseguita a causa di un errore.

Fai clic su una query nella cronologia per inserirla in SQL Runner e poi su Run (Esegui) per ripetere la query:

Ordinamento della query

L'ordinamento di una tabella è indicato da una freccia rivolta verso l'alto o verso il basso accanto al nome del campo ordinato, a seconda che i risultati siano in ordine crescente o decrescente. Puoi ordinare i dati in base a più colonne tenendo premuto il tasto Maiusc e facendo clic sulle intestazioni delle colonne nell'ordine che vuoi ordinare. L'ordinamento di un campo è indicato anche da un numero che distingue il suo ordinamento in base ad altri campi, da una freccia accanto al nome del campo che mostra la direzione di ordinamento (in ordine crescente o decrescente) e da un popup che viene visualizzato quando passi il mouse sul nome di un campo.

Per ulteriori informazioni ed esempi, vedi la sezione Ordinare i dati della pagina della documentazione Esplorazione dei dati in Looker.

Condivisione di 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 dell'URL:

Download dei risultati

Una volta eseguita 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 del download (file di testo, CSV, JSON e così via).

  4. Fai clic su Apri nel browser per visualizzare i risultati in una nuova finestra del browser oppure fai clic su Scarica per scaricare i risultati in un file sul tuo computer.

    Quando fai clic su Open in Browser (Apri nel browser) o su Download (Scarica), Looker esegue di nuovo la query ed esegue il download.

Per i dialetti SQL che supportano lo streaming, l'opzione Scarica di SQL Runner scaricherà l'intero set di risultati. Per i dialetti SQL che non supportano il flusso di dati, l'opzione Scarica di SQL Runner scaricherà solo le righe della query mostrate nella sezione Risultati (fino a 5000 righe).

Copiare i valori delle colonne

Puoi copiare i valori delle colonne dalla sezione Risultati in SQL Runner. Fai clic sul 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, un documento di Excel o un'altra posizione.

Se l'amministratore di Looker ha abilitato la funzionalità SQL Runner Vis Labs, hai a disposizione anche altre opzioni nel menu a forma di 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 Run (Esegui).

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

Creare un'esplorazione ad hoc

Da SQL Runner puoi ottenere rapidamente insight sui dati creando un Explore ad hoc per una query SQL o una tabella di database. Puoi utilizzare Looker Explore per selezionare 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 delle query di SQL Runner
  • Esplora dall'elenco delle tabelle SQL Runner

Esplorazione dei risultati delle query SQL Runner

SQL Runner consente di aprire un'esplorazione da una query SQL. Viene creata un'esplorazione temporanea dalla query scritta in SQL Runner. Ciò ti consente di verificare ciò che viene restituito dalla query e di visualizzare i risultati. Questa opzione 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à SQL Runner Vis Labs, puoi creare visualizzazioni direttamente in SQL Runner.

  1. Utilizza SQL Runner per creare la query SQL che vuoi utilizzare.
  2. Fai clic su Esplora dal menu a forma di ingranaggio in alto a destra. Viene visualizzata una nuova pagina Esplora, in cui puoi esplorare la query SQL come se fosse una tabella salvata nel modello.
  3. Puoi copiare l'URL in Esplora per condividere.
  4. Per aggiungere questa query come tabella derivata nel tuo progetto direttamente da qui, fai clic su 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, fai clic su Esplora nel menu a forma di ingranaggio. Quindi, nel selettore dei campi:

Esplorazione di una tabella elencata in SQL Runner

Utilizza l'opzione Esplora tabella nella scheda Database per creare un'esplorazione ad hoc per qualsiasi tabella della connessione. Ciò ti consente di utilizzare Looker su una tabella prima di averla modellata, esplorando la tabella come una vista LookML.

Dopo aver aperto un'esplorazione per la tabella, puoi decidere se aggiungerla al tuo progetto. Puoi anche utilizzare la scheda SQL di Explore per vedere le query SQL inviate da Looker al database, quindi utilizzare il pulsante Open in SQL Runner per aprire la query in SQL Runner.

  1. Fai clic sulla scheda Database.
  2. In SQL Runner, fai clic sull'ingranaggio di una tabella e seleziona Esplora tabella.
  3. Looker genera un modello temporaneo con una visualizzazione per la tabella, poi visualizza Explore (Esplora).
  4. Looker fornisce un campo dimensione per ciascuna colonna della tabella. (Funziona nello stesso modo in cui Looker genera un modello all'inizio di un progetto).
  5. Looker include automaticamente periodi di tempo per qualsiasi campo della data.
  6. Looker include anche una misurazione del conteggio.

Quando utilizzi l'opzione Esplora tabella, non esiste alcun file LookML associato all'esplorazione; si tratta solo di una visualizzazione ad hoc della tabella.

Debug utilizzando SQL Runner

SQL Runner è anche uno strumento utile per controllare gli errori SQL nelle query.

Evidenziazione dell'errore SQL Runner

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

Le informazioni sulla posizione fornite variano in base al dialetto del database. Ad esempio, MySQL fornisce il numero di riga contenente l'errore, mentre Redshift fornisce la posizione del carattere dell'errore. Gli altri dialetti del database potrebbero avere uno o più comportamenti di questo tipo.

SQL Runner evidenzia anche la posizione del primo errore di sintassi nel comando SQL sottolineandolo in rosso e contrassegnando la riga con un "x". Passa il mouse sopra "&" per visualizzare ulteriori informazioni sull'errore. Dopo aver risolto il problema, fai clic su 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 dell'errore e il tipo di errore, ad esempio errori ortografici o comandi mancanti.

  1. In Esplora, fai clic sulla scheda SQL della barra dei dati.
  2. Fai clic su Apri in SQL Runner per aprire la query in SQL Runner.

Questa operazione copia il codice SQL generato da Explore in SQL Runner. Come mostrato sopra, SQL Runner evidenzia la posizione degli errori nel comando SQL e include la posizione dell'errore nel messaggio di errore. Puoi quindi apportare modifiche ed eseguire nuovamente la query in SQL Runner finché non avrai corretto gli errori.

Utilizzo di SQL Runner per controllare gli errori nelle tabelle derivate

Per informazioni sull'utilizzo di SQL Runner per controllare gli errori SQL nelle tabelle derivate, consulta l'articolo sulla community di Looker dedicato all'uso di SQL Runner per testare le tabelle derivate.