Utilizzo di Looker Data Dictionary

Looker Data Dictionary è diverso dal Data Dictionary Block.

Per usufruire della funzionalità completa dell'estensione Looker Data Dictionary, gli amministratori devono aggiornare l'applicazione Looker Data Dictionary alla versione 2.0.0 o successiva.

Looker Data Dictionary è un'estensione, un'applicazione web creata utilizzando i componenti Looker, sviluppata mediante il framework delle estensioni Looker e distribuita tramite Looker Marketplace.

L'estensione Looker Data Dictionary fornisce un'interfaccia dedicata e centralizzata per la ricerca in tutti i campi e le descrizioni di Looker. Utilizza questa estensione per:

• Fornisci una directory disponibile per la ricerca per tutte le metriche e le descrizioni degli utenti al fine di identificare la dimensione o la misura appropriata per l'analisi
• Consentire alle parti interessate esterne di identificare e individuare facilmente metriche univoche
• Controlla i modelli LookML per valutare se vengono seguite convenzioni di denominazione coerenti, se ci sono campi ridondanti o se i campi sono annotati con descrizioni.
• Aggiungi e condividi commenti su campi specifici (se la tua applicazione Looker Data Dictionary è nella versione 2.0.0 o successiva)

Affinché gli utenti possano accedere al dizionario di dati e utilizzarlo, gli amministratori di Looker devono:

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

Una volta che l'estensione è disponibile per gli utenti, puoi:

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

Installazione di Looker Data Dictionary

Prima di installare Looker Data Dictionary dal Marketplace, gli amministratori di Looker devono abilitare le seguenti funzionalità:

• Marketplace: per accedere a Looker Marketplace (attivato per impostazione predefinita)
• Framework delle estensioni: per eseguire il deployment delle estensioni sviluppate con il framework dell'estensione Looker (attivazione per impostazione predefinita).

Per installare applicazioni e strumenti, come le estensioni, dal Marketplace, è necessario disporre delle autorizzazioni develop, manage_models e deploy.

Per istruzioni sull'installazione di uno strumento da Looker Marketplace, consulta la documentazione Utilizzo di Looker Marketplace. Per assicurarti di avere sempre la versione più aggiornata del Dizionario dati, vai a Looker Marketplace, seleziona Gestisci e seleziona il pulsante Aggiorna accanto all'estensione.

Concessione dell'accesso al Dizionario dati di Looker

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

Gli amministratori di Looker devono concedere agli utenti explore o develop autorizzazioni per accedere al modello data-dictionary e a qualsiasi modello da esplorare nel Dizionario dati. Per informazioni su come concedere agli utenti le autorizzazioni per accedere alle estensioni e utilizzarle, consulta la pagina della documentazione relativa all'impostazione delle autorizzazioni per le estensioni di Looker.

Concedere autorizzazioni per interagire con i commenti sul campo

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

Se vuoi, gli amministratori di Looker possono gestire il modo in cui gli utenti interagiscono con la funzionalità di commento sul campo, creando gruppi di utenti specifici nella pagina Gruppi del riquadro Amministratore 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.

Gli amministratori di Looker devono creare questi gruppi con i nomi predefiniti, come mostrato di seguito.

I gruppi di utenti devono essere creati con i nomi predefiniti mostrati nella seguente tabella. La tabella mostra anche i privilegi predefiniti che gli utenti hanno assegnato a ciascun gruppo.

Nome gruppo	Privilegi
marketplace_data_dictionary_comments_disabled	Gli utenti non possono vedere o interagire in altro modo con i commenti; tutte le funzionalità di commento 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 alle funzionalità dei commenti, anche se appartengono a un altro gruppo con privilegi più elevati.
marketplace_data_dictionary_comments_reader	L'utente può visualizzare i commenti esistenti, ma non può aggiungerne altri.
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 vedere tutti i commenti, aggiungerne di nuovi e modificare/eliminare tutti i commenti.

Se un utente non appartiene a nessuno di questi gruppi, l'impostazione predefinita sarà writer. Se un utente è assegnato a più gruppi (escluso marketplace_data_dictionary_comments_disabled), il suo privilegio più elevato ha la precedenza.

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

Accedere al dizionario dei dati di Looker

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

Visualizzare i metadati del modello con Looker Data Dictionary

Nel Looker Data Dictionary, gli utenti con autorizzazioni explore su un modello possono selezionare questo modello e visualizzarne i metadati, incluse le Esplorazioni e l'elenco dei campi di ogni esplorazione, raggruppati per view. Looker Data Dictionary visualizza le esplorazioni del modello selezionato nella barra laterale a sinistra e le visualizzazioni e i campi di Explore selezionati nella parte principale della pagina.

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

Dizionario dati Looker mostra:

