SQL Runner offre un modo per accedere direttamente al database e sfruttare questo accesso in vari modi. Con SQL Runner puoi navigare facilmente nelle tabelle dello schema, utilizzare un'esplorazione ad hoc da una query SQL, eseguire query descrittive predefinite 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.
Questa pagina descrive come creare una tabella derivata utilizzando SQL Runner e come utilizzare SQL Runner per eseguire 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 di SQL Runner a un progetto LookML
SQL Runner è un ottimo strumento per testare il codice SQL da utilizzare come tabella derivata nel progetto LookML. Puoi anche recuperare una query SQL da uno strumento diverso, 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 Genera LookML della tabella derivata. Entrambe le opzioni ti consentono di eseguire una query in SQL Runner e aggiungerla al tuo progetto LookML. Per informazioni, consulta le sezioni seguenti.
Aggiungi al progetto
L'opzione Aggiungi al progetto è il modo più semplice per aggiungere una query di SQL Runner al progetto:
L'opzione Aggiungi al progetto ti consente di selezionare un progetto LookML, dopodiché Looker crea automaticamente un file di visualizzazione con la query nel progetto selezionato. Se preferisci creare manualmente il file della visualizzazione e aggiungere il LookML della query, puoi utilizzare l'opzione Ottieni il LookML della tabella derivata.
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 nel menu a forma di ingranaggio in alto a destra.
- Seleziona il progetto a cui vuoi aggiungere questa tabella derivata.
- Inserisci un nome per la visualizzazione della tabella derivata.
- Fai clic su Aggiungi per aggiungere la query come tabella derivata nel progetto. Se non è già attiva, Looker passa alla modalità di sviluppo, crea un nuovo file di visualizzazione con il codice LookML dalla query di SQL Runner e apre il browser dei file dell'IDE per il nuovo file di visualizzazione.
- Sposta il file in base all'organizzazione dei file del progetto.
- Convalida il codice LookML e esegui il deployment delle modifiche in produzione.
Ottieni LookML della tabella derivata
Un altro modo per creare una tabella derivata dalla query di SQL Runner è utilizzare l'opzione Genera LookML della tabella derivata dal menu a forma di ingranaggio di SQL Runner. Come per l'opzione Aggiungi al progetto, Looker fornirà il codice LookML necessario per trasformare la query SQL in una tabella derivata. Da qui, puoi copiare il codice LookML da incollare nel tuo progetto, il che è utile se vuoi sostituire una tabella derivata esistente.
Per creare una tabella derivata da una query di 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 il LookML della tabella derivata.
Nel popup Ottieni LookML della tabella derivata, fai clic sul link Aggiungi al progetto.
Utilizza l'elenco a discesa Progetto per scegliere il progetto a cui aggiungere la tabella derivata.
Inserisci un nome per la nuova visualizzazione nel campo Nome visualizzazione. Per le convenzioni di denominazione dei file, consulta la pagina Gestire i file e le cartelle LookML.
Fai clic sul pulsante Aggiungi. Se non è già attiva, Looker passa alla modalità di sviluppo, crea un nuovo file di visualizzazione con il codice LookML dalla query di SQL Runner e apre il browser dei file dell'IDE per il nuovo file di visualizzazione.
Sposta il file in base all'organizzazione dei file del progetto.
Convalida il codice LookML e esegui il deployment delle modifiche in produzione.
Debug utilizzando SQL Runner
SQL Runner è uno strumento utile anche per controllare gli errori SQL nella definizione di una tabella derivata.
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.
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 del database potrebbero avere uno di questi o altri comportamenti.
SQL Runner evidenzia anche 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 verificare se ci sono altri errori nella query.
Utilizzare SQL Runner per testare le tabelle derivate
Se viene visualizzato un errore proveniente da una tabella derivata, puoi determinare la causa dell'errore copiando l'istruzione SQL in SQL Runner e testando diverse parti del codice SQL per restringere la posizione dell'errore. Per ulteriori informazioni, consulta il post della community di Looker Utilizzare SQL Runner per testare le tabelle derivate.