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

Auf dieser Seite wird beschrieben, 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 Box-Plots über die Looker-Benutzeroberfläche finden Sie auf der Dokumentationsseite Optionen für Box-Plots.

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 für Nutzer 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 Zeilen 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
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 Dashboard) erstellt wurden
query_timezone	Definiert die Zeitzone, die beim Ausführen der Abfrage verwendet werden soll
hidden_fields	Gibt alle Felder an, die in der Abfrage verwendet, aber im Diagramm ausgeblendet werden sollen
Reihenparameter
color_application	Wendet eine Farbkollektion und -palette auf das Diagramm an
Stilparameter
show_view_names	Blendet Ansichtsnamen in Diagrammbezeichnungen ein oder aus
Parameter für die 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	Zeigt Werte auf der X-Achse an
x_axis_gridlines	Erweitert die Gitternetzlinien von der X-Achse
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
Y-Achsenparameter
show_y_axis_labels	Blendet das Label der Y-Achse ein oder aus
y_axis_labels	Definiert ein benutzerdefiniertes Label für die Y-Achse
show_y_axis_ticks	Zeigt Werte auf der Y-Achse an
y_axis_gridlines	Erweitert die Gitternetzlinien von 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	Aktiviert die Option, mit dem Parameter y_axis_tick_density_custom eine benutzerdefinierte Markierungsdichte für die Y-Achse festzulegen
y_axis_tick_density_custom	Definiert die Dichte der Teilstriche auf der Y-Achse, 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.
Erweiterte Konfigurationsparameter für Visualisierungen
advanced_viz_config	Akzeptiert ein HighCharts-JSON-Snippet, mit dem mehrere Visualisierungseinstellungen überschrieben werden können

Grundlegende Parameter

Wenn Sie ein LookML-Dashboard-Element 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 das Erscheinungsbild und die 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 Dashboard-Filters verwendet werden, wie auf der Dokumentationsseite Dashboard-Parameter beschrieben.

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, oder im Parameter group von untergeordneten Elementen, wenn Sie Elemente in einer Kachelgruppe (type: group) organisieren.

- 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, wie auf der Dokumentationsseite Dashboard-Parameter beschrieben.

title kann auch als Teil eines Dashboard-Filters verwendet werden, wie auf der Dokumentationsseite Dashboard-Parameter beschrieben.

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

Betrachten Sie dieses Beispiel:

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

Wenn Sie dieses Format verwenden, 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 Dashboard-Filters verwendet werden, wie auf der Dokumentationsseite Dashboard-Parameter beschrieben.

type kann auch als Teil eines Joins verwendet werden, wie auf der Dokumentationsseite für den Parameter type (für Joins) beschrieben.

type kann auch als Teil einer Dimension verwendet werden, wie auf der Dokumentationsseite Dimensionen, Filter und Parametertypen beschrieben.

type kann auch als Teil einer Measure verwendet werden, wie auf der Dokumentationsseite Measure-Typen 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 | button | group

Eine Übersicht ü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, wie auf der Dokumentationsseite Dashboard-Parameter beschrieben.

Für Dashboards mit tile- oder static-Layouts

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

Im folgenden Code werden beispielsweise tile_size: 100 und height: 4 angegeben, sodass das orders_by_date-Element 400 Pixel hoch ist.

- dashboard: sales_overview
  tile_size: 100
  ...

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

Für Dashboards mit newspaper-Layout

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

Bei einem Dashboard mit Zeitungslayout beträgt die Standardhöhe eines Elements 6 Zeilen oder etwa 300 Pixel. Die Mindesthöhe beträgt 1 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 ein Element auf eine Höhe von 12 Zeilen festgelegt, also doppelt so hoch wie andere Elemente, für die die Standardeinstellung gilt:

- 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, wie auf der Dokumentationsseite Dashboard-Parameter beschrieben.

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, sodass das orders_by_date-Element 400 Pixel breit ist.

- 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 Zeitungsformat hat standardmäßig eine Breite von 24 Spalten.

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

- dashboard: sales_overview
  layout: newspaper
  ...

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

top

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

