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 (Look e dashboard). È 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
.
Il ragionamento è che uno sviluppatore deve essere in grado di correggere i contenuti che potrebbero essere danneggiati quando apporta modifiche al LookML sottostante.
Per aprire lo strumento di convalida dei contenuti, seleziona Convalida dei contenuti dal menu Sviluppa nel riquadro di navigazione principale. 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 periodo di 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 i look 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 i pulsanti Sostituisci o Rimuovi 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:
- Look che sono stati eliminati e si trovano nel cestino. Se vuoi convalidare un look eliminato, l'amministratore di Looker deve prima ripristinarlo.
Contenuti basati su modelli LookML per i quali non disponi dell'autorizzazione
develop
. Puoi utilizzare lo strumento di convalida dei contenuti solo per i contenuti basati su modelli 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.
Eseguire lo strumento di convalida dei contenuti
Per migliorare il rendimento di Content Validator, un amministratore di Looker può attivare la funzionalità di Labs Content Validator Scoping nella tua istanza. Quando questa funzionalità di Labs è abilitata, puoi limitare la convalida a progetti LookML e a una cartella di contenuti specifici. Per informazioni su come definire l'ambito della convalida, consulta la sezione Definire l'ambito del convalidatore dei contenuti.
Se la funzionalità Scoping Labs di Content Validator non è attivata nella tua istanza, segui questi passaggi per eseguire la convalida dei contenuti:
- Fai clic sull'icona del menu principale di Looker e seleziona Sviluppa, se il menu Sviluppa non è già visualizzato.
- Nel menu Sviluppa, seleziona Convalidatore dei contenuti.
- Nella pagina dello strumento di convalida dei contenuti, fai clic su Convalida.
Lo strumento di convalida dei contenuti eseguirà la convalida di tutti i contenuti basati su progetti LookML per i quali disponi dell'autorizzazione develop
e poi mostrerà i risultati. Per informazioni su come esaminare i risultati, consulta la sezione Visualizzazione dei risultati della convalida dei contenuti.
Definire l'ambito dello strumento di convalida dei contenuti
Quando la funzionalità di Labs Definizione dell'ambito del convalidatore dei contenuti è abilitata, puoi definire l'ambito della convalida in base a progetti LookML specifici e a una cartella dei contenuti specifica (incluse eventuali sottocartelle). In questo modo, puoi migliorare il rendimento di Content Validator.
Tieni presente quanto segue per l'ambito di Content Validator:
- Se non specifichi una cartella o un progetto LookML, la convalida non verrà limitata. Lo strumento di convalida dei contenuti convaliderà tutti i contenuti basati su modelli per i quali disponi dell'autorizzazione
develop
. - Se specifichi una cartella dei contenuti, lo strumento di convalida dei contenuti eseguirà la convalida sulla cartella dei contenuti e su tutte le relative sottocartelle, se presenti.
- Se specifichi una cartella di contenuti e uno o più progetti LookML, verranno applicate entrambe le condizioni: lo strumento di convalida dei contenuti limita la convalida solo ai contenuti della cartella (e delle sottocartelle) basati sui progetti LookML selezionati.
- Gli avvisi della dashboard, le pianificazioni delle dashboard e le pianificazioni dei look non vengono memorizzati nelle cartelle dei contenuti. Pertanto, se limiti l'ambito della convalida dei contenuti a una cartella, lo strumento di convalida dei contenuti non convaliderà pianificazioni o avvisi.
Se specifichi un progetto LookML, lo strumento di convalida dei contenuti determina i modelli associati del progetto esaminando il codice LookML di origine dei progetti specificati e i modelli configurati per ciascun progetto, che puoi visualizzare nella pagina Progetti LookML. Se un file del modello è stato eliminato da un progetto LookML e non è visualizzato come modello nel progetto nella pagina Progetti LookML, lo strumento di convalida dei contenuti non mostrerà errori relativi ai contenuti basati sul modello eliminato.
Per eseguire lo strumento di convalida dei contenuti in un'istanza di Looker con l'ambito di convalida dei contenuti abilitato:
- Fai clic sull'icona del menu principale di Looker e seleziona Sviluppa, se il menu Sviluppa non è già visualizzato.
- Nel menu Sviluppa, seleziona Convalidatore dei contenuti.
Nella pagina dello strumento di convalida dei contenuti, fai clic su Convalida.
Lo strumento di convalida dei contenuti mostra la finestra di dialogo Scegli i progetti da convalidare.
Nella finestra di dialogo Scegli i progetti da convalidare, esegui una delle seguenti operazioni:
- Per eseguire il validatore su tutti i progetti LookML, lascia invariato il campo Seleziona progetti, senza selezionare alcun progetto, quindi fai clic su Avanti.
- Per eseguire il validatore su uno o più progetti LookML specifici, fai clic sul menu a discesa Seleziona progetti, seleziona i progetti da convalidare e poi fai clic su Avanti.
Lo strumento di convalida dei contenuti mostra la finestra di dialogo Scegli la cartella da convalidare.
Nella finestra di dialogo Scegli la cartella da convalidare, esegui una delle seguenti operazioni:
- Per eseguire lo strumento di convalida su tutte le cartelle dei contenuti, lascia invariato il selettore Cartelle, senza selezionare alcuna cartella, quindi fai clic su Avanti.
- Per eseguire il convalidatore in una cartella di contenuti specifica (e nelle relative sottocartelle, se presenti), utilizza il selettore Cartelle per selezionare la cartella da convalidare e poi fai clic su Avanti.
La finestra di dialogo Esamina le selezioni mostra i progetti e le cartelle selezionati per la convalida.
Nella finestra di dialogo Rivedi le selezioni, fai clic su Convalida.
Lo strumento di convalida dei contenuti eseguirà la convalida dei contenuti specificati e poi mostrerà i risultati. Per informazioni su come esaminare i risultati, consulta la sezione Visualizzazione dei risultati della convalida dei contenuti.
Visualizzazione dei risultati della convalida dei contenuti
Quando lo strumento di convalida dei contenuti completa una convalida, viene visualizzata una tabella degli errori. Se un amministratore di Looker ha attivato la funzionalità di definizione dell'ambito di Content Validator di Labs nella tua istanza, i risultati della convalida sono limitati ai progetti e alle cartelle selezionati quando hai eseguito Content Validator.
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.
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.
La tabella degli errori mostra ogni errore, 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:
- 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.
L'icona accanto al nome dei contenuti ne identifica il tipo:
- Riquadro della dashboard
- Avviso della dashboard
- Pianifica per una dashboard o un Look
: filtro 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)
Gli errori possono essere causati da modifiche intenzionali nel codice LookML, nonché da un errore ortografico o da una join mancante.
Per ogni riga, Looker fornisce un pulsante Sostituisci o un pulsante Rimuovi oppure entrambi, 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. 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 Sostituisci e Rimuovi si applicano 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 di 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 causa un errore, puoi sostituirlo o rimuoverlo oppure sostituire il nome della visualizzazione, dell'esplorazione o del modello.
- Se un nome di esplorazione causa un errore, puoi sostituire il nome dell'esplorazione o del modello.
- Se un nome del modello causa 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 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 sul pulsante Elimina tutti i look selezionati nella parte superiore della tabella degli errori.
- 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 e sostituire è fornito nella sezione Sostituzioni 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 cartella 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.