SQL Runner fornisce un modo per accedere direttamente al tuo database e sfruttare l'accesso in vari modi. Con SQL Runner, puoi esplorare facilmente le tabelle nello 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 le query, aggiungere elementi a un progetto LookML come tabella derivata ed eseguire altre attività utili.
In questa pagina viene descritto come creare una tabella derivata utilizzando SQL Runner e come utilizzare SQL Runner per il debug delle tabelle derivate. Consulta queste altre pagine della documentazione per informazioni su:
- Nozioni di base su SQL Runner
- Utilizzare SQL Runner per creare query ed esplorazioni
- Gestire le funzioni di database con SQL Runner
Aggiunta di una query SQL Runner a un progetto LookML
SQL Runner è un ottimo posto per testare SQL da utilizzare come tabella derivata nel tuo progetto LookML. Puoi anche recuperare una query SQL da un altro strumento, testarla in SQL Runner e poi aggiungerla al tuo progetto LookML.
Dopo aver creato una query SQL in SQL Runner, puoi creare una tabella derivata dalla query utilizzando l'opzione Aggiungi al progetto o Ottieni LookML della tabella derivata. Entrambe queste opzioni consentono di acquisire una query in SQL Runner e aggiungerla al tuo progetto LookML. Per ulteriori informazioni, consulta le sezioni seguenti.
Aggiungi al progetto
L'opzione Aggiungi al progetto è il modo più semplice per aggiungere una query SQL Runner al tuo progetto:
L'opzione Aggiungi al progetto ti consente di selezionare un progetto LookML, quindi Looker crea automaticamente un file di visualizzazione con la query nel progetto selezionato. Se preferisci invece creare manualmente il file di visualizzazione e aggiungere personalmente il codice LookML della query, puoi utilizzare l'opzione Ottieni LookML della tabella derivata.
Segui questi passaggi per utilizzare l'opzione Aggiungi al progetto:
- Utilizza SQL Runner per creare una query SQL da utilizzare per una tabella derivata.
- Fai clic su Aggiungi al progetto dal menu a forma di ingranaggio in alto a destra.
- Seleziona il progetto a cui aggiungere questa tabella derivata.
- Inserisci un nome di visualizzazione per la tabella derivata.
- Fai clic su Aggiungi per aggiungere la query come tabella derivata nel tuo progetto. Looker passerà alla modalità di sviluppo, se non è già attiva, creerà un nuovo file di visualizzazione con LookML dalla query SQL Runner, quindi aprirà il browser di file IDE con il nuovo file di visualizzazione.
- Sposta il file in base all'organizzazione dei file del progetto.
- Convalida il LookML ed esegui il deployment delle modifiche in produzione.
Ottieni LookML della tabella derivata
Un altro modo per creare una tabella derivata dalla query SQL Runner consiste nell'utilizzare l'opzione Ottieni LookML della tabella derivata dal menu a forma di ingranaggio di SQL Runner. Proprio come con l'opzione Aggiungi al progetto, Looker fornirà il LookML necessario per trasformare la tua query SQL in una tabella derivata. Da qui, puoi copiare il LookML da incollare nel tuo progetto. Questa operazione è utile se vuoi sostituire una tabella derivata esistente.
Per creare una tabella derivata da una query SQL Runner:
- Utilizza SQL Runner per creare una query SQL da utilizzare per una tabella derivata.
- Fai clic sul menu a forma di ingranaggio e seleziona Ottieni LookML della tabella derivata.
Nel popup Ottieni LookML della tabella derivata, fai clic sul link aggiungila al progetto.
Utilizza l'elenco a discesa Progetto per scegliere il progetto a cui aggiungere la tabella derivata.
Inserisci un nome per la nuova vista nel campo Nome vista. Per le convenzioni di denominazione dei file, consulta la pagina Gestione di file e cartelle LookML.
Fai clic sul pulsante Aggiungi. Looker passerà alla modalità di sviluppo, se non è già attiva, creerà un nuovo file di visualizzazione con LookML dalla query SQL Runner, quindi aprirà il browser di file IDE con il nuovo file di visualizzazione.
Sposta il file in base all'organizzazione dei file del progetto.
Convalida il LookML ed esegui il deployment delle modifiche in produzione.
Debug con SQL Runner
SQL Runner è uno strumento utile anche per controllare gli errori SQL nella definizione di una tabella derivata.
Evidenziazione dell'errore SQL Runner
SQL Runner evidenzia la posizione degli errori nel comando SQL e ne include la posizione nel messaggio di errore.
Le informazioni sulla posizione fornite variano a seconda del dialetto del database. Ad esempio, MySQL fornisce il numero di riga contenente 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". Passa il mouse sopra la "x" per visualizzare ulteriori informazioni sull'errore. Dopo aver risolto il problema, fai clic su Esegui per controllare se la query contiene altri errori.
Utilizzo di SQL Runner per testare le tabelle derivate
Se noti un errore proveniente da una tabella derivata, puoi determinare la causa dell'errore copiando l'istruzione SQL in SQL Runner e provando diverse parti di SQL per limitare la posizione dell'errore. Per saperne di più, consulta il post della community di Looker sull'utilizzo di SQL Runner per testare le tabelle derivate.