Utilizzo del dizionario di dati di Looker

Il dizionario di dati di Looker è diverso dal blocco del dizionario di dati.

Per usufruire della funzionalità completa dell'estensione del dizionario dei dati di Looker, gli amministratori devono aggiornare l'applicazione del dizionario dei dati di Looker alla versione 2.0.0 o successiva.

Il dizionario di dati di Looker è un'estensione, un'applicazione web creata utilizzando i componenti di Looker, sviluppata utilizzando il framework di estensione di Looker e implementata tramite Looker Marketplace.

L'estensione Looker Data Dictionary fornisce un'interfaccia centralizzata dedicata per la ricerca in tutti i campi e le descrizioni di Looker. Utilizza questa estensione per svolgere le seguenti attività: * Fornisci una directory in cui cercare tutte le metriche e le descrizioni per consentire agli utenti di identificare la dimensione o la misura appropriata per l'analisi. * Consenti agli stakeholder esterni di identificare e individuare facilmente metriche uniche. * Controlla i modelli LookML per valutare se vengono seguite convenzioni di denominazione coerenti, se sono presenti campi ridondanti o se i campi sono annotati con descrizioni. * Aggiungi e condividi commenti su campi specifici (se l'applicazione del dizionario dei dati di Looker è nella versione 2.0.0 o successiva).

Affinché gli utenti possano accedere e utilizzare il dizionario di dati di Looker, gli amministratori di Looker devono eseguire i seguenti passaggi:

1. Attiva le funzionalità appropriate.
2. Installa l'estensione Dizionario dei dati di Looker.
3. Concedi le autorizzazioni per accedere al dizionario dei dati di Looker.

Una volta che l'estensione è disponibile per gli utenti, puoi eseguire le seguenti operazioni:

1. Vai al dizionario di dati di Looker.
2. Visualizza i metadati del modello.

Installazione del dizionario di dati di Looker

Prima di installare il dizionario di dati di Looker dal Marketplace, gli amministratori di Looker devono attivare queste funzionalità:

• Marketplace: per accedere a Looker Marketplace (abilitato per impostazione predefinita)
• Framework di estensione: per eseguire il deployment delle estensioni sviluppate utilizzando il framework di estensione di Looker (abilitato per impostazione predefinita)

Per installare applicazioni e strumenti, ad esempio estensioni, dal Marketplace devi disporre delle autorizzazioni develop, manage_models e deploy.

Consulta la documentazione Utilizzare Looker Marketplace per istruzioni su come installare uno strumento da Looker Marketplace. Per assicurarti di avere sempre la versione più aggiornata del dizionario dei dati, vai al marketplace di Looker, seleziona Gestisci e poi il pulsante Aggiorna accanto all'estensione.

Concedere le autorizzazioni per accedere al dizionario dei dati di Looker

Dopo aver installato il dizionario di dati di Looker, un modello denominato data-dictionary viene aggiunto automaticamente all'elenco dei modelli disponibili nelle pagine Nuovo set di modelli e Modifica set di modelli, accessibili dalla pagina Ruoli nel riquadro Amministrazione.

Gli amministratori di Looker devono concedere agli utenti le autorizzazioni explore o develop per accedere al modello data-dictionary e a tutti i modelli che devono esplorare nel dizionario dei dati. Per informazioni su come concedere agli utenti le autorizzazioni per accedere e utilizzare le estensioni, consulta la pagina della documentazione Impostare le autorizzazioni per le estensioni di Looker.

Concedere le autorizzazioni per interagire con i commenti dei campi

I commenti dei campi consentono agli utenti di aggiungere contesto alle definizioni dei campi senza dover aggiornare il LookML. Per impostazione predefinita, tutti gli utenti che hanno accesso all'estensione del dizionario di dati potranno visualizzare tutti i commenti e aggiungere, modificare ed eliminare i propri.

Se lo desiderano, gli amministratori di Looker possono gestire il modo in cui gli utenti interagiscono con la funzionalità dei commenti ai campi creando gruppi di utenti specifici nella pagina Gruppi del pannello Amministrazione e assegnando gli utenti a questi gruppi. Per ulteriori informazioni su come assegnare gli utenti ai gruppi, consulta la pagina della documentazione relativa ai gruppi.

I gruppi di utenti devono essere creati con i nomi predefiniti mostrati nella colonna Nome gruppo della tabella seguente. La tabella mostra anche i privilegi predefiniti che avranno gli utenti assegnati a ciascun gruppo.

