Sie sehen sich die Dokumentation für Looker 26.16 an. Klicken Sie hier, um die aktuelle Dokumentation aufzurufen.

Google verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.

Parameter für Boxplot-Diagramme für LookML-Dashboards

Auf dieser Seite wird gezeigt, wie Sie ein LookML-Dashboard-Element vom Typ type: looker_boxplot mit LookML-Dashboard-Parametern in einer dashboard.lkml-Datei hinzufügen und anpassen.

Informationen zum Erstellen eines Boxplot-Diagramms über die Looker-Benutzeroberfläche finden Sie auf der Dokumentationsseite Boxplot-Diagrammoptionen.

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_boxplot
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, 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, …]
limit: N
filters:
  view_name.field_name: 'looker filter expression'
listen:
  dashboard_filter_name: view_name.field_name
query_timezone: 'specific timezone' | user_timezone
hidden_fields: [view_name.field_name, view_name.field_name, …]

## SERIES PARAMETERS

color_application:
  collection_id: 'collection ID'
  palette_id: 'palette ID'
  options:
    reverse: true | false

## STYLE PARAMETERS

show_view_names: true | false

## X-AXIS PARAMETERS

show_x_axis_label: true | false
x_axis_label: 'desired x-axis label'
show_x_axis_ticks: true | false
x_axis_gridlines: true | false
x_axis_reversed: true | false
x_axis_zoom: true | false

## Y-AXIS PARAMETERS

show_y_axis_labels: true | false
y_axis_labels: ['desired y-axis label']
show_y_axis_ticks: true | false
y_axis_gridlines: true | false
y_axis_min: ['N']
y_axis_max: ['N']
y_axis_tick_density: default | custom
y_axis_tick_density_custom: 'N'
y_axis_reversed: true | false
y_axis_value_format: ['Excel-style formatting']
y_axis_zoom: true | false

## ADVANCED VISUALIZATION CONFIGURATION PARAMETERS
advanced_vis_config: 'Highcharts JSON snippet'

Parameterdefinitionen

Parametername	Beschreibung
Grundlegende Parameter
`name` (für Elemente)	Erstellt ein Element
`title` (für Elemente)	Ändert die Art und Weise, wie ein Elementname Nutzern angezeigt wird
`type` (für Elemente)	Bestimmt den Typ der Visualisierung, die 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 den Explore, der 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
`limit`	Definiert die Zeilenbegrenzung, 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.
`hidden_fields`	Gibt Felder an, die in der Abfrage verwendet, aber im Diagramm ausgeblendet werden sollen.
Parameter für Reihen
`color_application`	Wendet eine Farbkollektion und ‑vorlage auf das Diagramm an.
Stilparameter
`show_view_names`	Ansichtsnamen in Diagrammlabels ein- oder ausblenden
Parameter der X‑Achse
`show_x_axis_label`	Blendet die Beschriftung der X-Achse ein oder aus
`x_axis_label`	Definiert ein benutzerdefiniertes Label für die X‑Achse.
`show_x_axis_ticks`	Werte auf der x-Achse anzeigen
`x_axis_gridlines`	Gitternetzlinien von der X-Achse aus verlängern
`x_axis_reversed`	Kehrt die Richtung der X-Achse um.
`x_axis_zoom`	Gibt an, ob das Zoomen entlang der X-Achse zulässig ist.
Parameter der Y-Achse
`show_y_axis_labels`	Blendet die Beschriftung der y-Achse ein oder aus
`y_axis_labels`	Definiert ein benutzerdefiniertes Y-Achsenlabel
`show_y_axis_ticks`	Werte auf der y-Achse anzeigen
`y_axis_gridlines`	Erweitert die Gitternetzlinien der y-Achse
`y_axis_min`	Definiert einen Mindestwert für die Y-Achse.
`y_axis_max`	Definiert einen Höchstwert für die Y-Achse.
`y_axis_tick_density`	Ermöglicht das Festlegen einer benutzerdefinierten Dichte der Y-Achsen-Teilstriche mit dem Parameter `y_axis_tick_density_custom`.
`y_axis_tick_density_custom`	Definiert die Dichte der Y-Achsen-Teilstriche, wenn `y_axis_tick_density` auf `custom` festgelegt ist.
`y_axis_reversed`	Kehrt die Richtung der Y-Achse um.
`y_axis_value_format`	Definiert das Zahlenformat der Werte auf der Y-Achse.
`y_axis_zoom`	Gibt an, ob das Zoomen entlang der Y-Achse zulässig ist. Deaktiviert, wenn `x_axis_zoom: false`.
Parameter für die erweiterte Visualisierungskonfiguration
`advanced_viz_config`	Akzeptiert einen HighCharts-JSON-Snippet, mit dem mehrere Visualisierungseinstellungen überschrieben werden können.

