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 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 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 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 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 rimarranno inaccessibili agli utenti finché non li correggerai.
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 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 del modello, consulta la pagina della documentazione 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 la modalità di raggruppamento degli errori:
- Errore: elenca ogni errore, raggruppando i contenuti di Looker che presentano l'errore. Questa operazione è 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 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 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 forniscono 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 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 per 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 codice LookML disponibile nella modalità in cui esegui lo strumento di convalida. Se sei in modalità Produzione, i risultati della convalida rifletteranno tutto il LookML che è stato inviato 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 correggere 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 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 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 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 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 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. 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 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 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 ai Contenuti, hai a disposizione 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, in modo da poterli rinominare:
- Nomi dei modelli nei riquadri 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 Look e dashboard
- 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
- Ci sono riferimenti 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 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 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 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 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 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 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 tabulari, quindi riformula l'espressione in base alle esigenze.
- 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 contenuto per vedere un elenco di elementi che verranno aggiornati dallo strumento di convalida dei contenuti.
Facoltativamente, 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 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 rispetto a un altro e di effettuarne la sostituzione nel progetto, anche se non ci sono errori. 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, 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 delle 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 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 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 ripristinare il Look.
- Se sei in modalità di sviluppo, i risultati della convalida rifletteranno il tuo LookML salvato anche se non è stato inviato 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.