Sie sehen sich die Dokumentation für Looker 22.16 an. Die aktuelle Dokumentation finden Sie hier.

Wasserfalldiagramm-Parameter für LookML-Dashboards

Auf dieser Seite wird beschrieben, wie Sie ein LookML-Dashboard-Element von type: looker_waterfall mit LookML-Dashboard-Parametern in einer dashboard.lkml-Datei hinzufügen und anpassen.

Informationen zum Erstellen eines Wasserfalldiagramms über die Looker-UI finden Sie auf der Dokumentationsseite zu den Wasserfall-Diagrammoptionen.

Nutzungsbeispiel

Ein N gibt an, dass ein numerischer Wert erforderlich ist. Einfache Anführungszeichen beschreiben den Text und sollten nicht im Live-Code verwendet werden.


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

## QUERY PARAMETERS
model: model_name
explore: explore_name
fields: [view_name.field_name, view_name.field_name, …]
dimensions: [view_name.field_name, view_name.field_name, …]
measures: [view_name.field_name, view_name.field_name, …]
sorts: [view_name.field_name asc | desc, view_name.field_name, …]
fill_fields: [view_name.field_name, view_name.field_name, …]
limit: N
column_limit: N
filters:
  view_name.field_name: 'Looker filter expression' | 'filter value'
filter_expression:  'Looker custom filter expression'
listen:
  dashboard_filter_name: view_name.field_name
hidden_fields: [view_name.field_name, view_name.field_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

## SERIES PARAMETERS
up_color: &#34;hex string&#34; | 'CSS named color string'
down_color: &#34;hex string&#34; | 'CSS named color string'
total_color: &#34;hex string&#34; | 'CSS named color string'
color_application:
  collection_id: 'collection ID'
  palette_id: 'palette ID'
  options:
    reverse: true | false

## VALUE PARAMETERS
show_value_labels: true | false
label_color: ['color value']

## X-AXIS PARAMETERS
x_axis_scale: auto | ordinal | time
show_x_axis_label: true | false
show_x_axis_ticks: true | false

## Y-AXIS PARAMETERS
show_y_axis_labels: true | false
show_y_axis_ticks: true | false
y_axis_gridlines: true | false

Parameterdefinitionen

Parametername	Beschreibung
Grundlegende Parameter
`name` (für Elemente)	Erstellt das Element
`title` (für Elemente)	Ändert die Darstellung des Elementnamens für Nutzer
`type` (für Elemente)	Legt die Art der im Element zu verwendenden Visualisierung fest
`height` (für Elemente)	Definiert die Höhe des Elements in Einheiten von `tile_size` für `layout: tile`- und `layout: static`-Dashboards.
`width` (für Elemente)	Definiert die Breite des Elements in `tile_size`-Einheiten für `layout: tile`- und `layout: static`-Dashboards.
`top`	Definiert die oberste Position des Elements in der Einheit `tile_size` für `layout: static`-Dashboards.
`left`	Definiert die Position des Elements von links nach rechts (in Einheiten von `tile_size`) für `layout: static`-Dashboards
`row`	Definiert die oberste Position eines Elements in Zeileneinheiten für `layout: newspaper`-Dashboards
`col`	Bestimmt die Position der Elemente in `layout: newspaper`-Dashboards von links nach rechts
`refresh` (für Elemente)	Legt das Intervall fest, in dem das Element automatisch aktualisiert wird
`note_state`	Gibt an, ob die Notiz minimiert oder maximiert werden soll, wenn sie zu groß für eine einzelne Zeile innerhalb der Breite des Elements ist
`note_display`	Definiert, wo die Notiz im Element angezeigt wird
`note_text`	Gibt den Text an, der in der Notiz angezeigt wird
Suchparameter
`model`	Definiert das Modell, das für die Abfrage des Elements verwendet werden soll
`explore` (für Elemente)	Definiert die für die Abfrage des Elements zu verwendende Funktion „Erkunden“
`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 für die Abfrage des Elements zu verwendenden Messwerte
`sorts`	Definiert die Sortierungen, die für die Abfrage des Elements verwendet werden sollen
`fill_fields`	Definiert die Dimensionen, für die die Option Dimensionsfüllung verwendet wird
`limit`	Definiert das Zeilenlimit, das 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.
`filter_expression`	Definiert einen benutzerdefinierten Filter, der für die Abfrage des Elements nicht geändert werden kann.
`listen`	Definiert die Filter, die für die Abfrage des Elements geändert werden können, wenn `filters` (für Dashboard) erstellt wurden.
`hidden_fields`	Gibt alle Felder an, die in der Abfrage verwendet, aber im Diagramm ausgeblendet werden sollen
`query_timezone`	Definiert die Zeitzone, die bei der Ausführung der Abfrage verwendet werden soll
`merged_queries`	Definiert eine merged results-Abfrage.
Parameter der Reihe
`up_color`	Legt die Farbe der Balken für positive Werte im Diagramm fest
`down_color`	Legt die Farbe der Balken für negative Werte im Diagramm fest
`total_color`	Legt die Farbe des Gesamtwerts im Diagramm fest
`color_application`	Wendet eine Farbsammlung und Palette auf das Diagramm an
Wertparameter
`show_value_labels`	Labels für jede Datenleiste anzeigen
`label_color`	Gibt einen Farbwert für Labels an
x-Achsenparameter
`x_axis_scale`	Gibt an, wie die Skala der x-Achse berechnet wird
`show_x_axis_label`	Blendet das Label für die X-Achse ein oder aus
`show_x_axis_ticks`	Zeigt Werte auf der X-Achse an
Y-Achsenparameter
`show_y_axis_labels`	Blendet das Label der Y-Achse ein oder aus
`show_y_axis_ticks`	Zeigt Werte auf der Y-Achse an
`y_axis_gridlines`	Erweitert Gitternetzlinien von der Y-Achse

Grundlegende Parameter

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

`name`

Dieser Abschnitt bezieht sich auf den Parameter name, der Teil eines Dashboard-Elements ist.

name kann auch als Teil eines Dashboard-Filters verwendet werden, der auf der Dokumentationsseite zu Dashboard-Parametern beschrieben wird.

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`

Dieser Abschnitt bezieht sich auf den Parameter title, der Teil eines Dashboard-Elements ist.

title kann auch als Teil eines Dashboards verwendet werden, wie auf der Dokumentationsseite zu den Dashboard-Parametern beschrieben.

title kann auch als Teil eines Dashboard-Filters verwendet werden, der auf der Dokumentationsseite zu Dashboard-Parametern beschrieben wird.

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

Betrachten Sie dieses Beispiel:

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

Wenn Sie dieses Format verwenden, wird statt des Elements als Sales Overview (Verkaufsübersicht) 1) Sales Overview angezeigt.

