Parameter für LookML-Dashboards zuordnen

Auf dieser Seite werden die Parameter zum Erstellen und Bearbeiten von LookML-Dashboard-Elementen vom Typ type: looker_map mit LookML-Dashboard-Parametern in einer dashboard.lkml-Datei beschrieben.

Informationen zum Erstellen eines interaktiven Kartendiagramms über die Looker-Benutzeroberfläche finden Sie auf der Dokumentationsseite Kartendiagrammoptionen. Informationen zu den Feldtypen, die zum Erstellen eines interaktiven Kartendiagramms erforderlich sind, finden Sie im Abschnitt Abfrageparameter.

Nutzungsbeispiel

Ein N gibt an, dass ein numerischer Wert erforderlich ist. Einfache Anführungszeichen kennzeichnen beschreibenden Text und sollten nicht in Live-Code enthalten sein.

## BASIC PARAMETERS
name: element_name
title: 'Element Title'
type: looker_map
height: N
width: N
top: N
left: N
row: N
col: N
refresh: N (seconds | minutes | hours | days)
note:
  text: 'note text'
  state: collapsed | expanded
  display: above | below | hover

## QUERY PARAMETERS
model: model_name
explore: explore_name
fields: [view_name.field_name, view_name.field_name, …]
dimensions: [view_name.field_name, view_name.field_name, …]
measures: [view_name.field_name, view_name.field_name, …]
sorts: [view_name.field_name asc | desc, view_name.field_name, …]
pivots: [view_name.field_name, view_name.field_name, …]
limit: N
column_limit: N
filters:
  view_name.field_name: 'looker filter expression'
listen:
  dashboard_filter_name: view_name.field_name
query_timezone: 'specific timezone' | user_timezone

## PLOT PARAMETERS
map_plot_mode: points | automagic_heatmap | lines | areas
heatmap_gridlines: true | false
heatmap_gridlines_empty: true | false
heatmap_opacity: 'number between 0 and 1'

## MAP PARAMETERS
map_tile_provider: light | light_no_labels | dark | dark_no_labels | satellite_streets |
                    satellite | streets | outdoors | traffic_day | traffic_night
map_position: fit_data | custom
map_latitude: 'latitude value'
map_longitude: 'longitude value'
map_zoom: N
map_scale_indicator: 'off' | metric | imperial | metric_imperial
map_pannable: true | false
map_zoomable: true | false
show_view_names: true | false
show_legend: true | false
show_region_field: true | false
draw_map_labels_above_data: true | false

## POINT PARAMETERS
map_marker_type: circle | icon | circle_and_icon | none
map_marker_icon_name: default | airplane | ambulance | anchor | beaker | bell | bolt | briefcase |
                      building | camera | car | checkmark | coffee | comment | envelope | file |
                      gamepad | gavel | gift | glass | headphones | heart | house | key | leaf |
                      microphone | music | person | phone | restaurant | school | shopping_cart |
                      star | suitcase | taxi | tree | trophy | truck | university | wrench
map_marker_radius_mode: proportional_value | equal_to_value | fixed
map_marker_radius_fixed: N
map_marker_radius_min: N
map_marker_radius_max: N
map_marker_proportional_scale_type: linear | log
map_marker_units: meters | pixels
map_marker_color_mode: value | fixed
map_marker_color: ['color value']

## VALUE PARAMETERS
map_value_colors: ['one or more color values']
quantize_map_value_colors: true | false
reverse_map_value_colors: true | false
map_value_scale_clamp_min: N
map_value_scale_clamp_max: N

Parameterdefinitionen