Nome gruppo	Privilegi
marketplace_data_dictionary_comments_disabled	Gli utenti non possono vedere né interagire con i commenti; tutte le funzionalità dei commenti sono disattivate. I privilegi di questo gruppo hanno sempre la precedenza su quelli di altri gruppi: qualsiasi utente incluso nel gruppo disabled non avrà accesso alla funzionalità dei commenti, anche se appartiene a un altro gruppo con privilegi più elevati.
marketplace_data_dictionary_comments_reader	L'utente può vedere i commenti esistenti, ma non può aggiungerne.
marketplace_data_dictionary_comments_writer	Gli utenti possono vedere tutti i commenti, aggiungerne di nuovi e modificare/eliminare i propri. Questo è il privilegio predefinito.
marketplace_data_dictionary_comments_manager	Gli utenti possono visualizzare tutti i commenti, aggiungerne di nuovi e modificarli/eliminarli.

Se un utente non appartiene a nessuno di questi gruppi, verrà utilizzato il valore predefinito writer. Se un utente è assegnato a più gruppi (escluso marketplace_data_dictionary_comments_disabled), ha la precedenza il privilegio più elevato.

Le modifiche a un gruppo di commenti, ad esempio l'aggiunta o la rimozione di un utente, apportate tramite la pagina Gruppi nel riquadro Amministrazione verranno applicate dopo un aggiornamento forzato della pagina del dizionario dei dati o dopo che l'utente avrà selezionato un'altra opzione e poi tornerà alla pagina del dizionario dei dati.

Navigazione fino al dizionario di dati di Looker

Puoi accedere al dizionario dei dati dall'elenco delle applicazioni e delle estensioni installate nella barra laterale sinistra.

Visualizzazione dei metadati del modello con il dizionario di dati di Looker

Nel dizionario dei dati di Looker, gli utenti con autorizzazioni explore per un modello possono selezionare questo modello e visualizzarne i metadati, incluse le esplorazioni e l'elenco dei campi di ogni esplorazione, raggruppati per visualizzazione. Il dizionario dei dati di Looker mostra le esplorazioni del modello selezionato nella barra laterale sinistra e le viste e i campi dell'esplorazione selezionata nella parte principale della pagina.

Gli utenti possono comprimere la barra laterale selezionando l'icona <.

Il dizionario dei dati di Looker mostra le seguenti informazioni:

1. Il nome del modello selezionato
2. L'elenco delle esplorazioni contenute nel modello selezionato
3. L'esplorazione selezionata
4. Un campo di testo per filtrare i campi in un'esplorazione
5. Filtri rapidi per restringere i campi visualizzati in base alle caratteristiche selezionate
6. Il nome della visualizzazione
7. Metadati relativi a ogni campo. Seleziona i metadati da visualizzare selezionando il pulsante Opzioni di visualizzazione. Visualizza l'intero insieme di metadati del campo nel profilatore dei campi.
8. Righe contenenti i metadati per ogni campo in una determinata visualizzazione
9. Navigazione all'esplorazione nell'interfaccia utente di Looker

Selezione di un modello e un'esplorazione

L'elenco a discesa Seleziona un modello elenca tutti i modelli per i quali un utente dispone delle autorizzazioni explore. Quando scegli un modello dal menu a discesa Seleziona un modello, nella barra laterale sinistra viene visualizzato un elenco delle esplorazioni del modello.

Puoi anche cercare un'esplorazione specifica nel modello selezionato digitandola nella casella di ricerca Cerca modello. L'elenco delle esplorazioni verrà filtrato per mostrare solo i risultati che corrispondono ai tuoi termini di ricerca.

Seleziona il nome di un'esplorazione per visualizzare i relativi campi, raggruppati per visualizzazione, nella parte principale della pagina.

Puoi anche selezionare il pulsante Esplora nell'angolo in alto a destra per andare direttamente alla pagina Esplora in Looker.

Filtrare i campi in un'esplorazione

Puoi filtrare i campi visualizzati digitando del testo nella casella Filtra i campi in questa esplorazione in modo che corrisponda all'Etichetta campo o alla Descrizione dell'elenco dei campi.

Puoi anche selezionare attributi dei metadati specifici in base ai quali filtrare, ad esempio se il campo:

• Deve avere una descrizione
• È una dimensione o una misura
• Contiene tag
• Deve essere di tipo string, number, date, zipcode, count, sum, average, list o unquoted

Visualizzazione dei metadati dei campi

Il dizionario dei dati di Looker mostra i metadati dei campi di un'esplorazione, raggruppati per visualizzazione:

• Etichetta campo: il nome del campo in base al parametro label del campo
• Categoria: la categoria del campo come dimensione o misura
• Descrizione: la descrizione del campo in base al parametro description del campo
• Nome LookML: il nome del campo nella sintassi view_name.field_name
• Tipo: il tipo di campo come stringa, numero, data, codice postale, conteggio, somma, media, elenco o senza virgolette in base al parametro type del campo
• SQL: l'espressione SQL che fa riferimento al campo
• Tag: i tag LookML associati al campo