`type`

Dieser Abschnitt bezieht sich auf den Parameter type, der Teil eines Dashboard-Elements ist.

type kann auch als Teil eines Dashboard-Filters verwendet werden, der auf der Dokumentationsseite zu Dashboard-Parametern beschrieben wird.

type kann auch als Teil eines Joins verwendet werden (siehe Dokumentation zum Parameter type (für Joins)).

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

type kann auch als Teil einer Messung verwendet werden, wie auf der Dokumentationsseite zu Messtypen beschrieben.

Der Parameter type bestimmt die Art der Visualisierung, die 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

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

`height`

Dieser Abschnitt bezieht sich auf den Parameter height, der Teil eines Dashboard-Elements ist.

height kann auch als Teil einer Dashboard-Zeile verwendet werden, wie auf der Dokumentationsseite zu Dashboard-Parametern beschrieben.

Für Dashboards mit `tile`- oder `static`-Layouts

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

Der folgende Code gibt beispielsweise tile_size: 100 und height: 4 an, wodurch das Element orders_by_date 400 Pixel hoch wird.

- 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 Zeilen für layout: newspaper-Dashboards.

Ein Dashboard mit Zeitungslayout hat standardmäßig eine Elementhöhe von 6 Zeilen oder etwa 300 Pixeln. Die Mindesthöhe beträgt 1 Zeile für Dashboards, deren Parameter preferred viewer auf dashboards-next festgelegt ist. Die Mindesthöhe beträgt für Dashboards mit einem preferred viewer-Parameter von dashboards 2 Zeilen.

Mit dem folgenden Code wird ein Element beispielsweise auf 12 Zeilen oder doppelt so hoch gesetzt wie andere Elemente mit dem Standardwert:

- dashboard: sales_overview
  layout: newspaper
  ...

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

`width`

Dieser Abschnitt bezieht sich auf den Parameter width, der Teil eines Dashboard-Elements ist.

width kann auch als Teil eines Dashboards verwendet werden, wie auf der Dokumentationsseite zu den Dashboard-Parametern beschrieben.

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