Parametername	Beschreibung
Grundlegende Parameter
name (für Elemente)	Erstellt ein Element
title (für Elemente)	Ändert die Art und Weise, wie ein Elementname für Nutzer angezeigt wird
type (für Elemente)	Bestimmt den Visualisierungstyp, der im Element verwendet werden soll.
height (für Elemente)	Definiert die Höhe eines Elements in Einheiten von tile_size für layout: tile- und layout: static-Dashboards
width (für Elemente)	Definiert die Breite eines Elements in Einheiten von tile_size für layout: tile- und layout: static-Dashboards
top	Definiert die Position eines Elements von oben nach unten in Einheiten von tile_size für layout: static-Dashboards.
left	Definiert die Position eines Elements von links nach rechts in Einheiten von tile_size für layout: static-Dashboards.
row	Definiert die Position eines Elements von oben nach unten in Zeileneinheiten für layout: newspaper-Dashboards
col	Definiert die Position eines Elements von links nach rechts in Spalteneinheiten für layout: newspaper-Dashboards
refresh (für Elemente)	Legt das Intervall fest, in dem das Element automatisch aktualisiert wird
note	Leitet einen Abschnitt von LookML ein, mit dem eine Notiz für ein Element definiert wird. Dieser Parameter hat die Unterparameter text, state und display.
Suchparameter
model	Definiert das Modell, das für die Abfrage des Elements verwendet werden soll
explore (für Elemente)	Definiert das Explore, das für die Abfrage des Elements verwendet werden soll
fields	Definiert die Felder, die für die Abfrage des Elements verwendet werden sollen. Dies kann anstelle von dimensions und measures verwendet werden.
dimensions	Definiert die Dimensionen, die für die Abfrage des Elements verwendet werden sollen
measures	Definiert die Messwerte, die für die Abfrage des Elements verwendet werden sollen.
sorts	Definiert die Sortierungen, die für die Abfrage des Elements verwendet werden sollen
pivots	Definiert die Dimensionen, die für die Abfrage des Elements geschwenkt werden sollen.
limit	Definiert die Zeilenbegrenzung, die für die Abfrage des Elements verwendet werden soll.
column_limit	Definiert die Spaltenbegrenzung, die für die Abfrage des Elements verwendet werden soll.
filters (für Elemente)	Definiert die Filter, die für die Abfrage des Elements nicht geändert werden können.
listen	Definiert die Filter, die für die Abfrage des Elements geändert werden können, wenn filters (für das Dashboard) erstellt wurden.
query_timezone	Definiert die Zeitzone, die beim Ausführen der Abfrage verwendet werden soll.
Diagrammparameter
map_plot_mode	Definiert, wie Ihre Standortdaten in einem Element von type: looker_map dargestellt werden.
heatmap_gridlines	Fügt einen Rahmen um jede der Linien hinzu, die für ein Heatmap-Element verwendet werden.
heatmap_gridlines_empty	Bei Heatmaps, bei denen heatmap_gridlines auf true festgelegt ist, wird eine Umrisslinie um Kartenregionen angezeigt, denen keine Daten zugeordnet sind.
heatmap_opacity	Definiert die Deckkraft der in einer Heatmap verwendeten Farben.
Kartenparameter
map_tile_provider	Definiert den Typ der Hintergrundkarte und ob Kartenlabels angezeigt werden.
map_position	Definiert den Mittelpunkt und die Zoomstufe der sichtbaren Karte.
map_latitude	Definiert den Breitengrad für eine Karte, bei der map_position auf custom festgelegt ist.
map_longitude	Definiert den Längengrad für eine Karte, bei der map_position auf custom festgelegt ist.
map_zoom	Definiert den Zoom für eine Karte, bei der map_position auf custom festgelegt ist.
map_scale_indicator	Legt fest, ob ein Kartenmaßstab angezeigt wird und welche Einheiten verwendet werden.
map_pannable	Legt fest, ob Nutzer die Karte durch Ziehen neu positionieren können.
map_zoomable	Legt fest, ob Nutzer die Karte heran- und herauszoomen können.
show_view_names	Legt fest, ob der Ansichtsname zusammen mit dem Feldnamen in Karten-Kurzinfos angezeigt werden soll.
show_legend	Legt fest, ob rechts unten in der Visualisierung eine Kartenlegende angezeigt werden soll.
show_region_field	Legt fest, ob die Regionsinformationen in der Kurzinfo der Karte angezeigt werden sollen.
draw_map_labels_above_data	Hier werden die Labels der Karte ober- oder unterhalb der Heatmap angezeigt.
Punktparameter
map_marker_type	Gibt den Typ des Punkts an, der auf der Karte für Elemente angezeigt wird, bei denen map_plot_mode auf points, lines oder areas festgelegt ist.
map_marker_icon_name	Gibt den Typ des Symbols an, das für alle Kartenmarkierungen für Elemente angezeigt werden soll, bei denen map_marker_type auf icon oder circle_and_icon festgelegt ist.
map_marker_radius_mode	Legt fest, wie die Größe der Kreise für Elemente mit map_marker_type auf circle oder circle_and_icon festgelegt wird.
map_marker_radius_fixed	Legt einen festen Radius für alle Kartenmarkierungen für Elemente fest, bei denen map_marker_type auf circle oder circle_and_icon und map_marker_radius_mode auf fixed festgelegt ist.
map_marker_radius_min	Legt den Mindestradius für Kreise für Elemente fest, bei denen map_marker_radius_mode auf proportional_value festgelegt ist.
map_marker_radius_max	Legt den maximalen Radius für Kreise für Elemente fest, bei denen map_marker_radius_mode auf proportional_value festgelegt ist.
map_marker_proportional_scale_type	Gibt an, ob die Kreisgröße auf einer linearen oder logarithmischen Skala basiert, für Elemente, bei denen map_marker_type auf circle oder circle_and_icon und map_marker_radius_mode auf proportional_value festgelegt ist.
map_marker_units	Legt die Einheiten für den Radius eines Kreises auf meters oder pixels fest für Elemente, deren map_marker_type auf circle oder circle_and_icon festgelegt ist.
map_marker_color_mode	Gibt an, ob die Farbe der Kartenmarkierungen festgelegt ist oder die Farben den Markierungen basierend auf den Werten der zugrunde liegenden Abfrage dynamisch zugewiesen werden.
map_marker_color	Gibt eine einzelne Farbe an, die auf alle Kartenmarkierungen für Elemente angewendet werden soll, bei denen map_marker_color_mode auf fixed festgelegt ist.
Wertparameter
map_value_colors	Gibt die Farben der Kartenpunkte an oder definiert den Farbbereich, der verwendet werden soll, wenn Sie die Punkte anhand eines Messwerts farblich codieren.
quantize_map_value_colors	Ändert die Farbskala von einem stufenlosen Farbverlauf zu den von Ihnen festgelegten Farben.
reverse_map_value_colors	Kehrt den Farbverlauf um, indem die Farben für hohe und niedrige Werte im Diagramm getauscht werden.
map_value_scale_clamp_min	Legt den Mindestwert des Farbbereichs fest.
map_value_scale_clamp_max	Legt den Höchstwert des Farbbereichs fest

Grundlegende Parameter

Wenn Sie ein LookML-Dashboardelement definieren, müssen Sie mindestens Werte für die grundlegenden Parameter name und type angeben. Andere grundlegende Parameter wie title, height und width wirken sich auf die Darstellung und Position eines Elements in einem Dashboard aus.

name

In diesem Abschnitt geht es um den Parameter name, der Teil eines Dashboard-Elements ist.

name kann auch als Teil eines Dashboardfilters verwendet werden. Weitere Informationen finden Sie auf der Dokumentationsseite Dashboard-Parameter.

Mit jeder name-Deklaration wird ein neues Dashboard-Element erstellt und ihm ein Name zugewiesen. Elementnamen müssen eindeutig sein. Namen werden manchmal im Parameter elements angegeben, wenn Sie layout: grid-Dashboards verwenden.

- name: orders_by_date

title

In diesem Abschnitt geht es um den Parameter title, der Teil eines Dashboard-Elements ist.

title kann auch als Teil eines Dashboards verwendet werden. Weitere Informationen finden Sie auf der Dokumentationsseite Dashboard-Parameter.

title kann auch als Teil eines Dashboardfilters verwendet werden. Weitere Informationen finden Sie auf der Dokumentationsseite Dashboard-Parameter.

Mit dem Parameter title können Sie ändern, wie der Name eines Elements für Nutzer angezeigt wird. Wenn nichts angegeben ist, wird standardmäßig das Element name als Titel verwendet.