1. Il nome del modello selezionato
2. L'elenco di 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 vista
7. I metadati relativi a ciascun campo. Seleziona i metadati da visualizzare selezionando il pulsante Visualizza opzioni. Visualizza l'intero set di metadati del campo nel profiler del campo.
8. Righe contenenti metadati per ogni campo in una determinata vista
9. Navigazione nell'interfaccia di Looker nell'interfaccia utente

Selezione di un modello ed 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, la barra laterale sinistra verrà compilata con un elenco di esplorazioni di quel modello.

Puoi anche cercare un modello specifico di Explore nella casella di ricerca di Search Model. 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 visualizzarne i campi, raggruppati per visualizzazione, visualizzati 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.

Campi filtro in Esplora

Puoi filtrare i campi visualizzati digitando il testo nella casella Filtra i campi di questa esplorazione per creare una corrispondenza con l'etichetta del campo o la descrizione dei campi.

Puoi anche selezionare attributi di metadati specifici su cui filtrare, ad esempio se il campo:

• Ha una descrizione.
• È una dimensione o una misura
• Ha tag
• Ha il tipo string, number, date, zipcode, count, sum, average, list o unquoted

Visualizzazione dei metadati dei campi

Dizionario dati di Looker visualizza i metadati dei campi Explore (Esplora), raggruppati in base alla vista:

• 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, sum, media, elenco o senza virgolette in base al parametro type del campo
• SQL: l'espressione SQL che fa riferimento a questo campo.
• Tag: i tag LookML associati a questo campo

Personalizzazione dei metadati visualizzati

Puoi specificare i metadati da visualizzare per ogni campo selezionando il pulsante Visualizza opzioni nell'angolo in alto a destra e selezionando o deselezionando le caselle corrispondenti ai metadati che vuoi visualizzare.

Utilizzare i commenti sul campo

Se un'istanza ha già Marketplace, gli amministratori devono garantire che l'estensione Data Dictionary sia in versione 2.0.0 o successiva per utilizzare i commenti a livello di campo.

Gli sviluppatori LookML spesso includono informazioni aggiuntive o spiegazioni 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. Grazie ai commenti a livello di campo, gli utenti possono aggiungere contesto a un campo specifico. Questi commenti sono visualizzabili da altri utenti, ma non influiscono sul 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 Dizionario dati possono visualizzare tutti i commenti e aggiungere, modificare ed eliminare i propri commenti.

Aggiungere un commento sul campo

Per aggiungere un commento a un campo:

1. Passa il mouse sopra la riga di un campo per visualizzare l'icona + (se non sono presenti commenti sul campo) o l'icona del blocco note (se un campo contiene già commenti). Fai clic sull'icona per aprire la scheda Commenti del riquadro profiler del campo.
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 il profiler del campo. Puoi espandere la casella dei commenti selezionando e trascinando l'angolo in basso a destra.

Una volta aggiunto, un commento viene visualizzato nella scheda Commenti del profiler del campo ed è visibile per altri utenti.

Visualizzazione dei commenti sul campo

Quando un campo include dei commenti, viene visualizzata un'icona del blocco note che indica il numero di commenti presenti in quel campo. Fai clic sull'icona del blocco note per visualizzare i commenti del campo elencati nella scheda Commenti del profiler del campo.

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

• Il nome dell'autore del commento
• Il timestamp che mostra quando è stato aggiunto il commento
• Anteprima del commento

Modificare o eliminare un commento su un campo

Per modificare o eliminare i tuoi commenti sul campo:

1. Seleziona l'icona del blocco note del campo.
2. Nella scheda Commenti, individua e passa il mouse sopra il commento da modificare o eliminare.
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.

Condivisione di un commento sul campo

L'URL della scheda Commenti per ciascun campo è univoco e può essere copiato e condiviso con altri utenti che hanno accesso a quel modello nel Looker Data Dictionary.

Utilizzo di Profiler campo

Se fai clic su una riga specifica di un campo, a destra della pagina si aprirà un riquadro di Profiler del campo che mostra l'intero set di metadati del campo, le opzioni di anteprima dei valori numerici della dimensione e i pulsanti per andare alla pagina IDE di Looker o Esplora.

Se utilizzi la versione 2.0.0 o una versione successiva dell'estensione Looker Data Dictionary, per impostazione predefinita la profilazione dei campi si apre nella scheda Dettagli.

Nella sezione Distribuzione, seleziona Calcola per mostrare un'anteprima di un grafico a colonne che mostra la distribuzione dei valori del conteggio per le dimensioni numeriche su una visualizzazione con type: count. Nella sezione Distribuzione vengono visualizzati anche i valori minimo, massimo e medio della serie di dimensioni numeriche.

In Valori, seleziona Calcola per mostrare un'anteprima dei valori di conteggio per le dimensioni numeriche su una vista con una misura che comprende type: count. Seleziona il pulsante Esplora altro per aprire l'interfaccia utente di Esplora con la dimensione numerica e la misurazione del conteggio preselezionate dal selettore campi.

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

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