Der folgende Code gibt beispielsweise tile_size: 100 und width: 4 an, wodurch das Element orders_by_date 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 Spaltenspalten für layout: newspaper-Dashboards.

Ein Dashboard mit Zeitungslayout 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 oberste Position eines Elements in Einheiten von tile_size für layout: static-Dashboards.

Der folgende Code gibt beispielsweise tile_size: 100 und top: 4 an und positioniert den oberen Rand des orders_by_date-Elements 400 Pixel vom oberen Rand des Dashboards.

- dashboard: sales_overview
  tile_size: 100
  ...

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

`left`

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

Der folgende Code gibt beispielsweise tile_size: 100 und left: 4 an und positioniert den linken Rand des orders_by_date-Elements 400 Pixel vom linken Rand des Dashboards.

- dashboard: sales_overview
  tile_size: 100
  ...

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

`row`

Bei layout: newspaper-Dashboards definiert der Parameter row die Zeile, auf der der obere Rand eines Elements platziert wird.

Ein Dashboard beginnt mit Zeile 0 oben im Dashboard. Ein Dashboard mit Zeitungslayout hat standardmäßig eine Elementhöhe von 6 Zeilen. Das bedeutet, dass die Dashboard-Elemente oben auf einem Dashboard (row: 0) standardmäßig die Zeilen 0–5 belegen.

Jede Zeile ist 50 Pixel hoch. Die Standardhöhe für das Element beträgt also 6 Zeilen.

Mit dem folgenden Code wird beispielsweise festgelegt, dass ein Element in der zweiten Zeile von Elementen im Dashboard festgelegt wird, 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, auf der der linke Rand des Elements platziert wird.

Dashboards sind in 24 Spalten unterteilt. Ein Dashboard beginnt mit Spalte 0 links vom Dashboard. Ein Dashboard mit Zeitungslayout hat standardmäßig eine Elementbreite von 8 Spalten. Das bedeutet, dass die Dashboard-Elemente links vom Dashboard (col: 0) standardmäßig die Spalten 0–7 belegen.

Der folgende Code legt beispielsweise ein Element fest, das in der dritten Spalte von Elementen im Dashboard festgelegt wird:

- dashboard: sales_overview
  layout: newspaper
  ...

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

`refresh`

Dieser Abschnitt bezieht sich auf den Parameter refresh, der Teil eines Dashboard-Elements ist.

refresh kann auch als Teil eines Dashboards verwendet werden, wie auf der Dokumentationsseite zu den Dashboard-Parametern beschrieben.

Mit dem Parameter refresh kann ein Element regelmäßig automatisch neu geladen werden. Dadurch werden aktuelle Daten abgerufen. Das ist vor allem dann hilfreich, wenn ein Dashboard ständig angezeigt wird, zum Beispiel 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 vorzuwärmen.

Die Aktualisierungsrate kann eine beliebige Anzahl von Sekunden, Minuten, Stunden oder Tagen ohne Dezimalstellen 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 belasten als gewünscht.

`note_state`

Der Parameter note_state definiert, ob eine Notiz minimiert oder maximiert werden soll, wenn sie zu groß für eine einzelne Zeile innerhalb der Breite des Elements ist. Wenn Sie collapsed auswählen und die Notiz zu lang ist, endet die Notiz mit einem Auslassungszeichen (...), das zum Lesen der gesamten Notiz verwendet werden kann. Wenn Sie expanded auswählen und die Notiz lang ist, wird sie in zusätzlichen Zeilen ausgeführt.

`note_display`

Der Parameter note_display definiert, wo auf einem Element eine Notiz angezeigt wird. above platziert die Notiz oben in einem Element, below platziert sie unten im Element und hover erfordert, dass der Nutzer den Mauszeiger auf ein ?-Symbol bewegt, um die Notiz zu sehen.

`note_text`

Der Parameter note_text gibt den in einer Elementnotiz angezeigten Text an.

Abfrageparameter

Wenn Sie ein LookML-Dashboard-Element definieren, müssen Sie Werte für die Abfrageparameter model und explore angeben. Außerdem muss mindestens ein Feld mit dem Parameter dimensions, measures oder fields angegeben werden. Sie können auch die anderen unten beschriebenen Suchparameter verwenden, um die Anzeige der Daten in einem Dashboard-Element zu steuern.

`model`

Der Parameter model definiert das für die Elementabfrage zu verwendende Modell. 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. Du kannst eine Konstante in der Manifest-Datei für dein Projekt 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 einem Ort definieren. Dies 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 in der Dokumentation des Parameters constant.