Betrachten Sie dieses Beispiel:

- name: sales_overview
  title: '1) Sales Overview'

Wenn Sie dieses Format verwendet haben, wird das Element nicht als Umsatzübersicht, sondern als 1) Umsatzübersicht angezeigt.

type

In diesem Abschnitt geht es um den Parameter type, der Teil eines Dashboard-Elements ist.

type kann auch als Teil eines Dashboardfilters verwendet werden. Weitere Informationen finden Sie auf der Dokumentationsseite Dashboard-Parameter.

type kann auch als Teil eines Joins verwendet werden. Dies wird auf der Dokumentationsseite zum Parameter type (für Joins) beschrieben.

type kann auch als Teil einer Dimension verwendet werden. Weitere Informationen finden Sie auf der Dokumentationsseite Dimensionen, Filter und Parametertypen.

type kann auch als Teil eines Messwerts verwendet werden, wie auf der Dokumentationsseite Messwerttypen beschrieben.

Der Parameter type bestimmt den Visualisierungstyp, der im Element verwendet werden soll.

- name: element_name
  type: text | looker_grid | table | single_value | looker_single_record |
        looker_column | looker_bar | looker_scatter | looker_line | looker_area |
        looker_pie | looker_donut_multiples | looker_funnel | looker_timeline |
        looker_map | looker_google_map | looker_geo_coordinates | looker_geo_choropleth | looker_waterfall | looker_wordcloud | looker_boxplot

Einen Überblick über die verschiedenen Arten von LookML-Dashboard-Elementen finden Sie auf der Dokumentationsseite type (für LookML-Dashboards).

height

In diesem Abschnitt geht es um den Parameter height, der Teil eines Dashboard-Elements ist.

height kann auch als Teil einer Dashboard-Zeile verwendet werden. Weitere Informationen finden Sie auf der Dokumentationsseite Dashboard-Parameter.

Für Dashboards mit tile- oder static-Layouts

Mit dem Parameter height wird die Höhe eines Elements in Einheiten von tile_size (in Pixeln) für layout: tile- und layout: static-Dashboards definiert.

Im folgenden Code werden beispielsweise tile_size: 100 und height: 4 angegeben, wodurch das Element orders_by_date eine Höhe von 400 Pixeln erhält.

- dashboard: sales_overview
  tile_size: 100
  ...

  elements:
  - name: orders_by_date
    height: 4
    ...

Für Dashboards mit newspaper-Layout

Mit dem Parameter height wird die Höhe eines Elements in Einheiten von Zeile für layout: newspaper-Dashboards definiert.

Bei einem Dashboard mit Zeitungs-Layout ist die Standardhöhe eines Elements auf 6 Zeilen oder etwa 300 Pixel festgelegt. Die Mindesthöhe beträgt eine Zeile für Dashboards, bei denen der Parameter preferred viewer auf dashboards-next festgelegt ist. Die Mindesthöhe beträgt zwei Zeilen für Dashboards, bei denen der Parameter preferred viewer auf dashboards festgelegt ist.

Im folgenden Code wird beispielsweise ein Element auf 12 Zeilen festgelegt, also doppelt so hoch wie andere Elemente, für die der Standardwert festgelegt ist:

- dashboard: sales_overview
  layout: newspaper
  ...

  elements:
  - name: orders_by_date
    height: 12
    ...

width

In diesem Abschnitt geht es um den Parameter width, der Teil eines Dashboard-Elements ist.

width kann auch als Teil eines Dashboards verwendet werden. Weitere Informationen finden Sie auf der Dokumentationsseite Dashboard-Parameter.

Der Parameter width definiert die Breite eines Elements in Einheiten von tile_size für layout: tile- und layout: static-Dashboards.

Im folgenden Code werden beispielsweise tile_size: 100 und width: 4 angegeben, wodurch das orders_by_date-Element eine Breite von 400 Pixeln erhält.

- dashboard: sales_overview
  tile_size: 100
  ...

  elements:
  - name: orders_by_date
    width: 4
    ...

Der Parameter width definiert die Breite eines Elements in Spalteneinheiten für layout: newspaper-Dashboards.

Ein Dashboard mit Zeitungs-Layout hat standardmäßig eine Breite von 24 Spalten.

Mit dem folgenden Code wird die Breite des Elements beispielsweise auf die Hälfte der Breite des Dashboards festgelegt:

- dashboard: sales_overview
  layout: newspaper
  ...

  elements:
  - name: orders_by_date
    width: 12
    ...

top

Mit dem Parameter top wird die Position eines Elements von oben nach unten in Einheiten von tile_size für layout: static-Dashboards definiert.

Im folgenden Code werden beispielsweise tile_size: 100 und top: 4 angegeben. Dadurch wird der obere Rand des Elements orders_by_date 400 Pixel vom oberen Rand des Dashboards entfernt positioniert.

- dashboard: sales_overview
  tile_size: 100
  ...

  elements:
  - name: orders_by_date
    top: 4
    ...

left

Der Parameter left definiert die Position eines Elements von links nach rechts in Einheiten von tile_size für layout: static-Dashboards.

Im folgenden Code wird beispielsweise tile_size: 100 und left: 4 angegeben. Dadurch wird der linke Rand des Elements orders_by_date 400 Pixel vom linken Rand des Dashboards entfernt positioniert.

- dashboard: sales_overview
  tile_size: 100
  ...

  elements:
  - name: orders_by_date
    left: 4
    ...

row

Bei layout: newspaper-Dashboards wird mit dem Parameter row die Zeile definiert, in der die obere Kante eines Elements platziert wird.

Ein Dashboard beginnt mit Zeile 0 oben im Dashboard. Bei einem Dashboard mit Zeitungs-Layout ist die Standardhöhe eines Elements 6 Zeilen. Die Dashboard-Elemente oben auf einem Dashboard (row: 0) würden also standardmäßig die Zeilen 0 bis 5 einnehmen.

Jede Zeile ist 50 Pixel hoch. Die Standardhöhe des Elements von 6 Zeilen beträgt also 300 Pixel.

