Parameter für Tabellendiagramme (Legacy) für LookML-Dashboards

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

Informationen zum Erstellen eines Tabellendiagramms (alt) über die Looker-Benutzeroberfläche finden Sie auf der Dokumentationsseite Tabellendiagrammoptionen (alt).

Nutzungsbeispiel

## BASIC PARAMETERS
name: element_name
title: 'Element Title'
type: looker_table
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
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' | 'filter value'
listen:
  dashboard_filter_name: dimension_or_measure_name
query_timezone: 'specific timezone' | user_timezone
merged_queries:
- 'primary query definition'
- 'next source query definition'
  join_fields:
  - field_name: view_name.field_name
    source_field_name: view_name.field_name

## PLOT PARAMETERS
table_theme: editable | white | gray | transparent | unstyled
total: true | false
row_total: right | left | false
show_row_numbers: true | false
hide_totals: true | false
hide_row_totals: true | false
hidden_fields: [view_name.field_name, view_name.field_name, …]
limit_displayed_rows: true | false
limit_displayed_rows_values:
  show_hide: show | hide
  first_last: first | last
  num_rows: 'N'

## SERIES PARAMETERS
truncate_column_names: true | false
show_view_names: true | false
series_labels:
  view_name.field_name: desired series label

## FORMATTING PARAMETERS
enable_conditional_formatting: true | false
conditional_formatting_include_totals: true | false
conditional_formatting_include_nulls: true | false
conditional_formatting:
  {'desired conditional formatting'}

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
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 pivotiert 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.
merged_queries	Definiert eine Abfrage mit zusammengeführten Ergebnissen.
Diagrammparameter
table_theme	Wendet eine von fünf Tabellenfarboptionen auf eine Tabellendarstellung an.
total	Gibt an, ob für eine Tabellenvisualisierung Spaltensummen angezeigt werden
row_total	Gibt an, ob Zeilensummen für eine Tabellenvisualisierung angezeigt werden
show_row_numbers	Legt fest, ob am Anfang jeder Tabellenzeile eine Zeilennummer angezeigt werden soll.
hide_totals	Legt fest, ob in einer Tabellenvisualisierung Spaltensummen angezeigt werden.
hide_row_totals	Legt fest, ob in einer Tabellenvisualisierung Zeilensummen angezeigt werden.
hidden_fields	Gibt Felder an, die in der Abfrage verwendet, aber im Diagramm ausgeblendet werden sollen.
limit_displayed_rows	Zeigt oder blendet Zeilen in einer Visualisierung basierend auf ihrer Position in den Ergebnissen ein oder aus.
limit_displayed_rows_values	Gibt an, welche Zeilen in einer Visualisierung ein- oder ausgeblendet werden sollen. Dieser Parameter hat die Unterparameter show_hide, first_last und num_rows.
Parameter für Zeitreihen
truncate_column_names	Kürzt Spaltenüberschriften mit einem Auslassungszeichen (…).
show_view_names	Der Name der Ansicht und der Feldname für jede Spaltenüberschrift
series_labels	Gibt ein benutzerdefiniertes Label für jede Spalte in der Visualisierung an.
Formatierungsparameter
enable_conditional_formatting	Wird auf true gesetzt, um Regeln für die Farbcodierung für eine Tabellenvisualisierung zu definieren.
conditional_formatting_include_totals	Gibt an, ob Summen in das Farbschema einbezogen werden.
conditional_formatting_include_nulls	Gibt an, ob Nullwerte als Null dargestellt werden sollen.
conditional_formatting	Verwendet conditional_formatting und seine Unterparameter, um die Regeln zu definieren, mit denen die Tabellendarstellung farblich codiert wird.

Grundlegende Parameter

Wenn Sie ein LookML-Dashboardelement definieren, müssen Sie Werte für mindestens die Parameter name und type angeben. Andere grundlegende Parameter wie title, height und width wirken sich auf die Position und Darstellung 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-Dashboard-Element definieren, müssen Sie Werte für mindestens die Abfrageparameter model und explore angeben. Außerdem muss mindestens ein Feld mit dem Parameter dimensions oder dem Parameter measures angegeben werden. Sie können auch die anderen in diesem Abschnitt beschriebenen Abfrageparameter verwenden, um die Darstellung von Daten in einem Dashboard-Element zu 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.

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]

