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 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
- Utilizzo di SQL Runner per creare query ed esplorazioni
- Gestione delle funzioni di database con SQL Runner
Aggiunta di una query SQL Runner a un progetto LookML
SQL Runner è un ottimo strumento per testare SQL da utilizzare come tabella derivata nel tuo progetto LookML. Puoi anche recuperare una query SQL da uno strumento diverso, testarla in SQL Runner e 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 l'opzione Get Derived Table LookML. Entrambe le opzioni ti consentono di eseguire una query in SQL Runner e aggiungerla al tuo progetto LookML. Per informazioni, consulta le seguenti sezioni.
Aggiungi al progetto
Utilizzare 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 e Looker crea automaticamente un file di visualizzazione con la query nel progetto selezionato. Se preferisci invece creare manualmente il file di vista e aggiungere personalmente il codice LookML della query, puoi utilizzare l'opzione Get Derived Table LookML.
Per utilizzare l'opzione Aggiungi al progetto:
- Utilizza SQL Runner per creare una query SQL che vuoi 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 vista per la tabella derivata.
- Fai clic su Aggiungi per aggiungere la query come tabella derivata nel tuo progetto. Se non è già presente, Looker passerà alla modalità di sviluppo, creerà un nuovo file di visualizzazione con il codice LookML dalla query SQL Runner e quindi aprirà il browser file di IDE per il nuovo file di visualizzazione.
- Sposta il file in base all'organizzazione dei file del tuo progetto.
- Convalidare il codice LookML ed eseguire 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 GetML Derived Table LookML dal menu a forma di ingranaggio SQL Runner. Proprio come con l'opzione Aggiungi al progetto, Looker fornisce il LookML necessario per trasformare la tua query SQL in una tabella derivata. Da qui puoi copiare il codice LookML da incollare nel tuo progetto, soluzione 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 che vuoi utilizzare per una tabella derivata.
- Fai clic sul menu a forma di ingranaggio e seleziona Get Derived Table LookML.
Dal popup Get Derived Table LookML, fai clic sul link aggiungilo al tuo progetto.
Utilizza l'elenco a discesa Progetto per scegliere il progetto a cui vuoi aggiungere la tabella derivata.
Inserisci un nome per la nuova visualizzazione nel campo View Name (Nome vista). Per le convenzioni di denominazione dei file, consulta la pagina Gestione di file e cartelle LookML.
Fai clic sul pulsante Aggiungi. Se non è già presente, Looker passerà alla modalità di sviluppo, creerà un nuovo file di visualizzazione con il codice LookML dalla query SQL Runner e quindi aprirà il browser file di IDE per il nuovo file di visualizzazione.
Sposta il file in base all'organizzazione dei file del tuo progetto.
Convalidare il codice LookML ed eseguire il deployment delle modifiche in produzione.
Debug utilizzando SQL Runner
SQL Runner è anche uno strumento utile per controllare gli errori SQL nella definizione di una tabella derivata.
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 sulla posizione fornite variano 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 o altri 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 una "x". Passa il mouse sopra la "x" per visualizzare ulteriori informazioni sull'errore. Una volta risolto il problema, fai clic su Esegui per vedere se sono presenti altri errori nella query.
Utilizzo di SQL Runner per testare le tabelle derivate
Se vedi un errore proveniente da una tabella derivata, puoi determinarne la causa copiando l'istruzione SQL in SQL Runner e testando parti diverse dell'SQL per restringere la posizione dell'errore. Per ulteriori informazioni, consulta il post della community di Looker sull'utilizzo di SQL Runner per testare le tabelle derivate.