Mit dem folgenden Code wird beispielsweise ein Element in der zweiten Zeile der Elemente im Dashboard platziert, sofern die Elemente auf der Standardhöhe festgelegt sind:

- dashboard: sales_overview
  layout: newspaper
  ...

  elements:
  - name: orders_by_date
    row: 6
    ...

col

Bei layout: newspaper-Dashboards wird mit dem Parameter col die Spalte definiert, an der der linke Rand des Elements platziert wird.

Dashboards sind in 24 Spalten unterteilt. Ein Dashboard beginnt mit Spalte 0 links im Dashboard. Bei einem Dashboard mit Zeitungs-Layout wird standardmäßig eine Elementbreite von 8 Spalten verwendet. Die Dashboard-Elemente auf der linken Seite eines Dashboards (col: 0) belegen also standardmäßig die Spalten 0 bis 7.

Mit dem folgenden Code wird beispielsweise festgelegt, dass ein Element in der dritten Spalte der Elemente im Dashboard platziert werden soll:

- dashboard: sales_overview
  layout: newspaper
  ...

  elements:
  - name: orders_by_date
    col: 16
    ...

refresh

In diesem Abschnitt geht es um den Parameter refresh, der Teil eines Dashboard-Elements ist.

refresh kann auch als Teil eines Dashboards verwendet werden. Weitere Informationen finden Sie auf der Dokumentationsseite Dashboard-Parameter.

Mit dem Parameter refresh kann ein Element in regelmäßigen Abständen automatisch neu geladen werden, um aktuelle Daten abzurufen. Das ist oft hilfreich, wenn ein Dashboard ständig angezeigt wird, z. B. auf einem Fernseher im Büro. Das Dashboard muss in einem Browserfenster geöffnet sein, damit dieser Parameter wirksam wird. Diese Einstellung wird nicht im Hintergrund ausgeführt, um den Dashboard-Cache „vorzubereiten“.

Die Aktualisierungsrate kann eine beliebige Anzahl (ohne Dezimalstellen) von Sekunden, Minuten, Stunden oder Tagen sein. Beispiel:

- name: orders_by_date
  refresh: 2 hours

Seien Sie vorsichtig, wenn Sie kurze Aktualisierungsintervalle festlegen. Wenn die Abfrage, die dem Element zugrunde liegt, ressourcenintensiv ist, können bestimmte Elemente Ihre Datenbank stärker als gewünscht belasten.

note

So fügen Sie Elementen beschreibende Notizen hinzu:

- name: element_name
  note:
    text: 'note text'
    state: collapsed | expanded
    display: above | below | hover

note hat die Unterparameter text, state und display.

text

Der Unterparameter text gibt den Text an, der in der Notiz angezeigt wird. Der Text kann lokalisiert werden.

state

Mit dem Unterparameter state wird festgelegt, ob die Anmerkung collapsed oder expanded sein soll, wenn sie zu groß ist, um in einer einzelnen Zeile innerhalb der Breite des Elements dargestellt zu werden. Wenn Sie collapsed auswählen und die Anmerkung zu lang ist, endet sie mit klickbaren Auslassungspunkten (...), über die Sie die vollständige Anmerkung lesen können.

display

Mit dem Unterparameter display wird festgelegt, wo die Anmerkung für ein Element angezeigt wird. Mit above wird die Notiz oben in einem Element platziert, mit below unten in einem Element und mit hover wird die Notiz erst angezeigt, wenn der Nutzer den Mauszeiger auf das Element bewegt.

Suchparameter

Wenn Sie ein LookML-Dashboardelement definieren, müssen Sie Werte für mindestens die Abfrageparameter model und explore angeben.

Für LookML-Dashboard-Elemente vom Typ type: looker_map müssen Sie auch mindestens ein geografisches Feld als Wert des Parameters dimensions oder fields angeben. Ein geografisches Feld kann eines der folgenden sein:

• Eine Dimension, die auf Breiten- und Längengraddaten basiert und in LookML als Dimension vom Typ type: location definiert ist.
• Einer Dimension ist eine Kartenebene zugewiesen. LookML-Entwickler können einem Messwert mit dem Parameter map_layer_name eine integrierte Kartebene oder eine benutzerdefinierte Kartebene hinzufügen.
• Eine Dimension für Postleitzahlen Postleitzahlregionen basieren auf den ZCTAs (Zip Code Tabulation Areas) von 2010. Wenn Sie Postleitzahlen visualisieren, gibt es möglicherweise keine direkte Entsprechung zwischen Postleitzahlen und den für Kartendarstellungen verwendeten ZCTAs. Daher werden möglicherweise nicht alle Punkte auf der Karte visualisiert.

Mit den anderen Abfrageparametern können Sie die Darstellung von Daten in einem Dashboard-Element steuern. Weitere Informationen zu den Anforderungen für das Erstellen eines interaktiven Kartendiagramms mit der Looker-Benutzeroberfläche finden Sie im Abschnitt Interaktives Kartendiagramm erstellen auf der Dokumentationsseite Optionen für Kartendiagramme.

model

Mit dem Parameter model wird das Modell für die Elementabfrage definiert. Wenn nichts angegeben ist, wird standardmäßig das Modell verwendet, in dem sich das Dashboard befindet.

- name: orders_by_date
  model: ecommerce

Der Parameter model akzeptiert LookML-Konstanten. Sie können eine Konstante in der Manifestdatei für Ihr Projekt definieren und dann die Syntax "@{constant_name}" verwenden, um die Konstante als Wert für model festzulegen. Wenn Sie eine Konstante verwenden, können Sie den Namen eines Modells an einem Ort definieren. Das ist besonders nützlich, wenn Sie den Namen eines Modells aktualisieren, das von mehreren Dashboard-Elementen verwendet wird.

Weitere Informationen und ein Beispiel für die Verwendung von Konstanten mit LookML-Dashboards finden Sie auf der Dokumentationsseite zum Parameter constant.

explore

In diesem Abschnitt geht es um den Parameter explore, der Teil eines Dashboard-Elements ist.

explore kann auch als Teil eines Modells verwendet werden, wie auf der Dokumentationsseite zum Parameter explore beschrieben.