pivots

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

merged_queries

Mit dem Parameter merged_queries können Sie die Ergebnisse mehrerer Abfragen in einem einzigen Dashboard-Element kombinieren. Definieren Sie jede Quellabfrage im merged_queries-Parameter des Elements und geben Sie mit dem join_fields-Unterparameter an, wie die Ergebnisse zusammengeführt werden sollen.

Mit dem folgenden LookML-Beispielcode wird ein -Element mit zusammengeführten Ergebnissen von type: looker_grid erstellt. In diesem Beispiel wird mit dem Parameter merged_queries ein Dashboard-Element erstellt, in dem Daten aus zwei separaten Abfragen in einem einzigen Tabellendiagramm kombiniert werden:

- name: merged_results_element
  title: Merged Results Tile
  type: looker_grid
  merged_queries:
  - model: ecommerce
    explore: users
    type: table
    fields: [users.state, users.count, users.city]
    sorts: [users.count desc 0]
    limit: 5000
    column_limit: 50
    query_timezone: UTC
    listen:
    - State: users.state
  - model: ecommerce
    explore: users
    type: table
    fields: [users.state, users.city]
    sorts: [users.state]
    limit: 500
    column_limit: 50
    query_timezone: UTC
    join_fields:
    - field_name: users.state
      source_field_name: users.state
    - field_name: users.city
      source_field_name: users.city
    listen:
    - State: users.state

In diesem Beispiel werden im Dashboard-Element Daten aus zwei Quellabfragen kombiniert, die auf dem users-Explore im ecommerce-Modell basieren. Die Primärabfrage enthält die Felder users.state, users.count und users.city und sortiert die Ergebnisse nach dem Feld users.count. Die zweite Quellabfrage enthält die Felder users.state und users.city und sortiert die Ergebnisse nach dem Feld users.state.

Mit dem Parameter join_field werden die Quellabfragen anhand übereinstimmender Werte in den Feldern users.state und users.city zusammengeführt.

Mit dem Parameter listen wird ein State-Filter auf beide Abfragen angewendet. So können Dashboard-Betrachter die in der Dashboard-Kachel angezeigten Abfrageergebnisse verfeinern, indem sie einen bestimmten Bundesstaat auswählen.

Beispiel: Unternehmensdaten zusammenführen

Angenommen, Sie möchten eine zusammengeführte Abfrage erstellen, in der Informationen zu Unternehmen aus zwei verschiedenen Explores kombiniert werden: company_info und companies. Sie möchten die Abfragen für die Felder ipo.stock_symbol, companies.name und companies.contact_email aus den einzelnen Explores zusammenführen, um eine Abfrage zu erstellen, die Ergebnisse für Unternehmensname, E-Mail-Adresse des Unternehmenskontakts, Jahr des Börsengangs, Aktiensymbol, Anzahl der Mitarbeiter und Anzahl der Stellen zurückgibt. Sie können das Element für zusammengeführte Abfragen in LookML so definieren:

- name: merged_results_element
  title: Merged Results Tile
  merged_queries:
  - model: market_research
    explore: company_info
    fields: [companies.name, companies.contact_email, ipo.public_year, ipo.stock_symbol]
    filters:
      companies.contact_email: "-NULL"
      ipo.valuation_amount: NOT NULL
    sorts: [ipo.public_year desc]
  - model: company_data
    explore: companies
    fields: [companies.name, ipo.stock_symbol, companies.contact_email,
      companies.number_of_employees, jobs.job_count]
    filters:
      companies.number_of_employees: NOT NULL
      ipo.stock_symbol: "-NULL"
      companies.contact_email: "-NULL"
    sorts: [jobs.job_count desc]
    join_fields:
    - field_name: ipo.stock_symbol
      source_field_name: ipo.stock_symbol
    - field_name: companies.name
      source_field_name: companies.name
    - field_name: companies.contact_email
      source_field_name: companies.contact_email