Personalizzare i metadati visualizzati

Puoi specificare quali metadati vengono visualizzati per ogni campo selezionando il pulsante Opzioni di visualizzazione nell'angolo in alto a destra e selezionando o deselezionando le caselle dei metadati che vuoi visualizzare.

Utilizzare i commenti dei campi

Se un'istanza ha già il marketplace, gli amministratori devono assicurarsi che l'estensione del dizionario dei dati sia nella versione 2.0.0 o successiva per utilizzare i commenti a livello di campo.

Gli sviluppatori di LookML includono spesso informazioni o spiegazioni aggiuntive sui campi di un modello nel parametro description a livello di campo. Tuttavia, queste descrizioni non sono sempre significative o utili per tutti gli utenti. Con i commenti a livello di campo, gli utenti possono aggiungere contesto a un campo specifico. Questi commenti sono visibili agli altri utenti, ma non influiscono sul codice LookML sottostante del modello.

Gli amministratori devono concedere agli utenti la possibilità di interagire con i commenti aggiungendoli a gruppi specifici nella pagina Gruppi del riquadro Amministrazione. Per impostazione predefinita, tutti gli utenti con accesso all'estensione del dizionario dei dati possono visualizzare tutti i commenti e aggiungere, modificare ed eliminare i propri.

Aggiunta di un commento al campo

Per aggiungere un commento a un campo:

1. Passa il mouse sopra la riga del campo per visualizzare un'icona + (se non sono presenti commenti per il campo) o un'icona a forma di blocco note (se sono presenti commenti per il campo). Fai clic sull'icona per aprire la scheda Commenti del riquadro del profiler dei campi.
2. Fai clic sul pulsante Aggiungi commento.
3. Digita il commento e seleziona il pulsante Commenta per salvare la voce. Fai clic su Annulla per chiudere lo strumento di analisi dei campi. Puoi espandere la casella dei commenti selezionando e trascinando l'angolo in basso a destra.

Una volta aggiunto, il commento viene visualizzato nella scheda Commenti del profiler dei campi ed è visibile agli altri utenti.

Visualizzazione dei commenti dei campi

Quando un campo include commenti, viene visualizzata un'icona a forma di blocco note con il numero di commenti presenti nel campo. Fai clic sull'icona del blocco note per visualizzare i commenti del campo elencati nella scheda Commenti del profiler dei campi.

Il numero di commenti in questo campo è indicato anche tra parentesi nella scheda Commenti. Ogni voce del commento mostra le seguenti informazioni:

• Il nome del commentatore
• Il timestamp che indica quando è stato aggiunto il commento
• Un'anteprima del commento

Modificare o eliminare un commento del campo

Per modificare o eliminare i tuoi commenti dei campi:

1. Seleziona l'icona del blocco note del campo.
2. Nella scheda Commenti, individua il commento che vuoi modificare o eliminare e passaci il mouse sopra.
3. Fai clic sul menu con tre puntini e seleziona Modifica commento per modificare il commento o Elimina commento per eliminarlo. Se stai eliminando il commento, conferma la tua intenzione.
4. Se stai modificando il commento, seleziona Salva dopo aver apportato le modifiche.

Condividere un commento del campo

L'URL della scheda Commenti per ogni campo è univoco e può essere copiato e condiviso con altri utenti che hanno accesso al modello nel dizionario dei dati di Looker.

Utilizzo del profiler dei campi

Fai clic su una riga di un campo specifico per aprire un riquadro di profilazione del campo che mostra l'intero insieme di metadati del campo, le opzioni per visualizzare l'anteprima dei valori numerici delle dimensioni e i pulsanti per passare all'IDE di Looker o alla pagina Esplora.

Se utilizzi la versione 2.0.0 o successiva dell'estensione del dizionario dei dati di Looker, per impostazione predefinita il profiler dei campi si apre nella scheda Dettagli.

Nella sezione Distribuzione, seleziona Calcola per visualizzare un'anteprima di un grafico a colonne che mostra la distribuzione dei valori di conteggio per le dimensioni numeriche in una visualizzazione con una misura che ha type: count. La sezione Distribuzione mostra anche i valori minimo, massimo e medio della serie di dimensioni numeriche.

In Valori, seleziona Calcola per visualizzare un'anteprima dei valori di conteggio per le dimensioni numeriche in una visualizzazione con una misura che ha type: count. Seleziona il pulsante Scopri di più per aprire l'interfaccia utente di Esplora con la dimensione numerica e la misura del conteggio preselezionate dal selettore dei campi.

Seleziona Vai a LookML per aprire il file della visualizzazione dal progetto LookML associato al modello selezionato nell'IDE di Looker.

Seleziona il pulsante Esplora con campo per aprire la pagina Esplora con il campo selezionato automaticamente dal selettore dei campi.