Lo strumento di convalida dei contenuti cerca nel LookML i nomi del modello, dell'esplorazione e dei campi a cui viene fatto riferimento nei contenuti di Looker. È uno strumento utile per convalidare i riferimenti LookML, correggere gli errori in LookML dopo aver apportato modifiche e aggiornare i nomi degli elementi LookML nel progetto.
Per utilizzare lo Strumento di convalida dei contenuti devi disporre dell'autorizzazione develop.
Per aprire lo Strumento di convalida dei contenuti, seleziona Strumento di convalida dei contenuti dal menu Sviluppo nel pannello di navigazione a sinistra. Da qui, puoi utilizzare lo strumento di convalida dei contenuti in due modi:
- Fai clic su Convalida per trovare e correggere gli errori causati da modifiche nel modello LookML.
- Fai clic su Trova e sostituisci in tutti i contenuti per trovare e sostituire i nomi del modello, dell'esplorazione o dei campi nei tuoi contenuti di Looker, indipendentemente dalla presenza di errori.
Prima di utilizzare lo strumento di convalida dei contenuti
Devi prestare extremely attenzione quando apporti modifiche utilizzando la convalida dei contenuti. Lo strumento di convalida dei contenuti non ha una funzione di annullamento e può influire su molti Look e dashboard, insieme ai link Esplora da qui. Se commetti un errore, dovresti cercare di correggerlo il prima possibile, prima che ulteriori modifiche comportino più difficoltà a isolare i Look interessati.
Inoltre, considera le tempistiche quando utilizzi lo Strumento di convalida dei contenuti. Quando trasferisci le modifiche di sviluppo in produzione, devi correggere i Look e i riquadri interessati all'incirca contemporaneamente, in modo che si interrompano per il tempo minimo necessario. Se correggi Look e riquadri troppo presto, in base al tuo lavoro in modalità di sviluppo, appariranno non funzionanti per gli utenti finché non eseguirai il push delle modifiche. Allo stesso modo, se si ritarda la correzione di Look e riquadri fino a molto tempo dopo l'invio delle modifiche, i Look e i riquadri appariranno non funzionanti per gli utenti finché non li correggi.
Usare lo strumento di convalida dei contenuti per correggere gli errori
Lo strumento di convalida dei contenuti è utile per trovare e correggere gli errori derivanti da modifiche in LookML. Ad esempio, se modifichi il nome di un campo da customer a user, tutti i Look o i riquadri della dashboard che includevano il campo customer non funzioneranno più (a meno che tu non abbia utilizzato il parametro alias). Lo strumento di convalida dei contenuti elencherà tutti i riferimenti al campo customer e fornirà anche un modo semplice per correggere l'errore.
Quando esegui lo strumento di convalida dei contenuti, lo strumento convalida tutti i riferimenti ai Look e alle dashboard nei tuoi modelli, esplorazioni, viste e campi LookML e mostrerà un errore per tutti i riferimenti forniti dai tuoi contenuti a un oggetto LookML sconosciuto.
Lo strumento di convalida dei contenuti non mostra errori per i seguenti elementi:
- Contenuti per i quali non disponi dell'autorizzazione
develop. Lo strumento di convalida dei contenuti è limitato alle tue autorizzazioni, quindi puoi usarlo solo per i contenuti per i quali disponi dell'autorizzazionedevelop(i modelli che puoi vedere nell'IDE di Looker). Per informazioni sulle autorizzazioni del modello, consulta la pagina della documentazione Ruoli. - Look che sono stati eliminati e si trovano nel Cestino. Se vuoi convalidare un Look eliminato, l'amministratore di Looker deve prima ripristinare il Look.
Esecuzione dello strumento di convalida dei contenuti
Per convalidare il tuo LookML con lo strumento di convalida dei contenuti:
- Fai clic su Validate (Convalida).
- Seleziona le schede Raggruppa per per modificare la modalità di raggruppamento degli errori:
- Errore: elenca ogni errore, raggruppando i contenuti di Looker che presentano l'errore. Questa opzione è utile se vuoi correggere lo stesso errore in più contenuti contemporaneamente.
- Cartella: elenca ogni cartella, raggruppando i contenuti di Looker che presentano errori. Questo è utile se vuoi correggere solo gli errori in una determinata cartella.
- Contenuti: elenca tutti i contenuti che presentano errori, raggruppando i relativi errori. Questo è utile se vuoi correggere tutti gli errori in un singolo Look, riquadro, filtro e così via.
- Se sei in modalità sviluppo, Looker visualizza un messaggio di avviso. È importante comprendere le implicazioni della modifica di Look e riquadri. Se li "correggi" prima di rendere attive le modifiche che provocano un errore, ci sarà un periodo di tempo in cui la correzione sarà prematura, quindi gli utenti riscontreranno Look o riquadri rotti. Il messaggio di avviso ti aiuta a ricordarlo.
- La tabella degli errori mostra gli eventuali errori, insieme a un elenco di Look e riquadri che contengono l'errore, oltre al modello sottostante e alle esplorazioni che producono l'errore. Puoi utilizzare le schede Raggruppa per in alto a destra nella pagina per modificare il layout della tabella degli errori.
- Looker fornisce i pulsanti Sostituisci e/o Rimuovi per ogni riga, a seconda del tipo di errore. Questi pulsanti consentono di correggere gli errori e sono descritti in modo più dettagliato nella sezione Utilizzare lo strumento di convalida dei contenuti per correggere gli errori.
Visualizzazione dei risultati di convalida dei contenuti
I risultati della convalida dei contenuti mostrano contenuti Looker che utilizzano nomi di modelli, nomi di esplorazioni, nomi di viste o nomi di campi che non esistono o che non è possibile trovare. Per informazioni dettagliate sugli elementi LookML che lo strumento di convalida dei contenuti può trovare e convalidare, consulta la sezione Utilizzare lo strumento di convalida dei contenuti per correggere gli errori.
L'icona accanto al nome dei contenuti identifica il tipo di contenuti:
: riquadro della dashboard
- Avviso della dashboard
: pianifica una dashboard o un Look
: applica un filtro per una dashboard o un campo di un riquadro che rimane in ascolto di un filtro della dashboard (consulta la pagina della documentazione Aggiunta e modifica di filtri delle dashboard definiti dall'utente per informazioni sulla configurazione dei riquadri per l'ascolto dei filtri della dashboard)
I risultati della convalida si basano sul LookML disponibile nella modalità in cui ti trovi quando esegui lo strumento di convalida. Se sei in modalità Produzione, i risultati della convalida rifletteranno tutto il codice LookML di cui è stato eseguito il push in produzione. Se sei in modalità di sviluppo, i risultati della convalida rifletteranno il tuo LookML salvato, anche se non è stato eseguito il push in produzione.
Gli errori potrebbero essere causati da modifiche intenzionali nel LookML, nonché da un errore di battitura o un join mancante.
Per modificare gli errori, puoi utilizzare i pulsanti Sostituisci e Rimuovi in ogni riga della tabella degli errori nel seguente modo:
- Sostituisci: Looker fornisce il pulsante Sostituisci per ogni errore (consulta la sezione Sostituzione dei nomi di campi, viste, esplorazioni e modelli più avanti in questa pagina per informazioni su come sostituire i nomi con lo strumento di convalida dei contenuti).
- Rimuovi: per gli errori con i nomi dei campi nella sezione Dati di un Look o di un riquadro, Looker visualizza anche il pulsante Rimuovi (consulta la sezione Rimozione di un nome di campo più avanti in questa pagina per informazioni su come rimuovere i nomi con lo Strumento di convalida dei contenuti).
A seconda dell'impostazione Raggruppa per, i pulsanti vengono applicati a un singolo elemento (Look o riquadro) o a più elementi:
- Se raggruppi i dati per Errore, i pulsanti si applicano a tutte le occorrenze dell'errore in tutti i Look e i riquadri dell'istanza di Looker, in modo da correggere tutte le occorrenze in un'unica operazione.
- Se raggruppi i dati per Cartella o Contenuto, i pulsanti si applicano a un'occorrenza dell'errore in un singolo Look o riquadro, consentendoti di considerare ogni occorrenza dell'errore separatamente.
Ad esempio, una tabella degli errori viene raggruppata per Errore e mostra tre istanze di contenuti con un'esplorazione sconosciuta denominata customers. L'azione prevista per i tre contenuti è Sostituisci. Fare clic su Sostituisci inciderà su tutte e tre le istanze dei contenuti con l'errore 3 x Unknown explore 'customers'.
In alcuni casi, potrebbero verificarsi più errori per determinati contenuti. Ad esempio, una tabella di errori viene raggruppata per Contenuti e mostra un contenuto chiamato Dettagli ordine. Nella colonna Errori vengono visualizzati quattro errori Unknown field e ciascuno ha i propri pulsanti di azione Sostituisci e Rimuovi nella colonna Azioni.
Inoltre, se raggruppi i dati in base a Contenuti, hai anche l'opzione aggiuntiva per eliminare i Look.
Sostituire i nomi di campi, viste, esplorazioni e modelli
I risultati della convalida dei contenuti includono un pulsante Sostituisci per i seguenti tipi di elementi, che ti consente di rinominarli:
- Nomi dei modelli nei riquadri Look e dashboard
- Esplora i nomi nei riquadri Look e dashboard
- Visualizza nomi nei filtri personalizzati o nei calcoli delle tabelle
- Visualizza i nomi nei riquadri di Look e dashboard
- Nomi dei campi:
- Nella sezione Dati di un Look
- In un riquadro di dashboard basato su query
- Ci sono riferimenti nei calcoli delle tabelle
- Ci sono riferimenti nei filtri personalizzati
- Ci sono riferimenti nei campi personalizzati
- Ci sono riferimenti nelle configurazioni di visualizzazione, ad esempio nell'area Personalizzazioni della scheda Serie per i grafici a colonne
- Fa riferimento a un riquadro della dashboard per ascoltare un filtro della dashboard (questa opzione è configurata nella scheda Riquadri da aggiornare della finestra di configurazione del filtro, descritta nella pagina della documentazione Aggiunta e modifica di filtri delle dashboard definiti dall'utente).
Per uno qualsiasi di questi errori, puoi utilizzare lo strumento di convalida dei contenuti al fine di sostituire un attributo dei contenuti uguale o più generico dell'attributo contenente l'errore:
- Se un campo contiene un errore, puoi sostituirlo/rimuoverlo oppure sostituire la visualizzazione, l'esplorazione o il nome del modello.
- Se il nome di un'esplorazione contiene un errore, puoi sostituire il nome dell'esplorazione o il nome del modello.
- Se il nome di un modello contiene un errore, puoi sostituirlo.
Di seguito viene spiegato come utilizzare lo strumento di convalida dei contenuti per sostituire i nomi degli elementi nel modello:
- Fai clic su Convalida per eseguire lo strumento di convalida dei contenuti.
- Seleziona un'impostazione Raggruppa per per scegliere come raggruppare gli errori. Ad esempio, puoi raggruppare per Errore in modo da poter modificare più elementi contemporaneamente.
Nella tabella degli errori, fai clic sul pulsante Sostituisci accanto all'errore da correggere per aprire la finestra di dialogo Aggiorna nei contenuti.
Nella sezione Tipo della finestra di dialogo Aggiorna nei contenuti, seleziona il tipo di elemento LookML che vuoi modificare: campo, vista, Esplora o modello. Looker visualizza le opzioni appropriate per ogni errore.
Nella sezione Nome, verifica il nome dell'elemento che vuoi sostituire. Lo strumento di convalida dei contenuti inserisce automaticamente queste informazioni.
Nella sezione Nome sostitutivo, inserisci il nuovo nome dell'articolo.
Se hai raggruppato i dati per Errore e sono presenti più elementi interessati, puoi fare clic su Mostra contenuti per visualizzare un elenco di elementi che verranno aggiornati dallo strumento di convalida dei contenuti.
Se vuoi, puoi deselezionare le caselle di controllo accanto a tutti gli elementi elencati per lasciare invariati i nomi.
Per apportare la modifica, fai clic su Sostituisci.
Rimozione del nome di un campo
Per gli errori con nomi dei campi nella sezione Dati di un Look o di un riquadro, la tabella degli errori mostrerà il pulsante Rimuovi a destra dell'errore. Puoi utilizzare lo strumento di convalida dei contenuti per rimuovere i campi che sono:
- Nella sezione Dati di un riquadro Look o dashboard
- Ci sono riferimenti nelle configurazioni di visualizzazione, ad esempio nell'area Personalizzazioni della scheda Serie per i grafici a colonne
- Fa riferimento a un riquadro della dashboard per ascoltare un filtro della dashboard (questa opzione è configurata nella scheda Riquadri da aggiornare della finestra di configurazione del filtro, descritta nella pagina della documentazione Aggiunta e modifica di filtri delle dashboard definiti dall'utente).
Non puoi utilizzare lo strumento di convalida dei contenuti per rimuovere i campi da filtri personalizzati, campi personalizzati o calcoli tabulari, poiché in genere sono necessarie ulteriori modifiche per far sì che l'espressione funzioni. Utilizza invece i messaggi di errore relativi alla convalida dei contenuti per individuare le posizioni in cui è necessario correggere filtri personalizzati, campi personalizzati ed espressioni di calcolo tabulare, quindi rielabora l'espressione in base alle tue esigenze.
- Fai clic su Convalida per eseguire lo strumento di convalida dei contenuti.
- Seleziona un'impostazione Raggruppa per per scegliere come raggruppare gli errori. Ad esempio, puoi raggruppare per Errore in modo da poter regolare più elementi (Look, riquadri o entrambi) contemporaneamente.
Nella tabella degli errori, fai clic su Rimuovi accanto all'errore del campo che vuoi correggere per aprire la finestra di dialogo Rimuovi campo dai contenuti.
Nella sezione Campo della finestra di dialogo Rimuovi campo dai contenuti, verifica il nome dell'elemento che vuoi rimuovere. Lo strumento di convalida dei contenuti lo compila automaticamente.
Se hai raggruppato per Errore e sono presenti più elementi (Look, riquadri o entrambi), puoi fare clic su Mostra contenuto per vedere un elenco di elementi che verranno aggiornati dallo strumento di convalida dei contenuti.
Se vuoi, puoi deselezionare le caselle di controllo accanto a qualsiasi Look o riquadro per lasciare invariati i nomi.
Fai clic su Rimuovi campo per apportare la modifica.
Eliminazione dei Look
Se raggruppi la tabella degli errori per Content, puoi scegliere di eliminare i Look nella tabella.
Per utilizzare lo strumento di convalida dei contenuti al fine di eliminare i Look:
- Fai clic su Convalida per eseguire lo strumento di convalida dei contenuti.
- Raggruppa la tabella per Contenuti.
- Nella tabella degli errori, fai clic sulla casella Seleziona accanto al Look o ai Look da eliminare.
- Fai clic su Elimina tutti i Look selezionati.
- Fai clic su OK nella casella di conferma per eliminare il Look o i Look selezionati.
Utilizzare lo strumento di convalida dei contenuti per trovare e sostituire
Lo strumento di convalida dei contenuti può essere utilizzato anche per cercare e sostituire i nomi di modelli, esplorazioni e campi. Ad esempio, potresti decidere di preferire un campo rispetto a un altro e di effettuarne la sostituzione nel progetto, anche se non ci sono errori. L'elenco completo degli elementi che lo Strumento di convalida dei contenuti può cercare o sostituire è disponibile nella sezione Sostituzione dei nomi di campi, viste, esplorazioni e modelli.
Per utilizzare lo Strumento di convalida dei contenuti come strumento di ricerca e sostituzione:
- Nella schermata dello strumento di convalida dei contenuti, fai clic su Trova e sostituisci in tutti i contenuti per aprire la finestra di dialogo Aggiorna nei contenuti.
- Seleziona il Tipo di elemento LookML che vuoi modificare (campo, vista, Esplora o modello).
- Inserisci il nome dell'elemento che vuoi sostituire.
- Inserisci un nome sostitutivo per il campo, la visualizzazione, l'esplorazione o il modello.
- Fai clic su Sostituisci per apportare la modifica.
Aspetti da considerare
Pianifica di nuovo la convalida dei contenuti per visualizzare i risultati di eventuali correzioni apportate.
Tieni presente quanto segue in merito allo strumento di convalida dei contenuti:
- Per le viste, le esplorazioni o i modelli, puoi cambiare il nome, ma non puoi rimuovere del tutto i nomi. Consulta la sezione Rimozione del nome di un campo per un elenco degli elementi che puoi rimuovere con lo Strumento di convalida dei contenuti.
- I calcoli tabulari possono fare riferimento solo ai campi inclusi nella query di un Look o di un riquadro. Ciò significa che se rimuovi un campo da una query Look o di un riquadro, ma un calcolo tabulare utilizza ancora quel campo, riceverai un nuovo errore di convalida dei contenuti.
- I Look che sono stati eliminati e che si trovano nella pagina Cestino non verranno convalidati. Se vuoi convalidare un Look eliminato, l'amministratore di Looker deve prima ripristinare il Look.
- Se sei in modalità di sviluppo, i risultati della convalida rifletteranno il tuo LookML salvato anche se non è stato eseguito il push in produzione. Tuttavia, qualsiasi modifica apportata utilizzando lo strumento di convalida dei contenuti influirà sugli utenti che visualizzano i contenuti in modalità Produzione. Valuta la possibilità di passare alla modalità Produzione prima di eseguire lo strumento di convalida dei contenuti.