explore kann auch als Teil eines Dashboardfilters verwendet werden. Weitere Informationen finden Sie auf der Dokumentationsseite Dashboard-Parameter.

Der Parameter explore definiert das Explore, das für die Elementabfrage verwendet werden soll.

- name: orders_by_date
  explore: order

Der Parameter explore akzeptiert LookML-Konstanten. Sie können eine Konstante in der Manifestdatei für Ihr Projekt definieren und dann die Syntax "@{constant_name}" verwenden, um die Konstante als Wert für explore festzulegen. Wenn Sie eine Konstante verwenden, können Sie den Namen eines Explores an einem Ort definieren. Das ist besonders nützlich, wenn Sie den Namen eines Explores aktualisieren, das von mehreren Dashboard-Elementen verwendet wird.

Weitere Informationen und ein Beispiel für die Verwendung von Konstanten mit LookML-Dashboards finden Sie auf der Dokumentationsseite zum Parameter constant.

fields

Der Parameter fields definiert die Felder, die für die Elementabfrage verwendet werden sollen. Verwenden Sie die Syntax view_name.dimension_name, um die Felder anzugeben.

## single field example
- name: orders_by_date
  fields: order.order_date

## multiple fields example
- name: orders_by_date
  fields: [order.order_date, order.order_count]

Wenn Sie den Parameter fields verwenden, müssen Sie die Parameter dimensions und measures nicht verwenden.

dimensions

Der Parameter dimensions definiert die Dimension(en), die für die Elementabfrage verwendet werden sollen. Verwenden Sie die Syntax view_name.dimension_name, um die Dimension anzugeben. Fügen Sie dimensions nicht ein, wenn die Anfrage keine hat.

## single dimension example
- name: orders_by_date
  dimensions: order.order_date

## multiple dimension example
- name: orders_by_date
  dimensions: [order.order_date, customer.name]

measures

Der Parameter measures definiert den oder die Messwerte, die für die Elementabfrage verwendet werden sollen. Verwenden Sie die Syntax view_name.measure_name, um die Messung anzugeben. Fügen Sie measures nicht ein, wenn die Anfrage keine hat.

## single measure example
- name: orders_by_date
  measures: order.count

## multiple measure example
- name: orders_by_date
  measures: [order.count, order_item.count]

sorts

Der Parameter sorts definiert die Sortierungen, die für die Elementabfrage verwendet werden sollen. Die primäre Sortierung wird zuerst aufgeführt, dann die sekundäre usw. Verwenden Sie die Syntax view_name.field_name, um die Dimension oder den Messwert anzugeben. Geben Sie sorts nicht an, wenn Sie die Standardsortierreihenfolge von Looker verwenden möchten. Absteigende Sortierungen haben das Suffix desc. Aufsteigende Sortierungen benötigen kein Suffix.

## single sort example
- name: orders_by_date
  sorts: order.order_date desc

## multiple sort example
- name: orders_by_date
  sorts: [order.order_date desc, customer.name]

pivots

Der Parameter pivots definiert die Dimensionen, die für die Elementabfrage pivotiert werden sollen. Verwenden Sie die Syntax view_name.dimension_name, um die Dimension anzugeben. Fügen Sie pivots nicht ein, wenn die Anfrage keine hat.

## single pivot example
- name: orders_by_date
  pivots: customer.gender

## multiple pivot example
- name: orders_by_date
  pivots: [customer.gender, customer.age_tier]

limit

Der Parameter limit definiert das Zeilenlimit, das für die Elementabfrage verwendet werden soll. Das Limit gilt für die Anzahl der Zeilen bevor Pivots angewendet werden.

- name: orders_by_date
  limit: 100

column_limit

Der Parameter column_limit definiert das Spaltenlimit, das für die Elementabfrage verwendet werden soll. Das Limit gilt für die Anzahl der Spalten nach der Anwendung von Pivots.

- name: orders_by_date
  column_limit: 100

filters

In diesem Abschnitt geht es um den Parameter filters, der Teil eines Dashboard-Elements ist.

filters kann auch als Teil eines Dashboards verwendet werden. Weitere Informationen finden Sie auf der Dokumentationsseite Dashboard-Parameter.

filters kann auch als Teil einer Messung verwendet werden. Weitere Informationen finden Sie auf der Dokumentationsseite zum Parameter filters.

Mit dem Parameter filters werden die unveränderlichen Filter definiert, die für die Abfrage des Elements verwendet werden sollen. Wenn Sie Filter verwenden möchten, die ein Nutzer im Dashboard ändern kann, sollten Sie die Filter mit filters für Dashboards einrichten und sie dann mit listen auf die Elemente anwenden.

Die Syntax für filters lautet:

- name: element_name
  filters:
    orders.created_date: 2020/01/10 for 3 days
    orders.status: Shipped
    # You can create multiple filter statements

Für jeden Filter kann ein Looker-Filterausdruck oder eine Wertkonstante angegeben werden. Sie können auch die Liquid-Variablen _localization oder _user_attributes im Filterausdruck verwenden, um flexible Filterwerte zu erhalten.

listen

Mit Dashboard-Filtern können Betrachter die Daten, die in Dashboard-Elementen angezeigt werden, interaktiv eingrenzen. Dashboard-Filter werden mit dem filters-Parameter für LookML-Dashboards definiert. Verwenden Sie dann den Parameter listen, um Dashboard-Elemente mit dem Dashboard-Filter zu verknüpfen.

Die Syntax für listen lautet so:

- name: element_name
  listen:
    filter_name_goes_here: dimension or measure on which to apply
                           the filter using view_name.field_name syntax
    # You can add more than one listen statement

Fügen Sie einem Element den Parameter listen hinzu und geben Sie dann den Namen des Filters gefolgt von einem Doppelpunkt und einem Verweis auf das Feld an, auf das der Filter angewendet werden soll. Verwenden Sie dazu die Syntax view_name.field_name. Sie können beispielsweise einen Filter namens Datum erstellen, bei dem ein Nutzer ein Datum in das Filterfeld in der Benutzeroberfläche eingeben muss. Sie können den vom Nutzer eingegebenen Wert dann so auf das orders_by_date-Element anwenden:

- dashboard: sales_overview
  ...

  filters:
  - name: date
    type: date_filter

  elements:
 - name: orders_by_date
    listen:
      date: order.order_date
    ...

Weitere Beispiele für die Verwendung des Parameters filters und des Parameters listen zum Anwenden von Dashboard-Filtern auf einzelne Dashboard-Elemente finden Sie unter LookML-Dashboards erstellen.

query_timezone

Mit dem Parameter query_timezone wird die Zeitzone angegeben, in der die Abfrage ausgeführt wird. Die Zeitzonenoptionen finden Sie auf der Dokumentationsseite Werte für timezone. Wenn die Abfrage in der Zeitzone des Betrachters ausgeführt werden soll, können Sie den Wert als user_timezone zuweisen.

- name: orders_by_date
  query_timezone: America/Los Angeles

- name: orders_by_customer
  query_timezone: user_timezone

Diagrammparameter

Die in diesem Abschnitt beschriebenen Parameter entsprechen den Optionen im Abschnitt „Diagramm“ des Visualisierungseditors für Karten.

Die Parameter, die Sie mit einem Element von type: looker_map verwenden können, hängen davon ab, ob Ihre Abfrage eine Dimension von type: location enthält oder eine Karten-Ebene damit verknüpft ist.

map_plot_mode

Mit dem Parameter map_plot_mode wird festgelegt, wie Ihre Daten in einem type: looker_map-Element dargestellt werden, das auf einer Dimension vom Typ type: location basiert. Dieser Parameter ist nicht für Karten verfügbar, die auf einer Dimension mit einer zugehörigen Kartebene oder für Postleitzahl-Dimensionen basieren. Der Parameter map_plot_mode akzeptiert die folgenden Werte:

• points
• automagic_heatmap
• lines
• areas

points

Wenn Sie map_plot_mode auf points festlegen, wird jede Zeile in der zugrunde liegenden Datentabelle als diskreter Punkt auf der Karte dargestellt.

Wenn Sie nur die Dimension type: location verwenden, werden Punkte mit einheitlicher Größe und Farbe auf der Karte platziert. Wenn Sie der Abfrage einen Messwert hinzufügen, können die Punkte mit den Parametern map_marker_radius_mode und map_marker_color_mode nach Farbe oder Größe skaliert werden.

automagic_heatmap

Wenn Sie map_plot_mode auf automagic_heatmap festlegen, werden die Daten in der zugrunde liegenden Abfrage als Heatmap-Raster dargestellt. Dazu wird die sichtbare Karte in gleich große Quadrate unterteilt und dann berechnet, welche Werte in Ihren Daten in jedes Quadrat passen. Die Quadrate werden entsprechend einem von Ihnen ausgewählten Maß gefärbt. Wenn Sie in diese Karte hinein- oder herauszoomen, wird das Raster in Looker neu berechnet, sodass die Granularität der Zoomstufe entspricht.

Ihre Abfrage muss sowohl eine Dimension von type: location als auch eine Messung enthalten, damit dieser Diagrammtyp richtig funktioniert.

lines

Wenn Sie map_plot_mode auf lines festlegen, werden zwei Dimensionen von type: location aus Ihrer Abfrage verwendet und in der Visualisierung miteinander verbunden. Wenn Sie Ihrer Abfrage eine Messung hinzufügen, können Sie den Linien eine Farbskala hinzufügen.

areas

Wenn Sie map_plot_mode auf areas festlegen, wird eine Dimension von type: location verwendet und alle Punkte werden in der Reihenfolge verbunden, in der Sie sie sortiert haben. Dadurch werden die Grenzen eines Bereichs auf dem Kartenelement festgelegt. Wenn Sie der Abfrage eine Messung hinzufügen, können Sie die Größe und Farbe der einzelnen Standortpunkte formatieren, aus denen die Grenzen des Bereichs bestehen.

heatmap_gridlines

Wenn Sie für Heatmap-Elemente heatmap_gridlines auf true festlegen, wird um jede der für die Heatmap verwendeten Rasterlinien ein Rahmen hinzugefügt. Dieser Parameter ist verfügbar, wenn Sie eine Dimension vom Typ type: location mit map_plot_mode auf automagic_heatmap festlegen oder eine Postleitzahl-Dimension oder eine Dimension mit einer zugehörigen Kartebene darstellen.

heatmap_gridlines: true | false

heatmap_gridlines_empty

Wenn heatmap_gridlines für Heatmap-Elemente auf true festgelegt ist, wird durch Festlegen von heatmap_gridlines_empty auf true eine Umrisslinie um die Kartenregionen angezeigt, denen keine Daten zugeordnet sind.

heatmap_gridlines_empty: true | false

heatmap_opacity

Für Heatmap-Elemente können Sie mit heatmap_opacity die Deckkraft der in der Heatmap verwendeten Farben angeben. Geben Sie für heatmap_opacity eine Zahl zwischen 0 und 1 an, wobei 0 keine Farbe und 1 vollständig undurchsichtig bedeutet.

heatmap_opacity: 0.5

Kartenparameter

Die meisten Parameter, die in diesem Abschnitt beschrieben werden, entsprechen den Optionen im Abschnitt „Karte“ des Visualisierungseditors für Säulendiagramme.

map_tile_provider

Mit dem Parameter map_tile_provider, der für alle Karten verfügbar ist, können Sie den Typ der Hintergrundkarte ändern und angeben, ob Kartenlabels (z. B. für Städte und Straßen) angezeigt werden sollen.