Filter auf zusammengeführte Abfrageelemente anwenden

Im vorherigen Beispiel für ein zusammengeführtes Abfrageelement wird gezeigt, wie Sie mithilfe des Parameters filters hartcodierte Filter direkt in jeder Quellabfrage anwenden. Die Filter companies.contact_email: "-NULL" und ipo.valuation_amount: NOT NULL in der Primärabfrage beschränken die Ergebnisse beispielsweise auf Unternehmen mit gültigen Kontakt-E-Mail-Adressen und Bewertungen. Diese Filter auf Abfrageebene filtern die Daten vor dem Zusammenführen der Abfragen vor und können vom Nutzer nicht geändert werden.

Sie können auch Dashboard-Filter auf zusammengeführte Abfrageelemente anwenden. Verwenden Sie dazu den Parameter listen in der Definition jeder Quellabfrage. Angenommen, Sie haben einen Dashboardfilter mit dem Namen Industry, den Sie auf Dashboard-Ebene mit dem Parameter filters für LookML-Dashboards definiert haben:

filters:
- name: Industry
  title: Industry
  type: field_filter
  ui_config:
    type: dropdown_menu
    display: inline
  model: market_research
  explore: company_info
  field: companies.industry

Wenn Sie den Industry-Filter auf das Feld companies.industry in beiden Quellabfragen anwenden möchten, fügen Sie den Parameter listen jeder der Quellabfragedefinitionen der zusammengeführten Abfrage hinzu:

listen:
  Industry: companies.industry

Im folgenden Beispielcode wird der Filter Industry beiden Quellabfragen im Element für zusammengeführte Ergebnisse aus dem vorherigen Beispiel hinzugefügt.

- name: merged_results_element
  title: Merged Results Tile
  merged_queries:
  - model: market_research
    explore: company_info
    fields: [companies.name, companies.contact_email, ipo.public_year, ipo.stock_symbol]
    filters:
      companies.contact_email: "-NULL"
      ipo.valuation_amount: NOT NULL
    sorts: [ipo.public_year desc]
    listen:
      Industry: companies.industry
  - model: company_data
    explore: companies
    fields: [companies.name, ipo.stock_symbol, companies.contact_email,
      companies.number_of_employees, jobs.job_count]
    filters:
      companies.number_of_employees: NOT NULL
      ipo.stock_symbol: "-NULL"
      companies.contact_email: "-NULL"
    sorts: [jobs.job_count desc]
    join_fields:
    - field_name: ipo.stock_symbol
      source_field_name: ipo.stock_symbol
    - field_name: companies.name
      source_field_name: companies.name
    - field_name: companies.contact_email
      source_field_name: companies.contact_email
    listen:
      Industry: companies.industry

Wenn ein Nutzer mit dem Dashboardfilter Industry interagiert, wird die entsprechende Quellabfrage im zusammengeführten Abfrageelement entsprechend gefiltert.

Tipp :Jede Quellabfrage kann auf einen oder mehrere Dashboard-Filter reagieren. So können Sie die Filterlogik für jede Quellabfrage unabhängig voneinander definieren, unabhängig von der Anzahl der Quellabfragen im Element mit zusammengeführten Ergebnissen. Wenn eine Anfrage keinen listen-Parameter enthält, ist sie nicht von Dashboardfiltern betroffen.

Diagrammparameter

Die folgenden Parameter entsprechen den Optionen im Diagrammbereich des Visualisierungseditors für Tabellendiagramme (alt).

table_theme

Mit dem Parameter table_theme können Sie eine der folgenden Optionen für die Tabellenfarbgebung auf ein Tabellenelement anwenden:

• editable: Die Tabelle enthält blaue Dimensionen, orangefarbene Messwerte und grüne Tabellenkalkulationen.
• white: Die Tabellenüberschrift ist weiß, die Datenzeilen wechseln zwischen weiß und grau und der Text ist schwarz.
• gray: Die Tabellenüberschrift ist grau, die Datenzeilen wechseln zwischen Weiß und Hellgrau und der Text ist dunkelgrau.
• transparent: Die Tabellenüberschrift ist vollständig transparent, die Datenzeilen wechseln zwischen vollständig transparent und durchscheinendem Grau und die Textfarbe wird je nach Hintergrundfarbe, die durchscheint, von Schwarz zu Weiß angepasst. Wenn Sie table_theme auf transparent festlegen, kann das nützlich sein, wenn Sie ein benutzerdefiniertes eingebettetes Dashboard verwenden, damit die Hintergrundfarbe der Kachel in der Visualisierung zu sehen ist.
• unstyled: Die Tabellenüberschrift und die Datenzeilen sind weiß und der Text ist schwarz.

table_theme: editable | white | gray | transparent | unstyled

total

Mit dem Parameter total wird festgelegt, ob unten in der Tabelle eine Summenzeile angezeigt wird. Weitere Informationen finden Sie unter Gesamtsummen anzeigen.

total: true | false

## default value: false

row_total

Mit dem Parameter row_total wird festgelegt, ob eine Spalte mit Gesamtsummen rechts oder links in der Tabelle angezeigt wird. Funktioniert nur, wenn ein Pivot vorhanden ist. Weitere Informationen finden Sie unter Gesamtsummen anzeigen.

row_total: right | left | false

## default value: false

show_row_numbers

Mit dem Parameter show_row_numbers wird festgelegt, ob am Anfang jeder Tabellenzeile eine Zeilennummer angezeigt wird.

show_row_numbers: true | false

hide_totals

Wenn Ihr Explore Spaltensummen enthält, wird mit hide_totals festgelegt, ob die Summen in der Visualisierung angezeigt werden.

hide_totals: true | false

hide_row_totals

Wenn Ihr Explore Zeilensummen enthält, wird mit hide_row_totals festgelegt, ob die Zeilensummen in der Visualisierung angezeigt werden.

hide_row_totals: true | false

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]

limit_displayed_rows

Mit dem Parameter limit_displayed_rows können Sie Zeilen in einer Visualisierung basierend auf ihrer Position in den Ergebnissen ein- oder ausblenden. Wenn in Ihrer Visualisierung beispielsweise ein gleitender Durchschnitt über 7 Tage dargestellt wird, sollten Sie die ersten 6 Zeilen ausblenden. Wenn Sie diesen Parameter auf true festlegen, können Sie mit dem Parameter limit_displays_rows_values und seinen Unterparametern die Werte und Positionen in der Visualisierung angeben, auf die er angewendet wird.

limit_displayed_rows: true
limit_displayed_rows_values:
  show_hide: hide | show
  first_last: first | last
  num_rows: '10'

limit_displayed_rows_values

Verwenden Sie den Parameter limit_displayed_rows_values und seine Unterparameter show_hide, first_last und num_rows mit limit_displayed_rows, um anzugeben, welche Zeilen in einer Visualisierung ein- oder ausgeblendet werden sollen. Beispiele für die Verwendung finden Sie im Abschnitt limit_displayed_rows.

show_hide

Mit dem Unterparameter show_hide wird festgelegt, ob bestimmte Zeilen in der Visualisierung ausgeblendet werden sollen. Legen Sie show_hide auf show fest, um nur eine begrenzte Anzahl von Zeilen in der Visualisierung anzuzeigen, und show_hide auf hide, um bestimmte Zeilen aus der Visualisierung auszuschließen.

first_last

Mit dem Unterparameter first_last wird festgelegt, ob die auszublendenden oder einzublendenden Zeilen die ersten oder letzten Zeilen im Ergebnis-Set sind. Wenn Sie first_last auf first setzen, werden die ersten Zeilen ein- oder ausgeblendet. Wenn Sie first_last auf last setzen, werden die letzten Zeilen ein- oder ausgeblendet.

num_rows

Mit dem Unterparameter num_rows wird die Anzahl der Zeilen festgelegt, die ausgeblendet oder eingeblendet werden sollen. Mit num_rows: '10' werden beispielsweise entweder die ersten oder die letzten 10 Zeilen des Ergebnissatzes in der Visualisierung ein- oder ausgeblendet.

