Il dizionario dei dati di Looker è diverso dal blocco del dizionario dei dati.
Per usufruire della funzionalità completa dell'estensione Dizionario dati di Looker, gli amministratori devono aggiornare l'applicazione Dizionario dati di Looker alla versione 2.0.0 o successive.
Il dizionario dei dati di Looker è un'estensione, un'applicazione web creata utilizzando i componenti di Looker, sviluppata utilizzando il framework di estensione di Looker e di cui è stato eseguito il deployment tramite Looker Marketplace.
L'estensione Dizionario dati di Looker fornisce un'interfaccia dedicata e centralizzata per la ricerca in tutti i campi e nelle descrizioni di Looker. Utilizza questa estensione per eseguire le seguenti attività: * Offri agli utenti una directory consultabile per tutte le metriche e le descrizioni al fine di identificare la dimensione o la misura appropriate 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 ci sono campi ridondanti o se i campi sono annotati con descrizioni. * Aggiungere e condividere commenti su campi specifici (se l'applicazione Looker Data Dictionary è installata sulla versione 2.0.0 o successive).
Per consentire agli utenti di accedere al dizionario dei dati di Looker e di utilizzarlo, gli amministratori di Looker devono eseguire questi passaggi:
- Attiva le funzionalità appropriate.
- Installa l'estensione Dizionario dati di Looker.
- Concedi le autorizzazioni per accedere al dizionario dei dati di Looker.
Quando l'estensione è disponibile per gli utenti:
Installazione del dizionario dei dati di Looker
Prima di installare il dizionario dei dati di Looker da Marketplace, gli amministratori di Looker devono abilitare le seguenti funzionalità:
- Marketplace: per accedere a Looker Marketplace (abilitato per impostazione predefinita)
- Framework dell'estensione: per eseguire il deployment delle estensioni sviluppate utilizzando il framework di estensioni di Looker (attivato per impostazione predefinita)
Per installare applicazioni e strumenti da Marketplace, ad esempio le estensioni, devi 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 disporre sempre della versione più aggiornata del dizionario dei dati, accedi a Looker Marketplace, seleziona Gestisci e poi il pulsante Aggiorna accanto all'estensione.
Concessione delle autorizzazioni per accedere al dizionario dei dati di 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 del pannello Amministrazione.
Gli amministratori di Looker devono concedere agli utenti explore o develop le autorizzazioni per accedere al modello data-dictionary e ai 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 Impostazione delle autorizzazioni per le estensioni Looker.
Concedere le autorizzazioni per interagire con i commenti dei campi
I commenti dei campi offrono agli utenti la possibilità di aggiungere contesto alle definizioni dei campi senza dover aggiornare il codice LookML. Per impostazione predefinita, tutti gli utenti che hanno accesso all'estensione dizionario dei 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à di commento dei campi creando gruppi di utenti specifici nella pagina Gruppi del riquadro Amministrazione e assegnando gli utenti a questi gruppi. Per ulteriori informazioni su come assegnare utenti ai gruppi, consulta la pagina della documentazione Gruppi.
I gruppi utenti devono essere creati con i nomi predefiniti visualizzati nella colonna Nome gruppo della tabella seguente. La tabella mostra anche i privilegi predefiniti assegnati agli utenti assegnati a ciascun gruppo.
Se un utente non appartiene a nessuno di questi gruppi, per impostazione predefinita verrà usato writer. Se un utente è 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, che vengono apportate tramite la pagina Gruppi del riquadro Amministrazione avranno effetto dopo un aggiornamento forzato della pagina Dizionario dati o dopo che l'utente ha selezionato un'altra opzione e poi torna alla pagina Dizionario dati.
Accedere al dizionario dei dati di Looker
Puoi accedere al dizionario dei dati dall'elenco delle applicazioni e delle estensioni installate nella barra laterale a sinistra.
Visualizzazione dei metadati del modello con il dizionario dei dati di Looker
Nel dizionario dei dati di Looker, gli utenti con autorizzazioni explore su un modello possono selezionare questo modello e visualizzarne i metadati, tra cui le relative 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 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 le seguenti informazioni:
- Il nome del modello selezionato
- L'elenco delle esplorazioni contenute nel modello selezionato
- L'esplorazione selezionata
- Un campo di testo per filtrare i campi di un'esplorazione
- Filtri rapidi per restringere i campi visualizzati in base alle caratteristiche selezionate
- Il nome della vista
- Metadati relativi a ciascun campo. Seleziona i metadati da visualizzare selezionando il pulsante Visualizza opzioni. Visualizza l'intero insieme di metadati del campo in field profiler.
- Righe contenenti metadati per ogni campo in una determinata vista
- Navigazione all'esplorazione nell'UI di Looker
Selezionare un modello e un'esplorazione
Il menu 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 delle esplorazioni del modello.
Puoi anche cercare un'esplorazione specifica nel modello selezionato digitando nella casella di ricerca Cerca modello. L'elenco delle esplorazioni filtra per mostrare solo i risultati corrispondenti ai termini di ricerca.
Seleziona il nome di un'esplorazione per visualizzarne i 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 di questa esplorazione per confrontarli con l'elenco dei campi. Etichetta campo o Descrizione.
Puoi anche selezionare attributi dei metadati specifici in base ai quali applicare il filtro, ad esempio se il campo:
- Ha una descrizione
- È una dimensione o una misura
- Contiene tag
- Ha il tipo string, number, date, CAP, count, sum, media, list o senza virgolette
Visualizzazione dei metadati dei campi
Il dizionario dei dati di Looker visualizza i metadati per i campi di un'esplorazione, raggruppati per vista:
- Etichetta campo: il nome del campo in base al parametro
labeldel campo. - Categoria: la categoria del campo come dimensione o misura.
- Descrizione: la descrizione del campo in base al parametro
descriptiondel campo - Nome LookML: il nome del campo nella sintassi
view_name.field_name - Tipo: il tipo di campo come string, number, date, codice postale, conteggio, somma, media, elenco o senza virgolette in base al parametro
typedel campo - SQL: l'espressione SQL che fa riferimento a quel campo
- Tag: i tag LookML associati a quel campo
Personalizzazione dei metadati visualizzati
Puoi specificare quali metadati devono essere visualizzati per ogni campo selezionando il pulsante Opzioni di visualizzazione nell'angolo in alto a destra e selezionando o deselezionando le caselle relative ai metadati che vuoi visualizzare.
Utilizzo dei commenti dei campi
Se un'istanza ha già Marketplace, per utilizzare i commenti a livello di campo, gli amministratori devono verificare che l'estensione Data Dictionary sia nella versione 2.0.0 o successive.
Gli sviluppatori LookML spesso includono spiegazioni o informazioni 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 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 Amministrazione. Per impostazione predefinita, tutti gli utenti con accesso all'estensione dizionario dei dati possono visualizzare tutti i commenti e aggiungere, modificare ed eliminare i propri commenti.
Aggiunta di un commento a un campo
Per aggiungere un commento a un campo:
- Passa il mouse sopra la riga del campo per visualizzare l'icona + (se non sono presenti commenti dei campi) o un'icona del blocco note (se per un campo esistono commenti esistenti). Fai clic sull'icona per aprire la scheda Commenti del riquadro profiler del campo.
- Fai clic sul pulsante Aggiungi commento.
- Digita il commento e seleziona il pulsante Commenta per salvare il contenuto. Fai clic su Cancel (Annulla) per chiudere il profiler di campo. Puoi espandere la casella del commento 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.
Visualizzare i commenti dei campi
Quando un campo include commenti, viene visualizzata un'icona a forma di blocco note con 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 di campi.
Il numero di commenti su quel campo è indicato anche tra parentesi nella scheda Commenti. Ogni voce di commento mostra le seguenti informazioni:
- Il nome dell'autore del commento
- Timestamp che mostra quando è stato aggiunto il commento
- Un'anteprima del commento
Modificare o eliminare un commento a un campo
Per modificare o eliminare i commenti dei tuoi campi:
- Seleziona l'icona del blocco note del campo.
- Nella scheda Commenti, individua e passa il mouse sopra il commento che vuoi modificare o eliminare.
- Fai clic sul menu con tre puntini e seleziona Modifica commento per modificare il commento o Elimina commento per eliminare il commento. Se stai eliminando il commento, conferma le tue intenzioni.
- Se stai modificando un commento, seleziona Salva dopo aver apportato le modifiche.
Condivisione di un commento in un campo
L'URL della scheda Commenti per ogni campo è univoco e può essere copiato e condiviso con altri utenti che hanno accesso a quel modello nel dizionario dei dati di Looker.
Utilizzo del profiler di campo
Fai clic su una riga di campo specifica per aprire un riquadro del profiler dei campi che visualizza l'intero insieme di metadati del campo, le opzioni per visualizzare l'anteprima dei valori numerici della dimensione e i pulsanti per accedere all'IDE di Looker o alla pagina Esplora.
Se utilizzi la versione 2.0.0 o successiva dell'estensione Dizionario dati di Looker, per impostazione predefinita il profiler di campi si apre nella scheda Dettagli.
Nella sezione Distribuzione, seleziona Calcola per visualizzare l'anteprima di un grafico a colonne che mostra la distribuzione dei valori di conteggio per le dimensioni numeriche in una vista 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 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 di conteggio preselezionate dal selettore campi.
Seleziona Vai a LookML per aprire il file della vista del 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.