Grundlegende Parameter

Wenn Sie ein LookML-Dashboardelement definieren, müssen Sie Werte für mindestens 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 wird auf den Parameter name verwiesen, 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 referenziert, wenn Sie layout: grid-Dashboards verwenden.

- name: orders_by_date

`title`

In diesem Abschnitt wird auf den Parameter title verwiesen, 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 wird auf den Parameter type verwiesen, 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 einer Measure verwendet werden, wie auf der Dokumentationsseite Measure-Typen beschrieben.

Mit dem Parameter type wird der Visualisierungstyp festgelegt, 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

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

`height`

In diesem Abschnitt wird auf den Parameter height verwiesen, 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 dem Layout `newspaper`

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

Bei einem Dashboard mit Zeitungs-Layout wird standardmäßig eine Elementhöhe von 6 Zeilen oder etwa 300 Pixeln verwendet. 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 2 Zeilen für Dashboards, bei denen der Parameter preferred viewer auf dashboards festgelegt ist.

Mit dem folgenden Code wird beispielsweise festgelegt, dass ein Element 12 Zeilen hoch sein soll, 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 wird auf den Parameter width verwiesen, 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 Element orders_by_date eine Breite von 400 Pixeln erhält.

- dashboard: sales_overview
  tile_size: 100
  ...

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

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

Ein Dashboard mit Zeitungsformat 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 die obere Kante 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 werden beispielsweise tile_size: 100 und left: 4 angegeben. Dadurch wird die linke Kante des orders_by_date-Elements 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 der obere Rand 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 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 definiert der Parameter col die Spalte, 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 wird auf den Parameter refresh verwiesen, 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 hinter dem Element 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`

Mit dem Unterparameter text wird der Text angegeben, der in der Notiz angezeigt wird. Der Text kann lokalisiert werden.

`state`

Mit dem Unterparameter state wird festgelegt, ob die Anmerkung collapsed oder expanded wird, 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 Anmerkung oben in einem Element platziert, mit below unten in einem Element und mit hover muss der Nutzer den Mauszeiger auf das Element bewegen, um die Anmerkung zu sehen.

Suchparameter

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

Für Elemente von type: looker_boxplot ist außerdem mindestens eine Dimension und entweder zwei, drei oder fünf der folgenden Arten von Messwerten erforderlich (die in dieser Reihenfolge aufgeführt sein müssen):

Minimum: Ein Maß für den niedrigsten Datenwert. In LookML kann dies als Measure type: min definiert werden.
25. Perzentil: Ein Messwert, der das 25. Perzentil oder das erste Quartil darstellt. Ein Viertel Ihrer Datenwerte ist kleiner oder gleich diesem Wert. Dies kann in LookML als Messwert vom Typ type: percentile mit dem Wert für percentile auf 25 festgelegt werden.
Median: Ein Maß für den Median oder Mittelpunkt des Datasets oder das zweite Quartil. Die Hälfte Ihrer Datenwerte ist kleiner oder gleich diesem Wert. In LookML kann dies als Measure type: median definiert werden.
75. Perzentil: Ein Maß für das 75. Perzentil oder das dritte Quartil. Drei Viertel Ihrer Datenwerte sind kleiner oder gleich diesem Wert. Dies kann in LookML als Messwert vom Typ type: percentile mit dem Wert für percentile auf 75 festgelegt werden.
Maximum: Ein Maß für den Maximalwert. In LookML kann dies als Measure type: max definiert werden.

Mit dem Parameter fields oder den beiden Parametern dimensions und measures können Sie die Dimensionen und Messwerte angeben, auf denen ein Boxplot-Element basiert. Weitere Informationen zum Erstellen eines Boxplot-Diagramms in der Looker-Benutzeroberfläche finden Sie im Abschnitt Boxplot-Diagramm erstellen auf der Dokumentationsseite Optionen für Boxplot-Diagramme.

Mit den anderen in diesem Abschnitt beschriebenen Abfrageparametern können Sie die Darstellung von Daten in einem Dashboard-Element steuern.

`model`

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

- name: orders_by_date
  model: ecommerce

Für den Parameter model sind LookML-Konstanten zulässig. Sie können eine Konstante in der Manifestdatei für Ihr Projekt definieren und dann mit der Syntax "@{constant_name}" die Konstante als Wert für model festlegen. 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 wird auf den Parameter explore verwiesen, 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.

Mit dem Parameter explore wird der Explore definiert, der für die Elementabfrage verwendet werden soll.

- name: orders_by_date
  explore: order

Für den Parameter explore sind LookML-Konstanten zulässig. Sie können eine Konstante in der Manifestdatei für Ihr Projekt definieren und dann mit der Syntax "@{constant_name}" die Konstante als Wert für explore festlegen. 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, der 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`