Parameter für Reihen

Die folgenden Parameter entsprechen den Optionen im Abschnitt „Reihe“ des Visualisierungseditors für Tabellendiagramme (alt).

truncate_column_names

Mit dem Parameter truncate_column_names wird festgelegt, ob Spaltenüberschriften mit Auslassungspunkten (...) gekürzt werden sollen.

truncate_column_names: true | false

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

series_labels

Legen Sie die Labels einer oder mehrerer Reihen basierend auf dem Reihennamen mit name: label-Paaren fest.

Bei einem geschwenkten Diagramm sind die Reihennamen die Pivot-Namen.

series_labels:
  'Yes': iOS Users
  'No': Android Users

Bei einem Diagramm mit mehreren Messwerten sind die Reihennamen die Namen der Messwertfelder.

series_labels:
  inventory_items.count: Inventory
  orders.count: Orders

Formatierungsparameter

Die folgenden Parameter entsprechen den Optionen im Formatierungsbereich des Visualisierungseditors für Tabellendiagramme (alt).

enable_conditional_formatting

Wenn Sie enable_conditional_formatting auf true festlegen, können Sie Regeln definieren, mit denen Ihre Tabellenvorstellung farblich codiert wird. Das kann entweder auf einer Skala oder durch Angabe von interessanten Werten erfolgen.

enable_conditional_formatting: true | false

conditional_formatting_include_totals

Wenn enable_conditional_formatting auf true gesetzt ist, gibt conditional_formatting_include_totals an, ob Summen in das Farbschema einbezogen werden.

conditional_formatting_include_totals: true | false

conditional_formatting_include_nulls

Wenn enable_conditional_formatting auf true gesetzt ist, gibt conditional_formatting_include_nulls an, ob Nullwerte als Nullen dargestellt werden sollen.

conditional_formatting_include_nulls: true | false

conditional_formatting

Wenn enable_conditional_formatting auf true festgelegt ist, verwenden Sie den Parameter conditional_formatting, um die Regeln zu definieren, mit denen die Tabellendarstellung farblich codiert wird. Für jede Regel für die bedingte Formatierung können Sie Einstellungen mit den folgenden Parametern angeben:

• type
• value
• background_color
• font_color
• color_application
• bold
• italic
• strikethrough
• fields

Hier sehen Sie ein Beispiel für eine Regel für die bedingte Formatierung:

conditional_formatting: [{type: less than, value: 20, background_color: "#9fdee0",
  font_color: "#b15928", bold: true, italic: false, strikethrough: false,
  fields: [order_items.count], color_application: {collection_id: my-custom-colors,
  palette_id: my-custom-colors-sequential-0}}]

type

Mit dem Parameter type wird angegeben, ob Werte entlang einer Skala oder basierend auf einer logischen Bedingung farblich codiert werden sollen.

Wenn Sie Werte auf einer Skala farblich kennzeichnen, können Sie type auf along a scale... festlegen.

Wenn Sie Werte basierend auf einer logischen Bedingung farblich kennzeichnen, können Sie einen der folgenden Werte für type zusammen mit einem Wert für value angeben:

• equal to: Die Regel gilt für Werte, die der für value angegebenen Zahl entsprechen.
• not equal to: Die Regel gilt für Werte, die nicht gleich der für value angegebenen Zahl sind.
• greater than: Die Regel gilt für Werte, die größer als die für value angegebene Zahl sind.
• less than: Die Regel gilt für Werte, die kleiner als die für value angegebene Zahl sind.
• between: Die Regel gilt für Werte, die zwischen den beiden für value angegebenen Zahlen liegen.
• not between: Die Regel gilt für Werte, die nicht zwischen den beiden für value angegebenen Zahlen liegen.
• 'null': Die Regel gilt nur für Nullwerte.
• not null: Die Regel gilt nur für Werte, die nicht null sind.

type: along a scale... | equal to | not equal to | less than | between | not between | 'null' | not null

value

