Modificare il modello o l'esplorazione di un Look o una dashboard

Di tanto in tanto, potresti voler modificare il modello o l'esplorazione di origine di un Look o una dashboard. Ad esempio, hai un Look o una dashboard basati su LookML del modello A. Hai anche un secondo modello, il modello B. Vuoi modificare il riferimento del modello di un Look o di una dashboard in modello B anziché sul modello A. In questa pagina viene spiegato come modificare il modello di origine o l'esplorazione per un Look o una dashboard.

Esistono diverse soluzioni, a seconda del caso d'uso:

Modificare l'URL espanso del Look

Per un Look una tantum, puoi utilizzare l'URL espanso dall'esplorazione sottostante del Look per modificare il nome del modello nell'URL.

  1. Dal Look, seleziona il link Esplora da qui per aprire la query del Look in un'esplorazione.
  2. Seleziona Condividi dal menu a forma di ingranaggio di Esplora per aprire il menu Condividi URL.
  3. Copia l'URL dall'opzione URL espanso.
  4. Modifica il nome del modello nell'URL espanso. Il nome del modello si trova subito dopo il nome dell'istanza e la parte /explore dell'URL. L'URL ha il seguente formato:

    https://instance_name.looker.com/explore/MODEL_NAME/EXPLORE_NAME?fields=...

    In questo esempio, il nome del modello è lauren_ecommerce: URL espanso con /explore/lauren_ecommerce/order_items?fields=orders.created_month,orders.count dopo il nome dell'istanza.
  5. Incolla il nuovo URL di esplorazione in un browser per verificare che funzioni con il nome del modello aggiornato.
  6. Salva l'esplorazione come un nuovo Look o sovrascrivi il Look esistente.

Crea copie LookML delle dashboard

Puoi convertire una o più dashboard in una dashboard LookML e aggiornare il modello della dashboard in LookML:

  1. Per ogni dashboard, crea una copia LookML della dashboard e salvala nel tuo progetto LookML. Se le tue dashboard sono già dashboard LookML, puoi saltare questo passaggio.
  2. Nel progetto LookML, utilizza la funzione di ricerca e sostituzione dell'IDE di Looker per trovare istanze di model:, quindi aggiorna il valore con un nome di modello diverso, se vuoi.
  3. Puoi lasciare le dashboard aggiornate come dashboard LookML oppure puoi convertirle in dashboard definite dall'utente.

Utilizzare l'API Looker

Puoi utilizzare l'API Looker per aggiornare il modello per più dashboard:

  1. Utilizza l'endpoint API dashboard_elements per ottenere tutti gli elementi della dashboard. La risposta fornirà gli ID query.
  2. Se uno dei riquadri della dashboard è riquadri collegati a Look, utilizza l'endpoint looks per trovare l'ID query del Look sottostante.
  3. Per ogni ID query:
    1. Chiama l'endpoint query per ottenere il corpo della risposta della query.
    2. Copia il corpo della risposta query.
    3. Aggiorna il valore della chiave model al nuovo modello.
    4. Utilizza l'endpoint create_query per creare una nuova query, passando il corpo modificato.
  4. Per la dashboard, modifica l'ID query per ogni elemento utilizzando l'endpoint update_dashboard_element, passando il corpo modificato.

Utilizzare lo strumento di convalida dei contenuti di Looker

Lo Strumento di convalida dei contenuti è uno strumento che verifica l'eventuale presenza di errori nei Look e nelle dashboard. Dispone inoltre della funzionalità Trova e sostituisci in tutti i contenuti, che puoi usare per modificare il modello sottostante o l'esplorazione per tutti i Look o i riquadri della dashboard.

La funzionalità Trova e sostituisci in tutti i contenuti modifica tutti i Look e le dashboard dell'istanza di Looker. Per applicare una modifica solo ad alcuni Look o riquadri della dashboard, puoi apportare una modifica che provoca un errore, come descritto nei passaggi seguenti.

Se non vuoi modificare il modello o il riferimento di esplorazione per tutti i contenuti di un'istanza, ma vuoi modificare il riferimento per più Look o riquadri della dashboard alla volta, puoi utilizzare lo strumento di convalida dei contenuti per sostituire i riferimenti contemporaneamente per alcuni Look o riquadri della dashboard:

  1. Abilita la modalità di sviluppo per assicurarti che nessun utente sia interessato dalle modifiche apportate nei passaggi seguenti.
  2. "Interrompi" deliberatamente il modello esistente rinominando il file del modello nell'IDE di Looker con un altro nome che sai non esiste, ad esempio zzz. Di conseguenza, tutti i Look e le dashboard che utilizzano il modello originale non funzioneranno.
  3. Seleziona Strumento di convalida dei contenuti nel menu Sviluppo per aprire lo strumento di convalida dei contenuti.
  4. Seleziona Convalida per eseguire lo strumento di convalida dei contenuti.
  5. Nei risultati dello Strumento di convalida dei contenuti, seleziona il pulsante Contenuti per raggruppare i risultati per contenuti.
  6. Trova i Look o i riquadri della dashboard per i quali vuoi modificare il riferimento del modello.
  7. Seleziona il pulsante Sostituisci per ogni singolo Look o dashboard per sostituire il nome del modello "non funzionante" con il nuovo nome del modello che vuoi utilizzare.
  8. Verifica che i Look o i riquadri della dashboard funzionino come previsto ora che puntano al nuovo modello.
  9. Infine, torna al progetto e rinomina il file del modello nell'IDE di Looker riportandolo al nome originale ed esegui di nuovo lo strumento di convalida dei contenuti per verificare che tutti gli errori di convalida siano stati cancellati.