Utilizzare SQL Runner per creare tabelle derivate

SQL Runner fornisce l'accesso diretto al database, che puoi utilizzare per creare ed eseguire il debug delle tabelle derivate per i tuoi progetti LookML. Utilizza SQL Runner per definire nuove tabelle derivate e risolvere i problemi di quelle esistenti, in modo da garantire l'accuratezza dei dati e migliorare il flusso di lavoro di sviluppo. Questa guida mostra come utilizzare SQL Runner per queste attività.

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:

Aggiungere una query SQL Runner a un progetto LookML

SQL Runner è un ottimo strumento per testare SQL da utilizzare come tabella derivata nel progetto LookML. Puoi persino ottenere 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 l'opzione Ottieni LookML della tabella derivata. Entrambe le opzioni ti consentono di prendere 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 SQL Runner al tuo progetto:

Pagina di SQL Runner con il menu a forma di ingranaggio aperto e il link Aggiungi al progetto evidenziato.

L'opzione Aggiungi al progetto ti consente di selezionare un progetto LookML, quindi Looker crea automaticamente un file di vista con la query nel progetto selezionato. Se preferisci creare manualmente il file di vista e aggiungere il codice LookML della query, puoi utilizzare l'opzione Ottieni LookML della tabella derivata.

Per utilizzare l'opzione Aggiungi al progetto:

  1. Utilizza SQL Runner per creare una query SQL da utilizzare per una tabella derivata.
  2. Fai clic su Aggiungi al progetto dal menu a forma di ingranaggio in alto a destra.
  3. Seleziona il progetto a cui vuoi aggiungere questa tabella derivata.
  4. Inserisci un nome di visualizzazione per la tabella derivata.
  5. 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 della query SQL Runner e poi apre il browser dei file IDE nel nuovo file di visualizzazione.
  6. Sposta il file in base all'organizzazione dei file del progetto.
  7. Convalida il codice LookML e implementa le modifiche in produzione.

Ottieni LookML della tabella derivata

Un altro modo per creare una tabella derivata dalla query SQL Runner è utilizzare l'opzione Ottieni 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 per incollarlo manualmente nel progetto, il che è utile se vuoi sostituire una tabella derivata esistente.

Per creare una tabella derivata da una query SQL Runner:

  1. Utilizza SQL Runner per creare una query SQL da utilizzare per una tabella derivata.
  2. Fai clic sul menu a forma di ingranaggio e seleziona Ottieni LookML della tabella derivata.

  3. Nel popup Ottieni LookML della tabella derivata, fai clic sul link aggiungilo al tuo progetto.

  4. Utilizza l'elenco a discesa Progetto per scegliere il progetto a cui vuoi aggiungere la tabella derivata.

  5. Inserisci un nome per la nuova vista nel campo Nome visualizzazione. Per le convenzioni di denominazione dei file, consulta la pagina Gestire file e cartelle LookML.

  6. 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 della query SQL Runner e poi apre il browser dei file IDE nel nuovo file di visualizzazione.

  7. Sposta il file in base all'organizzazione dei file del progetto.

  8. Convalida il codice LookML e implementa le modifiche in produzione.

Eseguire il debug utilizzando SQL Runner

SQL Runner è anche uno strumento utile 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 che contiene 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 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 sono presenti altri errori nella query.

Utilizzare SQL Runner per testare le tabelle derivate

Se visualizzi un errore proveniente da una tabella derivata, puoi determinarne la causa copiando l'istruzione SQL in SQL Runner e testando diverse parti di 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.