Lo strumento di convalida dei contenuti cerca nel codice LookML i nomi di modelli, esplorazioni e 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 Convalida dei contenuti dal menu Sviluppa nel riquadro 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 al modello LookML.
- Fai clic su Trova e sostituisci in tutti i contenuti per trovare e sostituire i nomi di modelli, esplorazioni o campi nei contenuti di Looker, indipendentemente dal fatto che siano presenti o meno errori.
Prima di utilizzare lo strumento di convalida dei contenuti
Devi prestare estrema attenzione quando apporti modifiche utilizzando la convalida dei contenuti. Lo strumento di convalida dei contenuti non dispone di una funzione di annullamento e potrebbe influire su molti look e dashboard, nonché sui relativi link Esplora da qui. Se fai un errore, devi provare a correggerlo il prima possibile, prima che ulteriori modifiche rendano più difficile isolare i look interessati.
Inoltre, tieni conto dei tempi quando utilizzi lo strumento di convalida dei contenuti. Quando apporti modifiche di sviluppo in produzione, devi correggere gli stili e i riquadri interessati all'incirca nello stesso momento, in modo che non siano disponibili per il tempo minimo. Se correggi i look e i riquadri troppo presto, in base al tuo lavoro in modalità di sviluppo, questi appariranno non funzionanti per gli utenti finché non invii le modifiche. Analogamente, se non correggi gli aspetti e i riquadri molto tempo dopo aver applicato le modifiche, questi elementi appariranno inaccessibili agli utenti finché non li correggerai.
Utilizzare lo strumento di convalida dei contenuti per correggere gli errori
Lo strumento di convalida dei contenuti è uno strumento utile per trovare e correggere gli errori derivanti da modifiche al LookML. Ad esempio, se cambi il nome di un campo da customer a user, tutti i riquadri di dashboard o di Look che includevano il campo customer non funzioneranno più (a meno che non tu abbia utilizzato il parametro alias). Lo strumento di convalida dei contenuti elenca tutti i riferimenti al campo customer e fornisce anche un modo semplice per correggere l'errore.
Quando esegui lo strumento di convalida dei contenuti, vengono convalidati tutti i riferimenti che i look e le dashboard fanno ai modelli, alle esplorazioni, alle visualizzazioni e ai campi di LookML e viene visualizzato un errore per tutti i riferimenti che i contenuti fanno a un oggetto LookML sconosciuto.
Lo strumento di convalida dei contenuti non mostra errori per quanto segue:
- Contenuti per i quali non disponi dell'autorizzazione
develop. Lo strumento di convalida dei contenuti è limitato alle tue autorizzazioni, pertanto puoi utilizzarlo solo per i contenuti per i quali disponi dell'autorizzazionedevelop(i modelli che puoi vedere nell'IDE di Looker). Per informazioni sulle autorizzazioni dei modelli, consulta la pagina di documentazione relativa ai ruoli. - Look che sono stati eliminati e si trovano nel cestino. Se vuoi convalidare un look eliminato, il tuo amministratore di Looker deve prima ripristinarlo.
Eseguire lo 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 il modo in cui gli errori vengono raggruppati:
- Errore: elenca ogni errore raggruppando i contenuti di Looker che contengono l'errore. Questa operazione è utile se vuoi correggere lo stesso errore in più contenuti contemporaneamente.
- Cartella: elenca ogni cartella, raggruppando i contenuti di Looker contenenti errori. Questa opzione è utile se vuoi correggere solo gli errori in una determinata cartella.
- Contenuti: elenca ogni contenuto contenente errori, raggruppando gli errori. Questa opzione è utile se vuoi correggere tutti gli errori in un singolo look, riquadro, filtro e così via.
- Se sei in modalità di sviluppo, Looker fornisce un messaggio di avviso. È importante comprendere le implicazioni della modifica di look e riquadri. Se li "correggi" prima di rendere effettive le modifiche che causano interruzioni, ci sarà un periodo di tempo in cui la correzione sarà prematura, quindi gli utenti vedranno look o riquadri non funzionanti. Il messaggio di avviso ti aiuta a ricordarlo.
- La tabella degli errori mostra eventuali errori, insieme a un elenco di look e riquadri che contengono l'errore, oltre al modello e all'esplorazione sottostanti che lo generano. 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 forniscono la funzionalità per correggere gli errori e sono descritti in modo più dettagliato in Utilizzare lo strumento di convalida dei contenuti per correggere gli errori.
Visualizzazione dei risultati della convalida dei contenuti
I risultati della convalida dei contenuti mostrano i contenuti di Looker che utilizzano nomi di modelli, nomi di esplorazioni, nomi di visualizzazioni o nomi di campi che non esistono o non possono essere trovati. Consulta la sezione Utilizzare lo strumento di convalida dei contenuti per correggere gli errori per informazioni dettagliate sugli elementi LookML che lo strumento può trovare e convalidare.
L'icona accanto al nome dei contenuti ne identifica il tipo:
- Riquadro della dashboard
- Avviso della dashboard
- Pianifica per una dashboard o un Look
- Filtra per una dashboard o un campo in un riquadro che ascolta un filtro della dashboard (consulta la pagina della documentazione Aggiunta e modifica di filtri della dashboard definiti dall'utente per informazioni sulla configurazione dei riquadri in modo che ascoltino i filtri della dashboard)
I risultati della convalida si basano sul codice LookML disponibile nella modalità in cui esegui lo strumento di convalida. Se sei in modalità di produzione, i risultati della convalida rifletteranno tutto il codice LookML che è stato trasferito in produzione. Se sei in modalità di sviluppo, i risultati della convalida rifletteranno il LookML salvato, anche se non è stato eseguito il push in produzione.
Gli errori possono essere causati da modifiche intenzionali nel codice LookML, nonché da un errore ortografico o da una join mancante.
Per correggere gli errori, puoi utilizzare i pulsanti Sostituisci e Rimuovi in ogni riga della tabella degli errori come segue:
- Sostituisci: Looker fornisce il pulsante Sostituisci per ogni errore (consulta la sezione Sostituisci i nomi di campi, visualizzazioni, esplorazioni e modelli di questa pagina per scoprire come sostituire i nomi con lo strumento di convalida dei contenuti).
- Rimuovi: per gli errori relativi ai nomi dei campi nella sezione Dati di un look o un riquadro, Looker mostra anche il pulsante Rimuovi (consulta la sezione Rimuovere un nome di campo di questa pagina per scoprire come rimuovere i nomi con lo strumento di convalida dei contenuti).
A seconda dell'impostazione Raggruppa per, i pulsanti verranno applicati a un singolo elemento (look o riquadro) o a più elementi:
- Se raggruppi per Errore, i pulsanti si applicano a tutte le occorrenze dell'errore in tutti i look e i riquadri dell'istanza di Looker, il che ti consente di correggere tutte le occorrenze in un'unica operazione.
- Se raggruppi per Cartella o Contenuti, i pulsanti si applicano a un'occorrenza dell'errore in un singolo look o riquadro, il che ti consente di considerare ogni occorrenza dell'errore separatamente.
Ad esempio, una tabella di errori è raggruppata per Error e mostra tre istanze di contenuti con un'esplorazione sconosciuta denominata customers. L'azione fornita per i tre contenuti è Sostituisci. Se fai clic su Sostituisci, l'errore 3 x Unknown explore 'customers' verrà applicato a tutte e tre le istanze dei contenuti.
In alcuni casi, potrebbero essere presenti più errori per alcuni contenuti. Ad esempio, una tabella di errori è raggruppata per Contenuti e mostra un contenuto denominato Dettagli ordine. Nella colonna Errori sono visualizzati quattro errori Unknown field e ogni errore ha i propri pulsanti di azione Sostituisci e Rimuovi nella colonna Azioni.
Inoltre, se raggruppi per Contenuti, hai la possibilità aggiuntiva di eliminare i look.
Sostituzione dei nomi di campi, visualizzazioni, esplorazioni e modelli
I risultati della convalida dei contenuti includono un pulsante Sostituisci per i seguenti tipi di elementi, in modo da poterli rinominare:
- Nomi dei modelli nei riquadri di Look e dashboard
- Esplorare i nomi nei riquadri di dashboard e look
- Visualizzare i nomi nei filtri personalizzati o nei calcoli tabulari
- Visualizzare i nomi nei riquadri di dashboard e Look
- Nomi dei campi:
- Nella sezione Dati di un look
- In un riquadro della dashboard basato su query
- A cui viene fatto riferimento nei calcoli tabulari
- A cui viene fatto riferimento nei filtri personalizzati
- Riferimenti nei campi personalizzati
- A cui viene fatto riferimento nelle configurazioni di visualizzazione, ad esempio nell'area Personalizzazioni della scheda Serie per i grafici a colonne
- A cui fa riferimento un riquadro della dashboard per ascoltare un filtro della dashboard (questo viene configurato nella scheda Riquadri da aggiornare della finestra di configurazione del filtro, descritta nella pagina della documentazione Aggiunta e modifica di filtri della dashboard definiti dall'utente)
Per uno di questi errori, puoi utilizzare lo strumento di convalida dei contenuti per sostituire un attributo dei contenuti uguale o più generale dell'attributo che genera l'errore:
- Se un campo genera un errore, puoi sostituirlo/rimuoverlo oppure sostituire il nome della visualizzazione, dell'esplorazione o del modello.
- Se il nome di un'esplorazione genera un errore, puoi sostituire il nome dell'esplorazione o del modello.
- Se il nome di un modello genera un errore, puoi sostituirlo.
Ecco 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 il modo in cui raggruppare gli errori. Ad esempio, puoi raggruppare in base a Errore per 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 in Contenuti, seleziona il tipo di elemento LookML che vuoi modificare: campo, visualizzazione, esplorazione o modello. Looker mostra le opzioni appropriate per ogni errore.
Nella sezione Nome, verifica il nome dell'elemento da sostituire. Lo strumento di convalida dei contenuti compila automaticamente queste informazioni.
Nella sezione Nome sostitutivo, inserisci il nuovo nome dell'elemento.
Se hai raggruppato per Errore e sono presenti più elementi interessati, puoi fare clic su Mostra contenuti per visualizzare un elenco di elementi che verranno aggiornati dal validatore dei contenuti.
Se vuoi, puoi deselezionare le caselle di controllo accanto agli elementi elencati per lasciare invariati i relativi nomi.
Per apportare la modifica, fai clic su Sostituisci.
Rimuovere il nome di un campo
Per gli errori relativi ai nomi dei campi nella sezione Dati di un look o un riquadro, la tabella degli errori fornisce un 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 di un look o di una dashboard
- A cui viene fatto riferimento nelle configurazioni di visualizzazione, ad esempio nell'area Personalizzazioni della scheda Serie per i grafici a colonne
- A cui fa riferimento un riquadro della dashboard per ascoltare un filtro della dashboard (questo viene configurato nella scheda Riquadri da aggiornare della finestra di configurazione del filtro, descritta nella pagina della documentazione Aggiunta e modifica di filtri della dashboard definiti dall'utente)
Non puoi utilizzare lo strumento di convalida dei contenuti per rimuovere campi da filtri personalizzati, campi personalizzati o calcoli tabulari, perché in genere devi apportare ulteriori modifiche per mantenere l'espressione funzionante. Utilizza invece i messaggi di errore di convalida dei contenuti per trovare i punti in cui è necessario correggere filtri personalizzati, campi personalizzati ed espressioni di calcolo tabulare, quindi riformula l'espressione come appropriato.
- Fai clic su Convalida per eseguire lo strumento di convalida dei contenuti.
- Seleziona un'impostazione Raggruppa per per scegliere il modo in cui raggruppare gli errori. Ad esempio, puoi raggruppare per Errore in modo da poter modificare contemporaneamente più elementi (look, riquadri o entrambi).
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 contenuti per visualizzare un elenco di elementi che verranno aggiornati dal convalidatore dei contenuti.
Se vuoi, puoi deselezionare le caselle di controllo accanto a look o riquadri per lasciare invariati i relativi nomi.
Fai clic su Rimuovi campo per apportare la modifica.
Eliminazione dei look
Se raggruppi la tabella degli errori per Contenuti, hai la possibilità di eliminare i look nella tabella.
Per utilizzare lo strumento di convalida dei contenuti per 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 che vuoi 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 a un altro e voler effettuare la sostituzione nel tuo progetto, anche se non è presente alcun errore. L'elenco completo degli elementi che Content Validator può cercare/sostituire è fornito nella sezione Sostituzione dei nomi di campi, visualizzazioni, 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, visualizzazione, esplorazione 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 eseguire nuovamente la convalida dei contenuti per visualizzare i risultati delle eventuali correzioni apportate.
Tieni presente quanto segue in merito allo strumento di convalida dei contenuti:
- Per le visualizzazioni, le esplorazioni o i modelli, puoi modificare i nomi, ma non puoi rimuoverli del tutto. Consulta la sezione Rimozione del nome di un campo per un elenco di 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 un riquadro. Ciò significa che se rimuovi un campo dalla query di un look o riquadro, ma un calcolo della tabella lo utilizza ancora, verrà visualizzato un nuovo errore di convalida dei contenuti.
- I look che sono stati eliminati e si trovano nella pagina Cestino non verranno convalidati. Se vuoi convalidare un look eliminato, l'amministratore di Looker deve prima ripristinarlo.
- Se sei in modalità di sviluppo, i risultati della convalida rifletteranno il LookML salvato anche se non è stato eseguito il push in produzione. Tuttavia, le modifiche apportate utilizzando lo strumento di convalida dei contenuti influiranno sugli utenti che visualizzano i contenuti in modalità di produzione. Valuta la possibilità di passare alla modalità di produzione prima di eseguire lo strumento di convalida dei contenuti.