`explore`

Dieser Abschnitt bezieht sich auf den Parameter explore, der Teil eines Dashboard-Elements ist.

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

explore kann auch als Teil eines Dashboard-Filters verwendet werden, der auf der Dokumentationsseite zu Dashboard-Parametern beschrieben wird.

Der Parameter explore definiert die Funktion „Erkunden“ für die Elementabfrage.

- name: orders_by_date
  explore: order

Der Parameter explore akzeptiert LookML-Konstanten. Du kannst eine Konstante in der Manifest-Datei für dein Projekt 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 einer explorativen Datenanalyse an einem Ort definieren. Das ist insbesondere dann hilfreich, wenn Sie den Namen einer explorativen Datenanalyse aktualisieren, die von mehreren Dashboard-Elementen verwendet wird.

Weitere Informationen und ein Beispiel für die Verwendung von Konstanten mit LookML-Dashboards finden Sie in der Dokumentation des Parameters constant.

`fields`

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

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

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

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

`dimensions`

Der Parameter dimensions definiert die Dimension(en), die für die Elementabfrage verwendet werden sollen. Verwenden Sie die Syntax view_name.dimension_name, um die Dimension anzugeben. Fügen Sie dimensions nicht hinzu, wenn die Abfrage keine enthält.

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

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

`measures`

Der Parameter measures definiert die Maßeinheiten, die für die Elementabfrage verwendet werden sollen. Verwenden Sie die Syntax view_name.measure_name, um den Messwert anzugeben. Fügen Sie measures nicht hinzu, wenn die Abfrage keine enthält.

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

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

`sorts`

Der Parameter sorts definiert die Sortierungen, die für die Elementabfrage verwendet werden sollen. Die primäre Sortierung wird zuerst aufgeführt, dann die sekundäre Sortierung usw. Verwenden Sie die Syntax view_name.field_name, um die Dimension oder das Maß anzugeben. Fügen Sie sorts nicht hinzu, wenn Sie die Standardsortierung von Looker verwenden möchten. Für absteigende Sortierungen ist das Suffix desc zulässig. Für aufsteigende Sortierungen ist kein Suffix erforderlich.

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

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

`fill_fields`

Der Parameter fill_fields definiert die Dimensionen, für die die Option Dimensionsfüllung verwendet wird. Verwenden Sie die Syntax view_name.dimension_name, um die Abmessungen anzugeben.

- name: orders_by_date
  fill_fields: [orders.created_date, orders.shipped_date]

`limit`

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

- name: orders_by_date
  limit: 100

`filters`

Dieser Abschnitt bezieht sich auf den Parameter filters, der Teil eines Dashboard-Elements ist.

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

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

Der Parameter filters definiert die nicht änderbaren Filter, die für die Abfrage des Elements verwendet werden sollen. Wenn Sie Filter möchten, die ein Nutzer im Dashboard ändern kann, müssen 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 annehmen. Für flexible Filterwerte können Sie auch die Liquid-Variablen _localization oder _user_attributes verwenden.

`filter_expression`

Der Parameter filter_expression definiert einen nicht änderbaren benutzerdefinierten Filter für die Abfrage des Elements. Wenn Sie Filter möchten, die ein Nutzer im Dashboard ändern kann, müssen Sie die Filter mit filters für Dashboards einrichten und sie dann mit listen auf die Elemente anwenden.

- name: element_name
  filter_expression:
  - diff_days(${users.created_date},${user_order_facts.first_order_date}) > 60

Auf der Dokumentationsseite zu Looker-Filterausdrücken werden die Looker-Filterausdrücke aufgeführt.

`listen`

Dashboards können Filter enthalten, mit denen Nutzer die Daten hinter Dashboard-Elementen ändern können. Diese werden mit dem Parameter filters für Dashboards eingerichtet. Damit sich ein Filter auf ein Element auswirkt, muss es für den Filter mit dem Parameter listen auf „listen“ gesetzt sein.

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

Sie können beispielsweise einen Filter mit dem Namen Datum erstellen, bei dem der Nutzer in der Benutzeroberfläche ein Datum in das Filterfeld eingeben muss. Sie können dann den Wert, den der Nutzer eingibt, 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
    ...

Dieses Konzept wird auf der Dokumentationsseite LookML-Dashboards erstellen ausführlicher beschrieben.

`hidden_fields`