Im folgenden Code werden beispielsweise tile_size: 100 und top: 4 angegeben, wodurch die Oberkante des orders_by_date-Elements 400 Pixel vom oberen Rand des Dashboards entfernt positioniert wird.

- 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, wodurch der linke Rand des orders_by_date-Elements 400 Pixel von der linken Seite des Dashboards entfernt positioniert wird.

- dashboard: sales_overview
  tile_size: 100
  ...

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

row

Bei layout: newspaper-Dashboards definiert der Parameter row die Zeile, in der sich der obere Rand eines Elements befindet. Wenn das Element mithilfe des Parameters group in einer Kachelgruppe platziert wird, definiert row die Zeilenposition des Elements relativ zum oberen Rand des Gruppencontainers (row: 0).

Ein Dashboard beginnt mit Zeile 0 oben im Dashboard. Bei einem Dashboard mit Zeitungslayout beträgt die Standardhöhe eines Elements 6 Zeilen. Das bedeutet, dass die Dashboard-Elemente oben im Dashboard (row: 0) 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 festgelegt, vorausgesetzt, die Elemente sind auf die Standardhöhe eingestellt:

- dashboard: sales_overview
  layout: newspaper
  ...

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

col

Bei layout: newspaper-Dashboards definiert der Parameter col die Spalte, in der sich der linke Rand des Elements befindet. Wenn das Element mit dem Parameter group in einer Kachelgruppe platziert wird, definiert col die Spaltenposition des Elements relativ zum linken Rand des Gruppencontainers (col: 0).

Dashboards sind in 24 Spalten unterteilt. Ein Dashboard beginnt mit Spalte 0 auf der linken Seite des Dashboards. Ein Dashboard mit Zeitungs-Layout hat standardmäßig eine Elementbreite von 8 Spalten. Das bedeutet, dass die Dashboard-Elemente links im Dashboard (col: 0) standardmäßig die Spalten 0–7 einnehmen.

Mit dem folgenden Code wird beispielsweise ein Element in der dritten Spalte der Elemente im Dashboard festgelegt:

- 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, wie auf der Dokumentationsseite Dashboard-Parameter beschrieben.

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. Beachten Sie, dass das Dashboard in einem Browserfenster geöffnet sein muss, damit dieser Parameter wirksam wird. Diese Einstellung wird nicht im Hintergrund ausgeführt, um den Dashboard-Cache „vorzuwärmen“.

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

Sie können Elementen wie folgt beschreibende Notizen hinzufügen:

- 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

Der Unterparameter state bestimmt, ob die Notiz collapsed oder expanded wird, wenn sie zu groß ist, um in eine einzelne Zeile innerhalb der Breite des Elements zu passen. Wenn Sie collapsed auswählen und die Notiz zu lang ist, endet sie mit anklickbaren Auslassungspunkten (...), über die die vollständige Notiz gelesen werden kann.

display

Mit dem Unterparameter display wird festgelegt, wo die Notiz auf einem Element angezeigt wird. Mit above wird die Notiz 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 Notiz zu sehen.

Suchparameter

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

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

• Minimum: Ein Messwert, der den niedrigsten Datenwert darstellt. Dies kann in LookML als Measure vom Typ 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 definiert werden, wobei der Wert für percentile auf 25 festgelegt ist.
• Median: Ein Maß, das den Medianwert oder Mittelpunkt des Datasets oder das zweite Quartil darstellt. Die Hälfte Ihrer Datenwerte ist kleiner oder gleich diesem Wert. Dies kann in LookML als Measure vom Typ type: median definiert werden.
• 75. Perzentil: Ein Messwert, der das 75. Perzentil oder das dritte Quartil darstellt. Drei Viertel Ihrer Datenwerte sind kleiner oder gleich diesem Wert. Dies kann in LookML als Messwert vom type: percentile definiert werden, wobei der Wert für percentile auf 75 festgelegt ist.
• Maximum: Ein Messwert, der den Maximalwert darstellt. Dies kann in LookML als Measure vom Typ type: max definiert werden.