Mit dem Parameter dimensions werden die Dimensionen definiert, die für die Elementabfrage verwendet werden sollen. Verwenden Sie die Syntax view_name.dimension_name, um die Dimension anzugeben. Geben Sie dimensions nicht an, wenn die Abfrage 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`

Mit dem Parameter measures werden die Messwerte definiert, die für die Elementabfrage verwendet werden sollen. Verwenden Sie die Syntax view_name.measure_name, um die Messung anzugeben. Geben Sie measures nicht an, wenn die Abfrage 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`

Mit dem Parameter sorts wird das Sortierverhalten für die Abfrage des Elements definiert. Geben Sie zuerst das primäre Sortierfeld und dann alle sekundären Sortierfelder an. Verwenden Sie die view_name.field_name-Syntax, um die Dimension oder den Messwert anzugeben, nach dem sortiert werden soll.

Wenn Sie den Parameter sorts weglassen, wird die Standardsortierreihenfolge von Looker verwendet. Für aufsteigende Sortierungen ist kein Suffix erforderlich, für absteigende Sortierungen das Suffix desc.

Im folgenden Beispiel wird eine einzelne Sortierung definiert:

- name: orders_by_date
  sorts: order.order_date desc

Im folgenden Beispiel werden mehrere Sortierungen definiert:

- name: orders_by_date
  sorts: [order.order_date desc, customer.name]

Wenn Sie Dimensionen als Drehpunkt festlegen, können Sie Abfrageergebnisse sortieren, indem Sie den Messwertnamen, die Sortierrichtung und die nullbasierte Indexnummer der Zielspalte in der Datentabelle angeben. Im folgenden Beispiel wird nach der ersten Pivot-Spalte sortiert. Dazu wird der Index 0 verwendet:

- name: orders_by_category
  sorts: [orders.count desc 0]

Wenn Sie nach der Zeilensumme sortieren möchten, geben Sie den Index der Spalte mit den Gesamtsummen an. Mit dem folgenden Element wird beispielsweise nach der Zeilensumme sortiert. Dazu wird der Index 2 verwendet, der die Spalte „Summen“ für eine Abfrage mit zwei Pivot-Spalten darstellt:

- name: orders_by_cohort
  sorts: [users.count desc 2]

`limit`

Der Parameter limit definiert die Zeilenbegrenzung, die 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

`filters`

In diesem Abschnitt wird auf den Parameter filters verwiesen, 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