• light: Eine dezente, hell gefärbte Karte, die geografischen Kontext bietet und gleichzeitig Ihre Daten hervorhebt.
• light_no_labels: Wie light, nur dass auf der Karte keine Labels wie Städtenamen angezeigt werden.
• dark: Eine dezente, dunkelfarbige Karte, die geografischen Kontext bietet und gleichzeitig Ihre Daten hervorhebt.
• dark_no_labels: Wie dark, nur dass auf der Karte keine Labels wie Städtenamen angezeigt werden.
• satellite_streets: Karte mit globalen Satelliten- und Luftbildern
• satellite: Wie satellite_streets, nur dass auf der Karte keine Labels wie Städtenamen angezeigt werden.
• streets: Karte für allgemeine Zwecke, bei der die Darstellung von Straßen- und Verkehrsnetzen gut lesbar ist
• outdoors: Allgemeine Karte, die für Wanderungen, Radtouren und andere Outdoor-Aktivitäten optimiert ist
• traffic_day: Helle Karte mit Schwerpunkt auf Verkehrsnetzen und Straßen, einschließlich aktueller Verkehrsinformationen
• traffic_night: Dunkle Karte mit Schwerpunkt auf Verkehrsnetzen und Straßen, einschließlich aktueller Verkehrsinformationen

map_tile_provider: light | light_no_labels | dark | dark_no_labels | satellite_streets |
                    satellite | streets | outdoors | traffic_day | traffic_night

map_position

Mit dem Parameter map_position können Sie den Mittelpunkt und die Zoomstufe der sichtbaren Karte festlegen. Es gibt zwei Möglichkeiten, diese Position anzugeben:

• fit_data: Die Karte wird automatisch zentriert und gezoomt, sodass alle Datenpunkte Ihrer Abfrage sichtbar sind.
• custom: Hiermit können Sie Breiten- und Längengrad sowie die Zoomstufe manuell mit den Parametern map_latitude, map_longitude und map_zoom angeben.

map_position: fit_data | custom

map_latitude

Der Parameter map_latitude gibt den Breitengrad für ein Kartenelement an, für das map_position auf custom festgelegt ist.

map_latitude: -5.804047131379801

map_longitude

Der Parameter map_longitude gibt den Längengrad für ein Kartenelement an, dessen map_position auf custom festgelegt ist.

 map_longitude: 113.34732055664064

map_zoom

Mit dem Parameter map_zoom können Sie die Zoomstufe für ein Kartenelement festlegen, bei dem map_position auf custom gesetzt ist. Höhere Zahlen führen zu einer höheren Zoomstufe.

map_zoom: 10

map_scale_indicator

Der Parameter map_scale_indicator ist standardmäßig auf 'off' festgelegt. Damit können Sie angeben, ob eine Maßstabsleiste angezeigt werden soll, und die angezeigten Einheiten festlegen.

map_scale_indicator: 'off' | metric | imperial | metric_imperial

map_pannable

Mit dem Parameter map_pannable wird angegeben, ob Nutzer die Karte durch Ziehen neu positionieren können. Diese Option ist standardmäßig aktiviert.

map_pannable: true | false

map_zoomable

Mit dem Parameter map_zoomable wird angegeben, ob Nutzer in das Kartenelement hinein- und herauszoomen können. Diese Option ist standardmäßig aktiviert.

map_zoomable: true | false

show_view_names

Mit dem Parameter show_view_names wird angegeben, ob der Ansichtsname zusammen mit dem Feldnamen in den Karten-Kurzinfos angezeigt werden soll. Diese werden eingeblendet, wenn Nutzer auf Kartendatenpunkte klicken.

show_view_names: true | false

show_legend

Geben Sie an, ob unten rechts in der Visualisierung eine Kartenlegende angezeigt werden soll. In der Legende wird die verwendete Farbskala angezeigt, sofern Sie Ihrer Visualisierung einen Messwert hinzugefügt haben.

Der Parameter show_legend ist verfügbar, wenn die folgenden Diagrammoptionen angegeben wurden:

• Wenn map_plot_mode auf automagic_heatmap festgelegt wurde
• Wenn map_plot_mode auf points und map_marker_color_mode auf value festgelegt ist

show_legend: true | false

show_region_field

Bei Karten, die auf einer Kartebene oder einem Postleitzahlgebiet basieren, werden mit dem Parameter show_region_field die Informationen in der Kurzinfo der Karte angezeigt. Nutzer können auf einen Punkt auf der Karte klicken, um den Namen der Region zu sehen.

show_region_field: true | false

draw_map_labels_above_data

Bei Karten mit Kartenebenen oder Karten, die auf einer Dimension für Postleitzahlen basieren, können Sie mit dem Parameter draw_map_labels_above_data die Labels der Karte ober- oder unterhalb der Heatmap anzeigen lassen. Das ist besonders bei höheren Werten für die Deckkraft der Heatmap der Fall. Wenn Ihre Heatmap undurchsichtig ist, werden die Labels nur angezeigt, wenn sie über den Daten dargestellt werden.

draw_map_labels_above_data: true | false

Punktparameter

Punktoptionen sind für Karten, bei denen map_plot_mode auf automagic_heatmap festgelegt ist, nicht verfügbar.

map_marker_type

Bei Karten, die auf einer Standortdimension basieren und für die map_plot_mode auf points, lines oder areas festgelegt ist, wird mit dem Parameter map_marker_type der Typ des Punkts definiert, der für das Kartenelement angezeigt wird. Der Parameter map_marker_type akzeptiert die folgenden Werte:

• circle
• icon
• circle_and_icon
• none

Der für map_marker_type angegebene Wert wirkt sich auf die Parameter aus, die zum Formatieren der auf der Karte angezeigten Punkte verfügbar sind.

map_marker_icon_name

Wenn map_marker_type auf icon oder circle_and_icon festgelegt ist, können Sie mit dem Parameter map_marker_icon_name den Typ des Symbols festlegen, das für alle Kartenmarkierungen angezeigt werden soll.

map_marker_icon_name: default | airplane | ambulance | anchor | beaker | bell | bolt | briefcase |
                      building | camera | car | checkmark | coffee | comment | envelope | file |
                      gamepad | gavel | gift | glass | headphones | heart | house | key | leaf |
                      microphone | music | person | phone | restaurant | school | shopping_cart |
                      star | suitcase | taxi | tree | trophy | truck | university | wrench

map_marker_radius_mode

Bei Karten, für die map_marker_type auf circle oder circle_and_icon festgelegt ist, können Sie mit dem Parameter map_marker_radius_mode die Größe der Kreise entsprechend den folgenden Optionen festlegen:

• proportional_value: Mit dieser Option wird die relative Größe der Kreise entsprechend den Messwerten angepasst, die Sie Ihrer Abfrage hinzugefügt haben. Mit dieser Option können Sie mit den Parametern map_marker_radius_min und map_marker_radius_max einen Mindest- und einen Höchstradius für die Kreise festlegen. Mit dem Parameter map_marker_proportional_scale_type können Sie festlegen, ob die Kreise mit einer linearen oder einer logarithmischen Skala skaliert werden.
• equal_to_value: Mit dieser Einstellung wird der Radius der Kreise an die tatsächlichen Messwerte in der zugrunde liegenden Abfrage angepasst.
• fixed: Mit dieser Option können Sie einen festen Radius festlegen, der mit dem Parameter map_marker_radius_fixed auf alle Kartenmarkierungen angewendet wird. Der Standardwert ist 500.

map_marker_radius_mode: proportional_value | equal_to_value | fixed

map_marker_radius_fixed

Wenn map_marker_radius_mode auf fixed und map_marker_type auf circle oder circle_and_icon festgelegt ist, können Sie mit dem Parameter map_marker_radius_fixed einen festen Radius festlegen, der für alle Kartenmarkierungen gilt.

map_marker_type: circle
map_marker_radius_mode: fixed
map_marker_radius_fixed: 60

map_marker_radius_min

Bei Karten, bei denen map_marker_type auf circle oder circle_and_icon und map_marker_radius_mode auf proportional_value festgelegt ist, können Sie mit dem Parameter map_marker_radius_min den Mindestradius für einen Kreis definieren.

map_marker_type: circle
map_marker_radius_mode: proportional_value
map_marker_radius_min: 5

map_marker_radius_max

Bei Karten, bei denen map_marker_type auf circle oder circle_and_icon und map_marker_radius_mode auf proportional_value festgelegt ist, können Sie mit dem Parameter map_marker_radius_max den maximalen Radius für einen Kreis definieren.

map_marker_type: circle
map_marker_radius_mode: proportional_value
map_marker_radius_max: 50

map_marker_proportional_scale_type

Bei Karten, bei denen map_marker_type auf circle oder circle_and_icon und map_marker_radius_mode auf proportional_value festgelegt ist, können Sie mit dem Parameter map_marker_proportional_scale_type die Kreisgröße auf einer linearen oder logarithmischen Skala basieren lassen. Der Wert dieses Parameters kann entweder linear oder log sein.

map_marker_radius_mode: proportional_value
map_marker_proportional_scale_type: linear | log

map_marker_units

Bei Karten, bei denen map_marker_type auf circle oder circle_and_icon festgelegt ist, können Sie mit dem Parameter map_marker_units die Einheiten für den Radius eines Kreises auf meters oder pixels festlegen.

map_marker_units: meters | pixels

map_marker_color_mode

Mit map_marker_color_mode können Sie die Farben der Kartenmarkierungen festlegen:

• Wenn map_marker_color_mode auf value festgelegt ist, werden Markierungen basierend auf den Werten der zugrunde liegenden Abfrage dynamisch Farben zugewiesen. Mit Wertparametern können Sie die Farben in der Legende für diese Option konfigurieren.
• Wenn map_marker_color_mode auf fixed festgelegt ist, können Sie mit dem Parameter map_marker_color eine einzelne Farbe für alle Kartenmarkierungen festlegen. Der Farbwert kann als hexadezimaler RGB-String wie 2ca6cd oder als CSS-Farbname wie mediumblue formatiert werden.

map_marker_color

Wenn map_marker_color_mode auf fixed festgelegt ist, legen Sie eine einzelne Farbe für alle Kartenmarkierungen fest.

map_marker_color: [mediumblue]

Wertparameter

Mit diesen Parametern können Sie die Farben konfigurieren, die Markierungen basierend auf den Werten der zugrunde liegenden Abfrage dynamisch zugewiesen werden, wenn map_marker_color_mode auf value festgelegt ist. Das gilt auch für Kartenelemente, bei denen map_plot_mode auf automagic_heatmap, lines oder areas festgelegt ist.

map_value_colors

Mit dem Parameter map_value_colors können Sie die Farbe von Kartenpunkten festlegen oder, wenn Sie die Farben nach einem Measure codieren, den zu verwendenden Farbbereich definieren. Sie können eine Liste von Hex-Strings wie #2ca6cd oder CSS-Farbnamen wie mediumblue eingeben. Die Farben, die Sie zuerst auflisten, sind den niedrigsten Werten zugeordnet.

map_value_colors: [green, mediumblue]

quantize_map_value_colors

Wenn true festgelegt ist, ändert quantize_map_value_colors die Farbskala von einem stufenlosen Farbverlauf zu den von Ihnen festgelegten Farben. Dieser Parameter ist standardmäßig auf false festgelegt.

quantize_map_value_colors: true | false

reverse_map_value_colors

Wenn der Parameter auf true festgelegt ist, werden die Farben, die hohe und niedrige Werte im Diagramm angeben, vertauscht und der Farbverlauf wird umgekehrt.reverse_map_value_colors

reverse_map_value_colors: true | false

map_value_scale_clamp_min

Mit dem Parameter map_value_scale_clamp_min können Sie den Mindestwert für den Farbbereich festlegen. So können Sie alle Punkte unter einem bestimmten Schwellenwert (der angegebenen Zahl) mit der niedrigsten Farbe, die mit dem Parameter map_value_colors angegeben wurde, farblich kennzeichnen. Standardmäßig ist der Mindestwert, der auf die Legende angewendet wird, der Mindestwert aus Ihrer Abfrage.

map_value_scale_clamp_min: 1000

map_value_scale_clamp_max

Mit dem Parameter map_value_scale_clamp_max können Sie den Maximalwert für den Farbbereich festlegen. So können Sie alle Punkte, die über der mit dem Parameter map_value_colors angegebenen Zahl liegen, mit der höchsten Farbe des Farbbereichs darstellen. Standardmäßig ist der Höchstwert, der auf die Legende angewendet wird, der Höchstwert aus Ihrer Abfrage.

map_value_scale_clamp_max: 50000