Sie können den Parameter fields oder die beiden Parameter dimensions und measures verwenden, um die Dimensionen und Messwerte anzugeben, auf denen ein Boxplot-Element basiert. Weitere Informationen zum Erstellen eines Box-Plots in der Looker-Benutzeroberfläche finden Sie im Abschnitt Box-Plot erstellen auf der Dokumentationsseite Optionen für Box-Plots.

Sie können die anderen in diesem Abschnitt beschriebenen Suchparameter verwenden, um die Darstellung der Daten in einem Dashboard-Element zu steuern.

model

Der Parameter model definiert das Modell, das für die Elementabfrage verwendet werden soll. Wenn nicht angegeben, 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 in der Manifestdatei für Ihr Projekt eine Konstante definieren und dann die Syntax "@{constant_name}" verwenden, um die Konstante als Wert für model festzulegen. Mit einer Konstante können Sie den Namen eines Modells an einer Stelle 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 Dashboard-Filters verwendet werden, wie auf der Dokumentationsseite Dashboard-Parameter beschrieben.

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

- name: orders_by_date
  explore: order

Der Parameter explore akzeptiert LookML-Konstanten. Sie können in der Manifestdatei für Ihr Projekt eine Konstante definieren und dann die Syntax "@{constant_name}" verwenden, um die Konstante als Wert für explore festzulegen. Mit einer Konstante können Sie den Namen eines Explores an einer Stelle 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

Der Parameter dimensions definiert die Dimension oder Dimensionen, 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 hinzu, 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 wird der Messwert oder werden die Messwerte definiert, 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 hinzu, 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

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

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

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 pivotieren, können Sie die Abfrageergebnisse sortieren, indem Sie den Namen des Messwerts, die Sortierrichtung und die nullbasierte Indexnummer der Zielspalte in der Datentabelle angeben. Im folgenden Beispiel wird nach der ersten Pivot-Spalte mit dem Index 0 sortiert:

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

Wenn Sie nach der Zeilensumme sortieren möchten, geben Sie den Index der Summenspalte an. Mit dem folgenden Element wird beispielsweise nach der Zeilensumme sortiert. Dazu wird der Index 2 verwendet, der die Summenspalte 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 geht es um den Parameter filters, der Teil eines Dashboard-Elements ist.

filters kann auch als Teil eines Dashboards verwendet werden, wie auf der Dokumentationsseite Dashboard-Parameter beschrieben.

filters kann auch als Teil einer Messung verwendet werden, wie auf der Dokumentationsseite zum Parameter filters beschrieben.

Mit dem Parameter filters werden die nicht änderbaren 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 für flexible Filterwerte verwenden.

listen

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

Die Syntax für listen lautet:

- 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 an, gefolgt von einem Doppelpunkt und einem Verweis auf das Feld, 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. Anschließend können Sie den vom Nutzer eingegebenen Wert 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 gelauscht wird, mit dem Parameter vis_filter: true konfiguriert ist, wird das Filter-Steuerelement in einer Filterleiste direkt oben auf der Visualisierungskachel und nicht in der oberen Dashboard-Filterleiste angezeigt.

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

query_timezone

Der Parameter query_timezone gibt die Zeitzone an, 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 user_timezone zuweisen.

- name: orders_by_date
  query_timezone: America/Los Angeles

- name: orders_by_customer
  query_timezone: user_timezone

hidden_fields

Der Parameter hidden_fields gibt an, 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]

Reihenparameter

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 Farbpaletten von Looker finden Sie auf der Dokumentationsseite Farbpaletten.

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 Kollektions-ID oder eine Paletten-ID kann ein alphanumerischer Code sein oder auf dem Namen der Farbkollektion 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

Benutzerdefinierte Farbsammlungen verwenden Sammlungs- und Paletten-IDs, die auf dem Namen der Farbsammlung basieren. Diese IDs sind instanzübergreifend übertragbar und sehen so aus:

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 die LookML zu generieren, um sie Ihrem Dashboard hinzuzufügen. Rufen Sie einen benutzerdefinierten Inhalt auf, z. B. einen Look, ein Dashboard oder ein Explore, und wenden Sie die gewünschten Farben, die gewünschte Sammlung oder die gewünschte Palette ü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 erstellten LookML-Code kopieren und in den Abschnitt color_application einfügen.

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

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

Stilparameter