Jeder Filter kann einen Looker-Filterausdruck oder eine Wertkonstante akzeptieren. 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. Definieren Sie Dashboard-Filter mit dem filters-Parameter für LookML-Dashboards. 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
    ...

Wenn der Filter, auf den gewartet wird, mit dem Parameter vis_filter: true konfiguriert ist, wird das Filtersteuerelement in einer Filterleiste direkt oben auf der Visualisierungskachel und nicht in der oberen Dashboard-Filterleiste angezeigt.

Weitere Beispiele für die Verwendung des Parameters filters und des Parameters listen zum Anwenden von Dashboardfiltern auf einzelne Dashboardelemente 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

`hidden_fields`

Mit dem Parameter hidden_fields wird angegeben, welche Felder in der Abfrage verwendet, aber im Diagramm ausgeblendet werden. Alle ausgeblendeten Felder werden im Datentabellenbereich eines Explores angezeigt.

hidden_fields: [inventory_items.count, distribution_centers.id]

Parameter für Reihen

`color_application`

Mit dem Parameter color_application und seinen Unterparametern collection_id und palette_id können Sie eine bestimmte Farbsammlung und ‑palette auf ein Dashboard-Element anwenden. Eine Übersicht über die nativen Farbkollektionen von Looker finden Sie auf der Dokumentationsseite Farbkollektionen.

Wenn Sie die Sammlungs-ID und die Paletten-ID für die Palette haben, die Sie verwenden möchten, können Sie diese IDs in die Unterparameter collection_id und palette_id eingeben. Eine Sammlungs-ID oder eine Paletten-ID kann ein alphanumerischer Code sein oder auf dem Namen der Farbsammlung basieren. Für die nativen Sammlungen von Looker werden alphanumerische Codes verwendet. Sie sind instanzspezifisch und sehen so aus:


color_application:
  collection_id: 1297dk12-86a7-4xe0-8dfc-82de20b3806a
  palette_id: 93c8aeb7-3f8a-4ca7-6fee-88c3617516a1

Für benutzerdefinierte Farbsammlungen werden Sammlungs- und Paletten-IDs basierend auf dem Namen der Farbsammlung verwendet, die instanzübergreifend übertragbar sind und so aussehen:


color_application:
  collection_id: blue-tone-collection
  palette_id: blue-tone-collection-categorical-0

Sie können auch die Benutzeroberfläche verwenden, um die gewünschten Farben, Sammlungen oder Paletten zu finden und den LookML-Code zu generieren, um sie Ihrem Dashboard hinzuzufügen. Rufen Sie einen benutzerdefinierten Inhalt (z. B. einen Look, ein Dashboard oder ein Explore) auf und wenden Sie die gewünschten Farben, Sammlungen oder Paletten über die Benutzeroberfläche auf die Visualisierung des Inhalts an. Anschließend können Sie die Schritte zum Abrufen von Dashboard-LookML ausführen, den generierten LookML-Code kopieren und in den Abschnitt color_application einfügen.

Standardmäßig wird die erste Farbe der zugewiesenen Palette auf das gesamte Boxplot-Element angewendet. Mit dem optionalen Unterparameter reverse wird die Anwendung auf die letzte Farbe in der Palette umgeschaltet.

color_application:
  collection_id: blue-tone-collection
  palette_id: blue-tone-collection-categorical-0
  options:
    reverse: true

Stilparameter

`show_view_names`

Mit dem Parameter show_view_names wird festgelegt, ob Ansichtsnamen in Diagrammlabels wie Achsen- und Spaltennamen angezeigt werden.

show_view_names: true | false

## default value: true

Parameter der X‑Achse

`show_x_axis_label`

Mit diesem Parameter wird festgelegt, ob das Label der x-Achse angezeigt wird.

show_x_axis_label: true | false

## default value: true

`x_axis_label`

Mit diesem Parameter wird ein Label für die X-Achse angegeben. Sie können diesen Parameter verwenden, wenn show_x_axis_label auf true festgelegt ist.

x_axis_label: Order Date

`show_x_axis_ticks`

