Modellparameter

In einer Modelldatei wird eine Datenbankverbindung angegeben, die Gruppe von Explores definiert, die diese Verbindung verwenden, und die Beziehungen der Explores zu anderen Ansichten definiert. Anders als bei anderen LookML-Elementen wird ein Modell nicht mit einem bestimmten „model“-Parameter deklariert. Stattdessen definiert ein LookML-Entwickler ein Modell, indem er eine LookML-Projektdatei mit der Dateiendung .model.lkml erstellt. Der Modellname wird aus dem Dateinamen übernommen.

Ein Modellname muss in allen Projekten in Ihrer Instanz eindeutig sein. Wenn Ihre Instanz zwei .model.lkml-Dateien mit demselben Namen enthält, treten wahrscheinlich Fehler auf, z. B. Modellkonfigurationsfehler auf der Seite LookML-Projekte und Rendering-Fehler für LookML-Dashboard-Fehler, da LookML-Dashboards den Modellnamen in ihrem URL-Format (<hostname>/dashboard/model_name::<dashboard_name>) verwenden.

Mit dem LookML-Validator können Sie prüfen, ob Modellnamen in Ihrer Instanz doppelt vorhanden sind. Auch wenn der LookML-Validator doppelte Modellnamen in Ihrer Instanz erkennt, können Sie Ihren Code in die Produktion übertragen. Beheben Sie daher alle Fehler mit doppelten Modellnamen, bevor Sie Ihr LookML-Projekt in der Produktionsumgebung bereitstellen.

Eine Modelldatei enthält in der Regel alle explore-Deklarationen sowie eine Reihe von Einstellungen auf Modellebene.

Auf dieser Seite finden Sie Links zu den LookML-Parametern auf Modellebene. Sie werden in der Regel oben in die Modelldatei geschrieben und dürfen nicht in andere Parameter eingebettet werden.

Nutzungsbeispiel

Bewegen Sie den Mauszeiger auf einen Parameternamen, um eine Kurzbeschreibung aufzurufen. Klicken Sie auf einen Parameter, um die zugehörige Referenzseite aufzurufen. Wenn ein Parameter auf eine von mehreren bestimmten Optionen festgelegt werden kann, wird der Standardwert zuerst aufgeführt.

## STRUCTURAL PARAMETERS
include:"filename_or_pattern"
## Possibly more include declarations

explore: explore_name {
  # Desired explore parameters (described on Explore Parameters page)
}
## Possibly more explore declarations

access_grant: access_grant_name{
  user_attribute: user_attribute_name
  allowed_values: ["value_1", "value_2", ...]
}
## Possibly more access_grant declarations

test: test_name{
  explore_source: explore_name {
    # Desired subparameters (described on test page)
  }
  assert: assert_statement {
    expression:Looker expression ;;
  }
  # Possibly more assert declarations
}
## Possibly more test declarations

## DISPLAY PARAMETERS
label: "desired label"

## FILTER PARAMETERS
case_sensitive: yes | no

## QUERY PARAMETERS
connection: "connection_name"
datagroup: datagroup_name{
  label: "desired label"
  description: "desired description"
  max_cache_age: "N (minutes | hours | days)"
  sql_trigger: SQL query ;;
}
## Possibly more datagroup declarations
fiscal_month_offset: N
persist_for: "N (seconds | minutes | hours)"
persist_with: datagroup_name
week_start_day: monday | tuesday | wednesday | thursday | friday | saturday | sunday

## VISUALIZATION AND FORMATTING PARAMETERS
map_layer: map_name{
  extents_json_url: "URL to JSON extents file"
  feature_key: "Name of TopoJSON object"
  file: "TopoJSON or GeoJSON filename" # or use the url subparameter
  format: topojson | vector_tile_region
  label: "desired label"
  max_zoom_level: number indicating max zoom
  min_zoom_level: number indicating min zoom
  projection: Preferred geographic projection
  property_key: "TopoJSON property"
  property_label_key: "Label for TopoJSON property"
  url: "URL that contains map file" # or use the file subparameter
}
## Possibly more map layer declarations

named_value_format: desired_name {
  value_format: "excel formatting string"
  strict_value_format: yes | no
 }
## Possibly more named value format declarations

Parameterdefinitionen

Parametername	Beschreibung
Strukturparameter
access_grant	Erstellt ein Zugriffsrecht, das den Zugriff auf LookML-Strukturen auf Nutzer beschränkt, denen ein genehmigter Benutzerattributwert zugewiesen ist. Dieser Parameter enthält die Unterparameter user_attribute und allowed_values.
explore	Zeigt eine Ansicht im Menü „Explore“ an. Weitere Informationen zu Explores und den zugehörigen Parametern finden Sie auf der Seite Referenz zu Explore-Parametern.
include	Fügt einem Modell Dateien hinzu
test	Erstellt einen Datentest zur Prüfung der Logik Ihres Modells. Die Projekteinstellungen enthalten eine Option zum Erfordern von Datentests. Wenn diese Option für ein Projekt aktiviert ist, müssen Entwickler für das Projekt Datentests durchführen, bevor sie ihre Änderungen in der Produktion implementieren. Dieser Parameter enthält die Unterparameter explore_source und assert.
Parameter für die Anzeige
label (für Modell)	Ändert die Darstellung eines Modells im Menü „Explore“.
Filterparameter
case_sensitive (für Modell)	Gibt an, ob bei Filtern für ein Modell zwischen Groß- und Kleinschreibung unterschieden werden soll
Suchparameter
connection	Ändert die Datenbankverbindung für ein Modell
datagroup	Erstellt eine Cache-Richtlinie für Datengruppen für ein Modell. Dieser Parameter hat die Unterparameter label, description, max_cache_age und sql_trigger.
fiscal_month_offset	Gibt den Monat an, in dem Ihr Geschäftsjahr beginnt (falls es vom Kalenderjahr abweicht)
persist_for (für Modell)	Ändert die Cache-Einstellungen für ein Modell
persist_with (für Modell)	Gibt die Datengruppe an, die für die Cache-Richtlinie des Modells verwendet werden soll.
week_start_day	Gibt den Wochentag an, an dem wochenbezogene Dimensionen beginnen sollen
Parameter für Visualisierung und Formatierung
map_layer (für Modell)	Erstellt benutzerdefinierte Karten für die Verwendung mit map_layer_name
named_value_format	Erstellt ein benutzerdefiniertes Werteformat, das für value_format_name verwendet werden soll. Dieser Parameter enthält die Unterparameter value_format und strict_value_format.
Unzulässige Parameter
scoping	Entfernt – Version 3.52 Nicht mehr erforderlich
template	Entfernt am 30.03. Nicht mehr erforderlich