LookML-Bibliothek verwenden

Die LookML-Bibliothek für MDE enthält abstrakte Core-Dateien sowie verpackte Ansichten, Explores und Dashboards, die Ihnen den Einstieg in die Erstellung eigener LookML-Modelle auf Basis der MDE-Daten in BigQuery erleichtern.

Hinweise

Für diese Anleitung sind die folgenden Voraussetzungen erforderlich:

  • Sie haben ein neues Looker-Projekt mit der MDE-Projektvorlage konfiguriert, wie im Einrichtungsleitfaden beschrieben.
  • Sie haben eine aktive MDE-Bereitstellung.
  • Optional: Sie haben das Standard-MDE-Konfigurationspaket angewendet. Sie können zwar die MDE LookML Library verwenden, um benutzerdefinierte Ansichten zu erstellen, für das Standard-LookML-Paket muss jedoch das Standard-MDE-Konfigurationspaket angewendet werden.

Bibliotheksinhalte ansehen

Nachdem das Projekt zugelassen wurde, können Sie den Inhalt der Bibliothek im Verzeichnis imported_projects/mde_lookml_lib in der Looker-Entwicklerkonsole ansehen. Die Bibliothek stellt Inhalte in zwei Verzeichnissen bereit:

  • mde_abstract_core
  • mde_packages

Abstraktes Kernverzeichnis

Das Verzeichnis mde_abstract_core enthält Basisansichten, mit denen Sie MDE-Metadaten-Buckets als Dimensionen und MDE-Datensatztabellen als Faktentabellen in Looker modellieren können. Durch die Verwendung von Basisansichten müssen Sie die gemeinsamen Felder nicht für jede dieser Ansichten definieren.

Die Bibliothek bietet eine dim_base.view-Ansicht zum Erstellen von Dimensionen, die Sie unter imported_projects/mde_lookml_lib/mde_abstract_core/views/dimension/dim_base.view.lkml finden. Im folgenden Beispiel wird gezeigt, wie Sie die Basisansicht erweitern können, um eine Dimension mit dem Namen device zu definieren:


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") ;;
   }

}

Ebenso bietet die Bibliothek Basisansichten pro MDE-Archetyp, um Datensatztabellen in BigQuery als Faktentabellen zu modellieren. Die Basisansichten finden Sie unter imported_projects/mde_lookml_lib/mde_abstract_core/views/fact/. Sie können die Archetyp-Basisansichten erweitern, um benutzerdefinierte Faktenansichten in Looker zu definieren. Im folgenden Beispiel wird gezeigt, wie Sie eine Faktenansicht mit dem Namen sensor_readings definieren können:


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` ;;
}

Pakete

Das Verzeichnis mde_packages enthält vorgefertigte LookML-Pakete für MDE. Diese Pakete enthalten anwendungsfallspezifische Explores, Ansichten und Dashboards, damit Sie schnell loslegen können.

Das default-Looker-Konfigurationspaket funktioniert in Verbindung mit dem default-MDE-Konfigurationspaket. Weitere Informationen finden Sie im Leitfaden für das Standardkonfigurationspaket. Das Standardkonfigurationspaket für Looker enthält eine Faktentabelle pro Datensatz-Tabelle, die mit einem MDE-Typ verknüpft ist, sowie Tag- und Quelldimensionen, die den Tag- und Quellmetadaten-Buckets in MDE entsprechen.

Wenn Sie die MDE-Projektvorlage verwendet haben, um ein neues MDE-Projekt zu bootstrappen, werden die Ansichten und Explores aus dem Standardpaket automatisch in das bereitgestellte Looker-Modell importiert:

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"

Sobald Ihr Projekt eingerichtet ist, können Sie die Standard-Explores in Looker verwenden, um Daten zu analysieren.

Sie können auch andere Konfigurationspakete verwenden, die in der Bibliothek enthalten sind. Weitere Informationen und Voraussetzungen für die Verwendung dieser Pakete in der Bibliothek finden Sie im folgenden Abschnitt.

Ansichten erweitern, die von den Konfigurationspaketen in der Bibliothek bereitgestellt werden

Sie können die in der Bibliothek enthaltenen Fakten- und Dimensionsansichten mit der Syntax extends erweitern. In der Projektmodelldatei können Sie beispielsweise dim_tag erweitern, indem Sie zusätzliche Dimensionsfelder für das Objekt „deviceMetadata“ definieren, wie im folgenden Skript gezeigt:

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") ;;
}
}

Der Zugriff auf Dashboards wird im Standardkonfigurationspaket definiert.

Das im MDE-Projektvorlage definierte LookML-Modell importiert alle Dashboards aus dem Standardpaket in der MDE LookML-Bibliothek. Klicken Sie auf den folgenden Link, um auf eines dieser Dashboards zuzugreifen:

https://LOOK_HOST/dashboards/mde::DASHBOARD_ID

Ersetzen Sie Folgendes:

  • Ersetzen Sie LOOK_HOST durch den Hostnamen Ihrer Looker-Instanz.
  • Ersetzen Sie DASHBOARD_ID durch die ID des Dashboards, das Sie öffnen möchten. Sie können die Dashboard-ID ermitteln, indem Sie die entsprechende .dashboard-Datei im Verzeichnis imported_projects/mde_lookml_lib/mde_packages/default/dashboards/ öffnen und den Wert der Eigenschaft dashboard kopieren.