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_core
  • mde_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_HOST con il nome host dell'istanza di Looker.
  • DASHBOARD_ID con l'ID della dashboard che vuoi aprire. Puoi cercare l'ID della dashboard aprendo il file .dashboard pertinente nella directory imported_projects/mde_lookml_lib/mde_packages/default/dashboards/ e copiando il valore della proprietà dashboard.