Mit diesem Parameter wird festgelegt, ob Wertelabels auf der x-Achse angezeigt werden.

show_x_axis_ticks: true | false

## default value: true

`x_axis_gridlines`

Mit diesem Parameter wird festgelegt, ob die Gitternetzlinien von der X-Achse aus verlängert werden.

x_axis_gridlines: true | false

## default value: false

`x_axis_reversed`

Mit diesem Parameter wird die Richtung der X-Achse festgelegt. Wenn x_axis_reversed auf false festgelegt ist, nehmen die Werte von links nach rechts zu. Wenn sie auf true gesetzt ist, nehmen die Werte von links nach rechts ab.


x_axis_reversed: true | false

`x_axis_zoom`

Mit diesem Parameter wird angegeben, ob Nutzer die X-Achse der Visualisierung vergrößern können. Wenn x_axis_zoom auf true eingestellt ist, ist das Zoomen möglich. Wenn x_axis_zoom auf false gesetzt ist, ist das Zoomen nicht verfügbar.

Wenn x_axis_zoom auf false gesetzt ist, ist y_axis_zoom deaktiviert.

x_axis_zoom: true | false

# default value: true

Parameter der Y-Achse

`show_y_axis_labels`

Mit diesem Parameter wird festgelegt, ob Labels auf der Y-Achse angezeigt werden.

show_y_axis_labels: true | false

## default value: true

y_axis_labels

Mit diesem Parameter wird ein Label für die Y-Achse angegeben. Sie können diesen Parameter verwenden, wenn show_y_axis_labels auf true festgelegt ist.

y_axis_labels: ['label']

`show_y_axis_ticks`

Mit diesem Parameter wird festgelegt, ob Werte auf der y-Achse angezeigt werden.

show_y_axis_ticks: true | false

## default value: true

`y_axis_gridlines`

Mit diesem Parameter wird festgelegt, ob Rasterlinien von der y-Achse aus verlängert werden.

y_axis_gridlines: true | false

## default value: true

`y_axis_min`

Mit diesem Parameter wird der Mindestwert für die Y-Achse definiert.

y_axis_min: ['10']

## default value: true

`y_axis_max`

Mit diesem Parameter wird der Höchstwert für die Y-Achse definiert.

y_axis_max: ['100']

## default value: true

`y_axis_tick_density`

Mit diesem Parameter können Sie die Dichte der Y-Achsen-Teilstriche festlegen. Setzen Sie y_axis_tick_density auf custom, um diese Funktion zu aktivieren. Verwenden Sie dann den Parameter y_axis_tick_density_custom, um die Dichte festzulegen.

y_axis_tick_density: default | custom

## default value: default

`y_axis_tick_density_custom`

Mit diesem Parameter können Sie die Dichte der Y-Achsen-Teilstriche festlegen, wenn y_axis_tick_density auf custom gesetzt ist. Es wird eine Ganzzahl akzeptiert, die die Anzahl der Ticks angibt, die angezeigt werden sollen.

y_axis_tick_density_custom: 10

## default value: 5

`y_axis_reversed`

Mit diesem Parameter wird die Richtung der y-Achse festgelegt. Wenn y_axis_reversed auf false gesetzt ist, nehmen die Werte nach oben hin zu. Wenn sie auf true gesetzt ist, nehmen die Werte ab, wenn Sie sich auf der Achse nach unten bewegen.


## y_axis_reversed: true | false

# default value: false

`y_axis_value_format`

Mit diesem Parameter wird das Zahlenformat der Werte auf der Y-Achse unabhängig von der zugrunde liegenden Dimension oder dem zugrunde liegenden Measure angegeben. Für den Parameter ist eine Formatierung im Excel-Stil zulässig. Wenn keine Formatierung angegeben ist, wird der Wert im Format der zugrunde liegenden Dimension oder Messzahl angezeigt.

Der Wert, den Sie für den Parameter y_axis_value_format angeben, muss in doppelte Anführungszeichen gesetzt werden:


y_axis_value_format: "*00#.00"

