Utilizzare la libreria LookML
La libreria LookML per MDE fornisce file core astratti e viste, esplorazioni e dashboard in pacchetto per aiutarti a iniziare a creare i tuoi modelli LookML in base ai dati MDE in BigQuery.
Prima di iniziare
Per completare questa guida, devi soddisfare i seguenti prerequisiti:
- Hai configurato un nuovo progetto Looker utilizzando il modello di progetto MDE come descritto nella guida alla configurazione.
- Hai un deployment di MDE attivo.
- (Facoltativo) Hai applicato il pacchetto di configurazione MDE predefinito. Sebbene tu possa utilizzare la libreria LookML MDE per creare viste personalizzate, il pacchetto LookML predefinito richiede l'applicazione del pacchetto di configurazione MDE predefinito.
Esplorare i contenuti della raccolta
Una volta consentito il progetto, puoi esplorare i contenuti della libreria
nella directory imported_projects/mde_lookml_lib della
console di sviluppo di Looker. La libreria fornisce contenuti in
due directory:
mde_abstract_coremde_packages
Directory principale astratta
La directory mde_abstract_core fornisce viste di base che puoi utilizzare per
modellare i bucket di metadati MDE come dimensioni e
le tabelle dei record MDE come tabelle dei fatti in Looker.
Le visualizzazioni di base ti evitano di dover definire i campi condivisi in queste visualizzazioni.
La libreria fornisce una visualizzazione dim_base.view per la creazione di dimensioni, che puoi trovare in imported_projects/mde_lookml_lib/mde_abstract_core/views/dimension/dim_base.view.lkml.
Il seguente esempio mostra come estendere la visualizzazione di base per definire una
dimensione denominata device:
include: "//mde_lookml_lib/mde_abstract_core/views/dimension/*.view"
view: dim_source {
derived_table: {
sql: SELECT * FROM `mde_dimension.metadata-store` where bucket_number = BUCKET_NUMBER ;;
}
view_label: "DIM - Device"
extends: [ dim_base ]
dimension: device_name {
type: string
sql: JSON_VALUE(${TABLE}.instance,"$.device_name") ;;
}
}
Allo stesso modo, la libreria fornisce viste di base per archetipo MDE per modellare le tabelle dei record in BigQuery come tabelle dei fatti. Puoi trovare le viste di base in
imported_projects/mde_lookml_lib/mde_abstract_core/views/fact/. Puoi estendere le viste di base dell'archetipo per definire viste dei fatti personalizzate in Looker. Il seguente esempio mostra come definire una visualizzazione
dei fatti denominata sensor_readings:
include: "//mde_lookml_lib/mde_abstract_core/views/fact/fct_numeric_archetype.view"
view: fct_sensor_readings {
extends: [ fct_numeric_archetype ]
label: "FCT - Sensor Readings"
sql_table_name: `mde_data.sensor-readings` ;;
}
Pacchetti
La directory mde_packages contiene pacchetti LookML predefiniti per
MDE. Questi pacchetti forniscono esplorazioni, visualizzazioni e dashboard specifiche per casi d'uso per iniziare rapidamente.
Il pacchetto di configurazione predefinito di Looker funziona in combinazione con il pacchetto di configurazione predefinito di MDE. Per saperne di più, consulta la guida al pacchetto di configurazione predefinito. Il pacchetto di configurazione Looker predefinito fornisce una tabella dei fatti per ogni tabella dei record collegata a un tipo di MDE, nonché dimensioni di tag e origine, che corrispondono rispettivamente ai bucket di metadati di tag e origine in MDE.
Se hai utilizzato il modello di progetto MDE per bootstrap un nuovo progetto MDE, il modello Looker fornito importa automaticamente le viste e gli esplora dal pacchetto predefinito:
connection: "@{looker_connection}"
########## DEFAULT MDE EXPLORES ##########
include: "//mde_lookml_lib/mde_packages/default/explores/default.explore.lkml"
############ CUSTOM VIEWS ################
include: "/views/dimension/*.view"
include: "/views/fact/*.view"
Una volta configurato il progetto, puoi utilizzare le esplorazioni predefinite in Looker per analizzare i dati.
Puoi anche utilizzare altri pacchetti di configurazione inclusi nella libreria. Per ulteriori istruzioni e prerequisiti per utilizzare questi pacchetti nella libreria, consulta la sezione seguente.
Estendere le visualizzazioni fornite dai pacchetti di configurazione nella raccolta
Puoi estendere le visualizzazioni di fatti e dimensioni incluse nella libreria utilizzando la sintassi
extends. Ad esempio, nel file del modello di progetto puoi estendere dim_tag definendo campi di dimensioni aggiuntivi nell'oggetto deviceMetadata, come mostrato nello script seguente:
view: +dim_tag {
dimension: device_type {
type: string
sql: JSON_VALUE(${TABLE}.instance,"$.deviceMetadata.deviceType") ;;
}
dimension: location {
type: string
sql: JSON_VALUE(${TABLE}.instance,"$.deviceMetadata.location") ;;
}
}
L'accesso ai dashboard è definito nel pacchetto di configurazione predefinito.
Il modello LookML definito nel modello di progetto MDE importa tutte le dashboard dal pacchetto predefinito nella libreria LookML MDE. Per accedere a una di queste dashboard, apri il seguente link:
https://LOOK_HOST/dashboards/mde::DASHBOARD_ID
Sostituisci quanto segue:
LOOK_HOSTcon il nome host dell'istanza di Looker.DASHBOARD_IDcon l'ID della dashboard che vuoi aprire. Puoi cercare l'ID della dashboard aprendo il file .dashboard pertinente nella directoryimported_projects/mde_lookml_lib/mde_packages/default/dashboards/e copiando il valore della proprietàdashboard.