Der Parameter hidden_fields gibt an, welche Felder (falls vorhanden) in der Abfrage verwendet, aber im Diagramm ausgeblendet werden. Alle ausgeblendeten Felder werden im Bereich „Datentabelle“ der Funktion „Erkunden“ angezeigt.

hidden_fields: [inventory_items.count, distribution_centers.id]

`query_timezone`

Der Parameter query_timezone gibt die Zeitzone an, in der die Abfrage ausgeführt wird. Die Zeitzonenoptionen werden auf der Dokumentationsseite Werte für timezone angezeigt. Wenn die Abfrage mit 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`

Der Parameter merged_queries definiert, wie die Ergebnisse aus mehreren Abfragen zusammengeführt werden. Sie definieren die Komponentenabfragen unter dem Parameter merged_queries und verwenden den Unterparameter join_fields, um die Zusammenführungsregeln zu definieren.

Die Syntax für merged_queries lautet:

  merged_queries:
  - 'primary query definition'
  - 'next source query definition'
    join_fields:
    - field_name: 'field from the source query using the view_name.field_name syntax'
      source_field_name: 'joined field from the primary query using the
        view_name.field_name syntax'
    # more join_fields definitions as needed
  - 'next source query definition'
    join_fields:
    - field_name: view_name.field_name
      source_field_name: view_name.field_name
    # more join_fields definitions as needed
  # additional source queries and join_fields definitions as needed

Die erste unter merged_results definierte Abfrage ist die primäre Abfrage. Die anderen Abfragen werden mit dieser zusammengeführt.

Wenn Sie beispielsweise das Aktiensymbol, den Namen des Unternehmens und den Twitter-Nutzernamen zusammenführen, können Sie zwei Abfragen zusammenführen, um Ergebnisse für den Namen des Unternehmens, den Twitter-Nutzernamen des Unternehmens, das IPO-Jahr, das Aktiensymbol, die Anzahl der Mitarbeiter und die Anzahl der Jobs zurückzugeben:

- name: merged_results_element
  title: Merged Results Tile
  merged_queries:
  - model: market_research
    explore: company_info
    fields: [company.name, company.twitter_username, ipo.public_year, ipo.stock_symbol]
    filters:
      company.twitter_username: "-NULL"
      ipo.valuation_amount: NOT NULL
    sorts: [ipo.public_year desc]
  - model: crunchbase
    explore: companies
    fields: [companies.name, ipo.stock_symbol, companies.twitter_username,
      companies.number_of_employees, jobs.job_count]
    filters:
      companies.number_of_employees: NOT NULL
      ipo.stock_symbol: "-NULL"
      companies.twitter_username: "-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: company.name
    - field_name: companies.twitter_username
      source_field_name: company.twitter_username

Die Datenergebnisse werden dann so formatiert:

Anschließend können Sie Elementparameter anwenden, um die Visualisierung nach Ihren Wünschen zu gestalten.

Parameter der Reihe

Die in diesem Abschnitt beschriebenen Parameter entsprechen den Optionen im Menü Reihe des Visualisierungseditors für Wasserfalldiagramme.

`up_color`

Legen Sie die Farbe der Balken für positive Werte im Diagramm fest. Der Farbwert kann einen Hexadezimalstring in Anführungszeichen wie „#2ca6cd“ oder einen CSS-benannten Farbstring wie mediumblue haben.

up_color: blue

Der Parameter up_color überschreibt den Parameter color_application, falls er verwendet wird.

`down_color`

Legen Sie die Farbe der Balken für negative Werte im Diagramm fest. Der Farbwert kann einen Hexadezimalstring in Anführungszeichen wie „#2ca6cd“ oder einen CSS-benannten Farbstring wie mediumblue haben.

down_color: &#34;#ff0000&#34;

Der Parameter down_color überschreibt den Parameter color_application, falls er verwendet wird.

`total_color`

Legen Sie die Farbe des Gesamtwerts im Diagramm fest. Der Farbwert kann einen Hexadezimalstring in Anführungszeichen wie „#2ca6cd“ oder einen CSS-benannten Farbstring wie mediumblue haben.

total_color: yellow

Der Parameter total_color überschreibt den Parameter color_application, falls er verwendet wird.

`color_application`

Mit dem Parameter color_application und den Unterparametern collection_id und palette_id kann eine bestimmte Farbsammlung und Palette auf ein Dashboard-Element angewendet werden. Eine Übersicht über die nativen Farbgebungssammlungen von Looker finden Sie auf der Dokumentationsseite zu Farbkollektionen.

Wenn Sie die Sammlungs- und die Paletten-ID der gewünschten Palette haben, können Sie diese IDs in die Unterparameter collection_id und palette_id eingeben. Eine Sammlungs- oder Paletten-ID kann ein alphanumerischer Code sein oder auf dem Namen der Farbsammlung basieren. Alphanumerische Codes werden für native Sammlungen von Looker 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 Palette-IDs basierend auf dem Namen der Farbsammlung verwendet. Sie können auf Instanzen übertragen werden und so aussehen:


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

Sie können die Benutzeroberfläche auch verwenden, um die gewünschten Farben, Sammlungen oder Vorlagen zu finden und die LookML zu Ihrem Dashboard hinzuzufügen. Rufen Sie einen benutzerdefinierten Inhalt (z. B. Look, Dashboard oder Erkunden) auf und wenden Sie die gewünschten Farben, Sammlungen oder die Palette auf die Visualisierung dieses Inhalts an. Anschließend können Sie die Schritte zum Abrufen des Dashboard-LookML ausführen, den erstellten LookML-Code kopieren und ihn im Abschnitt color_application einfügen.

`color_application` und die Balken für positive, negative und Gesamtwerte

Standardmäßig wird die erste Farbe der ausgewählten Palette auf die positiven Balken im Wasserfalldiagramm angewendet. Die zweite Farbe wird auf die negativen Balken des Wasserfalldiagramms angewendet. Die dritte Farbe der ausgewählten Palette wird auf den Gesamtbalken des Wasserfalldiagramms angewendet. Mit dem optionalen Unterparameter reverse wird die Anwendung in die letzte, die vorletzte und die dritte Farbe umgewandelt.

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

Die Parameter up_color, down_color und total_color überschreiben alle im color_application-Parameter angegebenen Farben, wenn beide Arten von Farbparametern verwendet werden.

Wertparameter

Die in diesem Abschnitt beschriebenen Parameter entsprechen den Optionen im Menü Werte des Visualisierungseditors für Wasserfalldiagramme.

`show_value_labels`

Der Wert eines Balkens, einer Linie oder eines Punkts wird neben dem Datenpunkt angezeigt.

show_value_labels: true | false

## default value: false

`label_color`

Für den Parameter label_color kann ein Farbwert für die Labels verwendet werden. Der Farbwert kann als Hexadezimalstring (z. B. #2ca6cd) oder als CSS-benannter Farbstring (z. B. mediumblue) formatiert werden.


label_color: [blue]

Parameter der X-Achse

Die in diesem Abschnitt beschriebenen Parameter entsprechen den Optionen im X-Menü des Visualisierungseditors für Wasserfalldiagramme.

`x_axis_scale`

Dieser Parameter bestimmt, wie die X-Achsenskalierung berechnet wird.

auto: Die Skala wird aus den zugrunde liegenden Daten abgeleitet. Dies ist die Standardeinstellung.
ordinal: Die Daten werden als separate, diskrete Einträge dargestellt.
time: Die Daten werden als Zeit dargestellt und die Achse entsprechend beschriftet. Dies funktioniert nicht, wenn die zugrunde liegenden Daten nicht in Datumsangaben umgewandelt werden können.

x_axis_scale: auto | ordinal | time

## default value: auto

`show_x_axis_label`

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

show_x_axis_label: true | false

## default value: true

`show_x_axis_ticks`

Dieser Parameter bestimmt, ob Werte auf der X-Achse angezeigt werden.

show_x_axis_ticks: true | false

## default value: true

Parameter für die Y-Achse

Die in diesem Abschnitt beschriebenen Parameter entsprechen den Optionen im Menü Y des Visualisierungseditors für Wasserfalldiagramme.

`show_y_axis_labels`

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

show_y_axis_labels: true | false

## default value: true

`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 erweitert werden.

y_axis_gridlines: true | false

## default value: true

Wasserfalldiagramm-Parameter für LookML-Dashboards

Nutzungsbeispiel

Parameterdefinitionen

Grundlegende Parameter

name

title

type

height

Für Dashboards mit tile- oder static-Layouts

Für Dashboards mit newspaper-Layout

width

top

left

row

col

refresh

note_state

note_display

note_text

Abfrageparameter

model

explore

fields

dimensions

measures

sorts

fill_fields

limit

filters

filter_expression

listen

hidden_fields

query_timezone

merged_queries