Eine vollständige Anleitung zum Angeben dieser Formate finden Sie in der Dokumentation von Excel. Zu diesem Zeitpunkt werden jedoch die Datumsformatierung und Farbformatierung in Looker nicht unterstützt.

Nachfolgend sind einige der gängigsten Formatierungsoptionen aufgeführt:

Werteformat	Bedeutung
`#`	Ganzzahl (123)
`*00#`	Ganzzahl, mit Nullen auf 3 Stellen gefüllt (001)
`0.##`	Zahl mit bis zu 2 Dezimalstellen (1. oder 1,2 oder 1,23)
`0.00`	Zahl mit genau 2 Dezimalstellen (1,23)
`*00#.00`	Zahl, mit Nullen auf 3 Stellen gefüllt und genau 2 Dezimalstellen (01,23)
`#,###`	Zahl mit Punkt als Tausendertrenner (1.234)
`#,##0.00`	Zahl mit Punkt als Tausendertrenner und 2 Dezimalstellen (1.234,00)
`0.000,," M"`	Zahl in Millionen mit 3 Dezimalstellen (1.234 Mio.). Die Division durch 1 Million erfolgt automatisch.
`$#`	Dollar mit 0 Dezimalstellen (123 $)
`$0.00`	Dollar mit 2 Dezimalstellen (123,00 $)
`$#,##0.00`	Dollar mit Punkt als Tausendertrenner und 2 Dezimalstellen (1.234,00 $)
`#%`	Prozentangabe mit 0 Dezimalstellen (1%). Die Multiplikation mit 100 erfolgt automatisch.
`0.00%`	Prozentangabe mit 2 Dezimalstellen (1,00%). Die Multiplikation mit 100 erfolgt automatisch.
`0.00\%`	Prozentangabe mit 2 Dezimalstellen (1,00%). Die Multiplikation mit 100 erfolgt NICHT automatisch.

`y_axis_zoom`

Mit diesem Parameter wird angegeben, ob Nutzer die Y-Achse der Visualisierung vergrößern können. Wenn y_axis_zoom auf true eingestellt ist, ist das Zoomen möglich.

Wenn y_axis_zoom auf false festgelegt ist, können Nutzer nicht in kleinere Abschnitte der y-Achse zoomen. Nutzer können jedoch weiterhin in kleinere Abschnitte der X-Achse zoomen, wenn der Parameter x_axis_zoom auf true festgelegt ist.

Wenn x_axis_zoom auf false gesetzt ist, wird y_axis_zoom deaktiviert.

y_axis_zoom: true | false

# default value: true

Erweiterte Konfiguration der Visualisierung

Die in diesem Abschnitt beschriebenen Parameter entsprechen den optionalen Überschreibungen der Diagrammkonfiguration, die Sie auf ein Diagramm anwenden können, indem Sie im Visualisierungseditor im Bereich Diagramm auf die Schaltfläche Diagrammkonfiguration bearbeiten klicken.

`advanced_vis_config`

Dieser Parameter akzeptiert einen HighCharts-JSON-Snippet, mit dem mehrere Visualisierungseinstellungen überschrieben werden und neue Funktionen verfügbar werden. Auf der Dokumentationsseite Visualisierungen mit dem Chart Config Editor anpassen finden Sie Beispiele für die Verwendung von HighCharts-JSON für gängige Anwendungsfälle.


advanced_vis_config: "{ series: [{ formatters: [{ select: 'value >= 50', style: { color: 'orange' } }]}]}"

# This example changes the color to orange for any series value that is greater than or equal to 50.

# default value: null

Parameter für Boxplot-Diagramme für LookML-Dashboards Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Nutzungsbeispiel

Parameterdefinitionen

Grundlegende Parameter

name

title

type

height

Für Dashboards mit tile- oder static-Layouts

Für Dashboards mit dem Layout newspaper

width

top

left

row

col

refresh

note

text

state

display

Suchparameter

model

explore

fields

dimensions

measures

sorts

limit

filters

listen

query_timezone

hidden_fields