Tieni presente che stai visualizzando la documentazione di Looker. Per la documentazione di Looker Studio, visita https://support.google.com/looker-studio.

Gestione delle funzioni di database con SQL Runner

SQL Runner consente di accedere direttamente al database e di utilizzarlo in vari modi. Con SQL Runner puoi esplorare facilmente le tabelle dello schema, eseguire 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 le query, aggiungerle a un progetto LookML come tabella derivata ed eseguire altre attività utili.

Questa pagina descrive come modificare lo schema e i dati del database utilizzando SQL Runner, visualizzare il piano di esecuzione del database per una query con l'istruzione EXAMINE e come utilizzare SQL Runner per ottenere informazioni sul tuo database. Consulta queste altre pagine della documentazione per informazioni su:

Modifica dello schema e dei dati del database

Oltre a eseguire query sul tuo database, la scheda Database in SQL Runner ti consente di eseguire istruzioni DDL (Data Definition Language) e DML (Data Manipulation Language) sul tuo database. Puoi utilizzare SQL Runner per apportare modifiche allo schema (ad esempio, creare, eliminare e modificare) e modificare i dati (come l'inserimento, l'aggiornamento e l'eliminazione). I dialetti SQL hanno un supporto diverso per le istruzioni DDL e DML, quindi consulta la documentazione del tuo database per scoprire quali istruzioni sono supportate.

Looker non controlla l'autorizzazione delle istruzioni SQL che un utente può eseguire sul tuo database. Gli utenti di Looker con l'autorizzazione use_sql_runner hanno accesso a SQL Runner, ma quest'ultimo non controlla quali comandi può eseguire. Se l'amministratore del database vuole impedire agli utenti di SQL Runner di modificare lo schema del database, deve farlo configurando le autorizzazioni utente per il database stesso.

Per eseguire un'istruzione DDL o DML sul tuo database in SQL Runner, procedi nel seguente modo:

Accedi a SQL Runner.
In SQL Runner, fai clic sulla scheda Database.
Inserisci l'istruzione DDL o DML nella casella Query di SQL Runner. Consulta la documentazione per il dialetto del database per il supporto e la sintassi delle istruzioni DDL e DML.
Fai clic su Esegui per eseguire l'istruzione sul tuo database.

Se l'istruzione viene eseguita correttamente sul tuo database, la casella Risultati SQL mostrerà una conferma.

Analisi di un piano di esecuzione mediante `EXPLAIN`

Oltre a eseguire query SQL sul tuo database, puoi utilizzare SQL Runner per eseguire una funzione EXPLAIN per una query. La funzione EXPLAIN, supportata dalla maggior parte dei dialetti SQL, restituisce il piano di esecuzione del database per una query.

Da Esplora, esegui una query e fai clic sulla scheda SQL dell'area Dati per visualizzare il comando SQL della query.
Nella scheda SQL di Explore (Esplora), fai clic sul pulsante Explain in SQL Runner (Spiegazione in SQL Runner).

Looker aprirà SQL Runner e caricherà la query all'interno di una funzione EXPLAIN.
In SQL Runner, fai clic su Run (Esegui) per eseguire la funzione EXPLAIN.
Visualizza l'output della funzione EXPLAIN.

Le informazioni e il formato esatti della risposta EXPLAIN dipendono dal dialetto specifico, pertanto devi visualizzare la documentazione specifica per il dialetto.

Nell'esempio MySQL precedente, la funzione EXPLAIN restituisce un elenco dei passaggi seguiti dal database per completare la query. Questo può essere utile per le query che sembrano essere lente da eseguire, perché potresti scoprire che il tuo database esegue la scansione di un'intera tabella in una query, quando forse la tabella potrebbe utilizzare un indice per migliorare le prestazioni.

Per un esempio dettagliato dell'utilizzo di EXPLAIN in SQL Runner per ottimizzare SQL, consulta il post della community Come ottimizzare SQL con EXPLAIN .

Recupero delle informazioni sul database

La scheda Database di SQL Runner offre una serie di strumenti per offrirti insight sul database.

Recupero delle informazioni di connessione al database

Quando scegli una connessione in SQL Runner, Looker visualizza il dialetto del database per quella connessione a destra del banner SQL QUERY. Se hai raggiunto SQL Runner scegliendo Apri in SQL Runner o Spiega in SQL Runner, Looker preseleziona la connessione appropriata per te e visualizza il dialetto di database della connessione.

Fai clic sul menu a forma di ingranaggio della connessione per visualizzare altre opzioni per la connessione al database:

Seleziona l'opzione Mostra processi per visualizzare informazioni sulle query e sui processi attualmente in esecuzione sulla connessione.
Seleziona l'opzione Refresh Schemas & Tables per aggiornare il riquadro di navigazione a sinistra di SQL Runner con gli schemi e le tabelle presenti nel database.

Opzioni del menu a forma di ingranaggio di BigQuery

Quando scegli una connessione BigQuery che supporta più database, Looker visualizza opzioni specifiche per il dialetto nel menu dell'ingranaggio. La voce di menu passa da Mostra progetti disponibili a Cerca nei progetti pubblici e viceversa, a seconda dell'opzione attualmente selezionata.

Seleziona Update Schemas & Tables per ricompilare il riquadro di navigazione a sinistra di SQL Runner con gli schemi e le tabelle presenti nel database.
Quando vengono visualizzati i progetti disponibili, è disponibile un'opzione del menu a forma di ingranaggio per cercare progetti pubblici. Seleziona questa opzione per cercare set di dati pubblici che non sono visibili nello schema di informazioni.
Quando vengono visualizzati progetti pubblici, è disponibile un'opzione del menu a forma di ingranaggio per mostrare i progetti disponibili. Seleziona questa opzione per ripristinare la visualizzazione dei progetti e delle tabelle BigQuery specifici per la connessione nel riquadro di navigazione a sinistra di SQL Runner.

Ricerca nel database

SQL Runner mostra una casella di ricerca sotto lo schema selezionato (o Set di dati, per le connessioni a Google BigQuery).

La ricerca di SQL Runner sfoglia i nomi di tutte le tabelle e le colonne di tabelle che contengono la stringa nella casella di ricerca. Nella figura seguente, "airport_name" è una colonna e "airport_remarks" è una tabella.

Fai clic su uno dei risultati di ricerca per accedere a quell'elemento in SQL Runner.

Recupero delle informazioni sulla tabella

Per impostazione predefinita, SQL Runner precarica tutte le informazioni della tabella quando selezioni una connessione e uno schema. Per le connessioni con molte tabelle o tabelle molto grandi, un amministratore può disattivare questo comportamento deselezionando l'opzione Pre-cache SQL Runner nella pagina Connessioni.

Il pannello di navigazione a sinistra di SQL Runner consente di esplorare gli schemi e le tabelle nelle connessioni. Seleziona una connessione e uno schema per visualizzare tutte le tabelle al suo interno. Fai clic sul nome di una tabella per visualizzare i campi al suo interno.

SQL Runner ha alcune query prescritte per aiutarti a comprendere i tuoi dati. Per utilizzare queste query, fai clic sull'ingranaggio accanto al nome di una tabella o colonna di tabella e seleziona la query desiderata. Looker genera automaticamente il codice SQL nella sezione SQL Query e la query verrà eseguita.

Le query disponibili variano in base al dialetto di database.

Informazioni sulla tabella

Looker visualizza le seguenti opzioni quando fai clic sull'ingranaggio accanto al nome di una tabella:

Esplora tabella: apre una nuova scheda del browser per visualizzare Looker Explore della tabella.
Descrivi: mostra i nomi delle colonne nella tabella sottostante e i tipi di dati.
Mostra indici: mostra informazioni sulla modalità di indicizzazione della tabella.
Seleziona 10: restituisce una query delle prime dieci righe della tabella. Questo è un buon modo per capire l'aspetto effettivo dei dati.
Conteggio: restituisce una semplice query count(*) per ottenere il conteggio totale delle righe della tabella.

Informazioni colonna

Fai clic sul nome di una tabella per visualizzare le colonne al suo interno. Looker visualizza le seguenti opzioni quando fai clic sull'ingranaggio accanto al nome di una colonna:

Valori più comuni: restituisce una query dei valori più comuni per la colonna della tabella, insieme a un numero di volte in cui il valore si trova nella colonna.
Conteggio approssimativo approssimativo: mostra un conteggio approssimativo del numero di valori distinti trovati nella colonna.

Recupero delle informazioni sul tipo di dati della colonna

Puoi utilizzare SQL Runner per ottenere informazioni sul tipo di dati delle colonne seguendo questi passaggi:

In SQL Runner, seleziona la connessione del database dal menu a discesa Connection (Connessione).
Seleziona lo schema dal menu a discesa Schema. Per le connessioni BigQuery, seleziona Progetto e Set di dati.
SQL Runner mostra l'elenco delle tabelle nello schema sul tuo database. Fai clic su una tabella per visualizzare le colonne al suo interno.
Ogni nome di colonna contiene un'icona che rappresenta il tipo di dati. Passa il mouse sopra il nome di una colonna per visualizzare il tipo di dati contenuto nella colonna.

Modifica delle query SQL predefinite

Puoi modificare qualsiasi query SQL nell'area Query, incluse le query SQL preimpostate scelte dai menu della tabella e dei menu a forma di ingranaggio dei campi.

Ad esempio, puoi utilizzare la query Count di SQL Runner per caricare un comando di conteggio di base per un database, quindi modificare la query SQL. Pertanto, se ritieni che la colonna id nella tabella public.users possa essere una chiave primaria, puoi convalidare l'assenza di valori duplicati modificando la query di conteggio in questo modo:

SELECT id ,COUNT(*)
FROM public.users
GROUP BY 1
ORDER BY 2 DESC
LIMIT 10

Poiché la query viene ordinata in base al conteggio prima che i risultati siano limitati a 10 righe, i risultati includeranno i valori di conteggio più elevati. Se questa query restituisce un conteggio di 1 per ogni valore id, è probabile che id sia la chiave primaria in questa tabella. Tuttavia, questa query specifica solo le righe nella tabella al momento dell'esecuzione della query. Poiché in futuro le operazioni di inserimento nel database potrebbero squalificare id come chiave primaria, ti consigliamo di implementare restrizioni sul tuo database per garantire che le chiavi primarie siano univoche.