Wenn Sie Werte anhand einer anderen logischen Bedingung als 'null' oder not null farblich kennzeichnen, geben Sie den Wert an, auf den die Regel angewendet werden soll. Für den Parameter value wird eine einzelne Zahl oder, wenn type auf between oder not between festgelegt ist, ein Satz aus zwei Zahlen verwendet.

value: N | [N, N]

background_color

Wenn Ihre Farbcodierung auf einer logischen Bedingung basiert (type ist auf einen anderen Wert als along a scale... festgelegt), verwenden Sie den Parameter background_color, um eine Hintergrundfarbe für die Werte anzugeben, auf die Ihre Regel angewendet wird.

background_color: "#49cec1"

font_color

Wenn Ihre Farbcodierung auf einer logischen Bedingung basiert (type ist auf einen anderen Wert als along a scale... festgelegt), verwenden Sie den Parameter font_color, um eine Schriftfarbe für die Werte anzugeben, auf die Ihre Regel angewendet wird.

font_color: "#1f3e5a"

color_application

Mit dem Parameter color_application und seinen Unterparametern collection_id, palette_id und options können Sie einer Regel für die bedingte Formatierung eine bestimmte Farbsammlung und ‑palette zuweisen.

Sie können einem LookML-Dashboard Farben hinzufügen, indem Sie die Sammlungs-ID und die Paletten-ID angeben, sofern Sie diese haben. Sie können auch die Benutzeroberfläche verwenden, um die gewünschten Farben zu finden und den LookML-Code zu generieren, mit dem Sie sie Ihrem Dashboard hinzufügen. Rufen Sie einen benutzerdefinierten Inhalt auf (z. B. einen Look, ein Dashboard oder ein Explore) und wenden Sie die gewünschten Farben über die Benutzeroberfläche auf die Visualisierung dieses 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. Eine Übersicht über die vordefinierten Farbkollektionen von Looker finden Sie auf der Dokumentationsseite Farbkollektionen.

Der Unterparameter options kann verwendet werden, wenn Sie type auf along a scale... festgelegt haben. Sie hat die folgenden untergeordneten Parameter:

• steps: Mit diesem Parameter wird die Anzahl der verwendeten Farben auf den angegebenen Wert begrenzt und die Daten werden in die entsprechende Anzahl von Gruppen unterteilt. Wenn dieser Parameter nicht verwendet wird, werden die Daten entsprechend einem Farbverlauf eingefärbt, der die gesamte Palette abdeckt. Es werden Werte von 2 bis 100 akzeptiert.
• mirror: Wenn dieser Parameter auf true festgelegt ist, werden auf beiden Seiten der Farbpalette gleiche Farbverschiebungen für gleiche Werte auf beiden Seiten eines definierten Zentralpunkts angewendet. Akzeptiert true oder false.
• constraints: Mit diesem Parameter wird der Datenbereich festgelegt, auf den sich die bedingte Formatierung bezieht, und ein Zentralpunkt für die Anwendung der Palette festgelegt. Dafür ist die folgende Syntax erforderlich: constraints: {min: {type: number, value: 3}, max: {type: percentile, value: 99}, mid: {type: average}}
• reverse: Mit diesem Parameter wird festgelegt, ob die Farbpalette beim Anwenden von Farben umgekehrt werden soll. Akzeptiert true oder false.

bold

Wenn Sie die Farben basierend auf einer logischen Bedingung festlegen, können Sie angeben, ob die Werte, auf die Ihre Regel angewendet wird, fett dargestellt werden sollen.

bold: true | false

italic

Wenn Sie die Farbgebung auf einer logischen Bedingung basieren lassen, können Sie festlegen, ob die Werte, auf die die Regel angewendet wird, kursiv dargestellt werden sollen.

italic: true | false

strikethrough

Wenn Sie die Farbcodierung auf einer logischen Bedingung basieren lassen, legen Sie fest, ob die Werte für die Regel durchgestrichen werden sollen.

strikethrough: true | false

fields

Geben Sie die Felder an, auf die Ihre Regel angewendet werden soll. Standardmäßig gilt die Regel für alle numerischen Felder.

fields: [ view_name.field_name ]