show_view_names

Der Parameter show_view_names bestimmt, ob Ansichtsnamen in Diagrammlabels wie Achsen- und Spaltennamen angezeigt werden.

show_view_names: true | false

## default value: true

Parameter für die X-Achse

show_x_axis_label

Dieser Parameter bestimmt, ob das Label der x-Achse angezeigt wird.

show_x_axis_label: true | false

## default value: true

x_axis_label

Dieser Parameter gibt ein Label für die x-Achse an. 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 Wertlabels auf der X-Achse angezeigt werden.

show_x_axis_ticks: true | false

## default value: true

x_axis_gridlines

Dieser Parameter bestimmt, ob 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, steigen die Werte von links nach rechts. Wenn der Wert 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 heranzoomen können. Wenn x_axis_zoom auf true festgelegt ist, ist Zoomen möglich. Wenn x_axis_zoom auf false festgelegt 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

Y-Achsenparameter

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

Dieser Parameter gibt ein Label für die Y-Achse an. Sie können diesen Parameter verwenden, wenn show_y_axis_labels auf true festgelegt ist.

y_axis_labels: ['label']

show_y_axis_ticks

Dieser Parameter bestimmt, 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 Gitternetzlinien von der Y-Achse aus verlängert werden.

y_axis_gridlines: true | false

## default value: true

y_axis_min

Dieser Parameter definiert den Mindestwert für die Y-Achse.

y_axis_min: ['10']

## default value: true

y_axis_max

Dieser Parameter definiert den Höchstwert für die Y-Achse.

y_axis_max: ['100']

## default value: true

y_axis_tick_density

Mit diesem Parameter wird die Option zum Festlegen einer Markierungsdichte für die Y-Achse aktiviert. Setzen Sie y_axis_tick_density auf custom, um diese Funktion zu aktivieren, und 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 Teilstriche auf der Y-Achse festlegen, wenn y_axis_tick_density auf custom gesetzt ist. Es wird eine Ganzzahl akzeptiert, die die Anzahl der Markierungen 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 festgelegt ist, steigen die Werte auf der Achse nach oben. Wenn der Wert auf true gesetzt ist, nehmen die Werte auf der Achse nach unten hin ab.

## y_axis_reversed: true | false

# default value: false

y_axis_value_format

Dieser Parameter gibt das Zahlenformat der Werte auf der Y-Achse an, unabhängig von der zugrunde liegenden Dimension oder dem zugrunde liegenden Measure. Der Parameter akzeptiert die Formatierung im Excel-Stil. Wenn keine Formatierung angegeben ist, wird der Wert im Format der zugrunde liegenden Dimension oder des zugrunde liegenden Measures 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 Festlegen dieser Formate finden Sie in der Excel-Dokumentation. 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 M). Die Division durch 1 Mio. 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 $)
#%	Prozent mit 0 Dezimalstellen (1 %). Die Multiplikation mit 100 erfolgt automatisch.
0.00%	Prozent mit zwei Dezimalstellen (1,00 %). Die Multiplikation mit 100 erfolgt automatisch.
0.00\%	Prozent mit zwei 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 heranzoomen können. Wenn y_axis_zoom auf true festgelegt ist, ist Zoomen möglich.

Wenn y_axis_zoom auf false festgelegt ist, können Nutzer nicht in kleinere Bereiche der Y-Achse hineinzoomen. Nutzer können jedoch möglicherweise weiterhin in kleinere Teile der X-Achse hineinzoomen, wenn der Parameter x_axis_zoom auf true festgelegt ist.

Wenn x_axis_zoom auf false gesetzt ist, ist y_axis_zoom deaktiviert.

y_axis_zoom: true | false

# default value: true

Erweiterte Visualisierungskonfiguration

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

advanced_vis_config

Dieser Parameter akzeptiert ein HighCharts-JSON-Snippet, das mehrere Visualisierungseinstellungen überschreibt und neue Funktionen ermöglicht. Beispiele für die Verwendung von HighCharts-JSON für gängige Anwendungsfälle finden Sie auf der Dokumentationsseite Visualisierungen mit dem Diagrammkonfigurationseditor anpassen.

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