Utilizzo del dizionario dati Looker

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

Per sfruttare la funzionalità completa dell'estensione Looker Data Dictionary, gli amministratori devono aggiornare l'applicazione Looker Data Dictionary alla versione 2.0.0 o successive.

Looker Data Dictionary è un'estensione, ovvero un'applicazione web creata utilizzando componenti Looker, sviluppata utilizzando il framework di estensione Looker e di cui è stato eseguito il deployment 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 che consente agli utenti di identificare la dimensione o la misura appropriata per l'analisi
• Consentire 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
• Aggiungere e condividere commenti su campi specifici (se l'applicazione Looker Data Dictionary è nella versione 2.0.0 o successive)

Per consentire agli utenti di accedere e utilizzare il dizionario dei dati di Looker, 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.

Quando l'estensione sarà disponibile per gli utenti, potrai:

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

Installazione del dizionario dei dati Looker

Prima di installare il dizionario dei dati di Looker da Marketplace, gli amministratori di Looker devono attivare le seguenti funzionalità:

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

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

Consulta la documentazione sull'utilizzo di Looker Marketplace per le istruzioni sull'installazione di uno strumento da Looker Marketplace. Per assicurarti di avere sempre la versione più aggiornata del dizionario dei dati, vai a Looker Marketplace e seleziona Gestisci, quindi il pulsante Aggiorna accanto all'estensione.

Concessione delle autorizzazioni per accedere al dizionario dei dati Looker

Una volta installato il dizionario dei 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 da esplorare nel dizionario dei dati. Consulta la pagina della documentazione Impostare le autorizzazioni per le estensioni di Looker per informazioni su come concedere agli utenti le autorizzazioni per accedere e utilizzare le estensioni.

Concessione delle autorizzazioni per interagire con i commenti del campo

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

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

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

I gruppi utenti devono essere creati con i nomi predefiniti riportati nella tabella seguente. La tabella mostra anche i privilegi predefiniti di cui avranno accesso gli utenti assegnati 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à dei commenti sono disattivate. I privilegi di questo gruppo hanno sempre la precedenza su quelli degli altri gruppi: qualsiasi utente incluso nel gruppo disabled non avrà accesso alla funzionalità per i commenti, anche se appartiene anche a un altro gruppo con privilegi più elevati.
marketplace_data_dictionary_comments_reader	L'utente può visualizzare i commenti esistenti, ma non può aggiungerne.
marketplace_data_dictionary_comments_writer	Gli utenti possono visualizzare 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 modificare/eliminare tutti i commenti.

Se un utente non appartiene a nessuno di questi gruppi, per impostazione predefinita sarà writer. Se un utente viene assegnato a più gruppi (escluso marketplace_data_dictionary_comments_disabled), i privilegi più elevati hanno la precedenza.

Le modifiche a un gruppo di commenti, ad esempio l'aggiunta o la rimozione di un utente, effettuate tramite la pagina Gruppi nel riquadro Amministrazione vengono applicate dopo un aggiornamento forzato della pagina Dizionario dati o dopo che l'utente seleziona un'altra opzione e poi torna alla pagina Dizionario dati.

Accesso al dizionario dei 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 dei dati di Looker

Nel dizionario dei dati di Looker, gli utenti con autorizzazioni explore per un modello possono selezionare questo model e visualizzarne i metadati, incluse le esplorazioni e l'elenco di campi di ogni esplorazione, raggruppati per vista. Il dizionario dei dati di Looker visualizza le esplorazioni del modello selezionato nella barra laterale di sinistra e le visualizzazioni 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:

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 su ogni campo. Per selezionare i metadati da visualizzare, seleziona il pulsante Opzioni di visualizzazione. Visualizzare l'intero set di metadati del campo in field profiler.
8. Righe contenenti metadati per ogni campo di una determinata vista
9. Navigazione all'esplorazione nell'interfaccia utente di Looker

Selezionare un modello e un'esplorazione

Nel menu a discesa Seleziona un modello sono elencati tutti i modelli per cui un utente dispone delle autorizzazioni explore. Quando scegli un modello dal menu a discesa Seleziona un modello, nella barra laterale di sinistra viene visualizzato un elenco delle esplorazioni del modello.

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

Seleziona il nome di un'esplorazione per visualizzarne i campi, raggruppati per visualizzazione, mostrati 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 il testo nella casella Filtra i campi in questa esplorazione per creare una corrispondenza con l'Etichetta campo o la Descrizione dell'elenco di campi.

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

• Contiene una descrizione
• È una dimensione o una misura
• Contiene tag
• Contiene tipo string, number, date, zipcode, count, somma, media, elenco o senza virgolette

Visualizzazione dei metadati dei campi

Il dizionario dei dati di Looker visualizza 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 di 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, ad esempio string, number, date, zipcode, count, 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.

Personalizzazione dei metadati visualizzati

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

Utilizzo dei commenti dei campi

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

Gli sviluppatori LookML spesso includono 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 visualizzabili da altri utenti, ma non influiscono sul valore 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 pannello Amministratore. 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 del campo

Per aggiungere un commento a un campo:

1. Passa il mouse sopra la riga del campo per visualizzare un'icona + (se non ci sono commenti per il campo) o un'icona a forma di blocco note (se un campo contiene già commenti). Fai clic sull'icona per aprire la scheda Commenti del riquadro Profiler dei campi.
2. Fai clic sul pulsante Aggiungi commento.
3. Digita il commento e seleziona il pulsante Commenta per salvare il commento. Fai clic su Annulla per chiudere il profiler 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 del campo 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 esistenti nel campo. Fai clic sull'icona del blocco note per visualizzare i commenti del campo elencati nella scheda Commenti del profiler campo.

Il numero di commenti per quel campo viene 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 il momento in cui è 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 e passa il mouse sopra il commento che vuoi 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 vuoi eliminare il commento, conferma l'intenzione.
4. Se modifichi il commento, seleziona Salva dopo aver apportato le modifiche.

Condividere un commento sul campo

L'URL della scheda Commenti di ogni campo è univoco e può essere copiato e condiviso con altri utenti che hanno accesso al modello in Looker Data Dictionary.

Utilizzare il profiler dei campi

Se fai clic su una riga di un campo specifico, a destra della pagina si aprirà un riquadro del profiler del campo che mostra l'intero set di metadati del campo, le opzioni per visualizzare l'anteprima dei valori delle dimensioni numerici e i pulsanti per accedere all'IDE di Looker o alla pagina Esplora.

Se utilizzi la versione 2.0.0 o versioni successive dell'estensione Looker Data Dictionary, 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 dei conteggi per le dimensioni numeriche in una vista con una misura con type: count. La sezione Distribuzione mostra anche i valori minimo, massimo e medio delle serie di dimensioni numeriche.

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

Seleziona Vai a LookML per aprire il file di 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 campi.