Diagrammparameter (alt) für LookML-Dashboards

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

Informationen zum Erstellen eines Tabellendiagramms (Legacy-Diagramms) über die Looker-Benutzeroberfläche finden Sie auf der Dokumentationsseite Diagrammoptionen (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 Darstellung eines 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 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 tile_size-Einheiten für layout: tile- und layout: static-Dashboards.
top Definiert die oberste Position eines Elements in der Einheit tile_size für layout: static-Dashboards.
left Definiert die Position von links nach rechts für ein Element in der Einheit 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 Startet einen Abschnitt von LookML, um eine Notiz für ein Element zu definieren. 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 die für die Abfrage des Elements zu verwendende Funktion „Erkunden“
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
pivots Definiert die Dimensionen, die für die Abfrage des Elements verwendet werden sollen
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.
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 bei der Ausführung der Abfrage verwendet werden soll
merged_queries Definiert eine merged results-Abfrage.
Parameter festlegen
table_theme Eine von fünf Tabellenfarboptionen auf eine Tabellenvisualisierung anwenden
total Gibt an, ob Spaltensummen für eine Tabellenvisualisierung angezeigt werden
row_total Gibt an, ob Zeilensummen für eine Tabellenvisualisierung angezeigt werden
show_row_numbers Legt fest, ob eine Zeilennummer am Anfang jeder Tabellenzeile 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 alle Felder an, die in der Abfrage verwendet, aber im Diagramm ausgeblendet werden sollen
limit_displayed_rows Zeilen in einer Visualisierung basierend auf ihrer Position in den Ergebnissen ein- oder ausblenden
limit_displayed_rows_values Gibt an, welche Zeilen in einer Visualisierung ein- oder ausgeblendet werden. Dieser Parameter hat die Unterparameter show_hide, first_last und num_rows.
Parameter der Reihe
truncate_column_names Kürzt Spaltenüberschriften mit Auslassungspunkten (...)
show_view_names Zeigt den Namen der Ansicht zusammen mit dem Feldnamen der einzelnen Spaltenüberschriften an
series_labels Gibt für jede Spalte in der Visualisierung ein benutzerdefiniertes Label an
Parameter formatieren
enable_conditional_formatting Legt true fest, um Farbcodierungsregeln für eine Tabellenvisualisierung zu definieren
conditional_formatting_include_totals Gibt an, ob Summen im Farbcodierungsschema enthalten sind
conditional_formatting_include_nulls Gibt an, ob Nullwerte als Null dargestellt werden sollen
conditional_formatting Verwendet conditional_formatting und die zugehörigen Unterparameter, um die Regeln zu definieren, mit denen die Tabellenvisualisierung farblich gekennzeichnet wird

Grundlegende Parameter

Wenn Sie ein LookML-Dashboard-Element 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 das Erscheinungsbild eines 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

So können Sie beschreibende Hinweise zu Elementen 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

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

state

Mit dem Unterparameter state wird festgelegt, ob die Notiz collapsed oder expanded sein wird, wenn sie für eine einzelne Zeile innerhalb der Breite des Elements zu groß 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.

display

Der Unterparameter display bestimmt, wo die Notiz in einem Element angezeigt wird. above platziert die Notiz oben in einem Element, below platziert sie unten im Element und bei hover muss der Nutzer den Mauszeiger auf das Element bewegen, damit die Notiz angezeigt wird.

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 entweder mit dem Parameter dimensions oder dem Parameter measures 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.

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]

pivots

Der Parameter pivots definiert die Dimensionen, die für die Elementabfrage gedreht werden sollen. Verwenden Sie die Syntax view_name.dimension_name, um die Dimension anzugeben. Fügen Sie pivots nicht hinzu, wenn die Abfrage keine enthält.

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

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

limit

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

- name: orders_by_date
  limit: 100

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.

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.

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 darstellen

Die folgenden Parameter entsprechen den Optionen im Abschnitt Diagramm des Visualisierungseditors für Tabellendiagramme (alte Diagramme).

table_theme

Mit dem Parameter table_theme können Sie eine der folgenden Tabellen-Farboptionen auf ein Tabellenelement anwenden:

  • editable: Die Tabelle hat blaue Dimensionen, orangefarbene Maße und grüne Tabellenberechnungen.
  • white: Die Kopfzeile der Tabelle ist weiß, die Datenzeilen wechseln zwischen Weiß und Grau und der Text ist schwarz.
  • gray: Die Kopfzeile der Tabelle ist grau, die Datenzeilen wechseln zwischen Weiß und Hellgrau und der Text ist dunkelgrau.
  • transparent: Die Kopfzeile ist vollständig transparent, die Datenzeilen wechseln zwischen vollständig transparent und durchscheinend grau und die Textfarbe passt sich je nach Hintergrundfarbe, die angezeigt wird, von Schwarz zu Weiß an. Das Festlegen von table_theme auf transparent kann hilfreich sein, wenn Sie ein benutzerdefiniertes eingebettetes Dashboard verwenden, damit die Hintergrundfarbe der Kacheln durch die Visualisierung angezeigt wird.
  • unstyled: Der Tabellenheader und die Datenzeilen sind weiß und der Text ist schwarz.

table_theme: editable | white | gray | transparent | unstyled

total

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

total: true | false

## default value: false

row_total

Mit dem Parameter row_total legen Sie fest, ob die Spalte „Summen“ rechts oder links von der Tabelle angezeigt wird. Funktioniert nur, wenn ein Pivot-Vorgang vorhanden ist. Weitere Informationen finden Sie unter Summen anzeigen.

row_total: right | left | false

## default value: false

show_row_numbers

Der Parameter show_row_numbers legt fest, ob eine Zeilennummer am Anfang jeder Tabellenzeile angezeigt wird.


show_row_numbers: true | false

hide_totals

Wenn der Bereich „Erkunden“ Spaltensummen enthält, legt hide_totals fest, ob die Summen in der Visualisierung angezeigt werden.


hide_totals: true | false

hide_row_totals

Wenn der Bereich „Erkunden“ Zeilensummen enthält, legt hide_row_totals fest, ob die Summen in der Visualisierung angezeigt werden.


hide_row_totals: true | false

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]

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 7-Tage-Durchschnitt angezeigt wird, sollten Sie die ersten sechs Zeilen ausblenden. Wenn Sie diese Option auf true festlegen, können Sie die Werte und Positionen in der Visualisierung angeben, auf die dies mit dem Parameter limit_displays_rows_values und den zugehörigen Unterparametern zutrifft.

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 die Unterparameter show_hide, first_last und num_rows mit limit_displayed_rows, um anzugeben, welche Zeilen in einer Visualisierung ein- oder ausgeblendet werden sollen. Beispielverwendung finden Sie limit_displayed_rows oben.

show_hide

Mit dem Unterparameter show_hide wird festgelegt, ob bestimmte Zeilen für die Visualisierung ausgeblendet werden sollen. Legen Sie show_hide auf show fest, damit nur eine begrenzte Anzahl von Zeilen in der Visualisierung zu sehen ist, und setzen Sie show_hide auf hide, um bestimmte Zeilen aus der Visualisierung auszuschließen.

first_last

Mit dem Unterparameter first_last wird festgelegt, ob die Zeilen, die ausgeblendet oder eingeblendet werden sollen, die erste oder letzte Zeile im Ergebnissatz sind. Wenn Sie first_last auf first setzen, werden die ersten Zeilen ein- oder ausgeblendet. Bei first_last auf last werden die letzten Zeilen ein- oder ausgeblendet.

num_rows

Mit dem Unterparameter num_rows wird die Anzahl der ausgeblendeten oder angezeigten Zeilen festgelegt. Beispiel: Mit num_rows: '10' werden die ersten oder letzten 10 Zeilen der Ergebnismenge in der Visualisierung ein- oder ausgeblendet.

Parameter der Reihe

Die folgenden Parameter entsprechen den Optionen im Abschnitt Reihe des Visualisierungseditors für Tabellendiagramme (alte Diagramme).

truncate_column_names

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


truncate_column_names: true | false

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

series_labels

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

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

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

Bei einem Diagramm mit mehreren Messwerten sind die Namen der Reihen die Feldnamen.

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

Parameter formatieren

Die folgenden Parameter entsprechen den Optionen im Abschnitt Formatierung des Visualisierungseditors für Tabellendiagramme (alte Diagramme).

enable_conditional_formatting

Wenn Sie enable_conditional_formatting auf true festlegen, können Sie Regeln definieren, die Ihre Tabellenvisualisierung farblich kennzeichnen, entweder durch eine Skala oder durch Festlegen von relevanten Werten.


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 im Farbcodierungsschema enthalten sind.


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 gesetzt ist, definieren Sie mit dem Parameter conditional_formatting die Regeln, die die Tabellenvisualisierung farblich kennzeichnen. Für jede Regel zur bedingten Formatierung können Sie Einstellungen mit den folgenden Parametern festlegen:

Hier ein Beispiel für eine Regel zur bedingten 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

Der Parameter type gibt an, ob Farbcodes auf einer Skala oder basierend auf einer logischen Bedingung farblich gekennzeichnet werden sollen.

Wenn Sie Farbcodierungen auf einer Skala verwenden, können Sie type auf along a scale... setzen.

Wenn Sie Farbcodierungen basierend auf einer logischen Bedingung erstellen, können Sie einen der folgenden Werte für type und einen 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 der für value angegebenen Zahl entsprechen.
  • greater than: Die Regel gilt für Werte, die größer sind als die für value angegebene Zahl.
  • 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 Farbcodierungen basierend auf einer anderen logischen Bedingung als 'null' oder not null festlegen, geben Sie den Wert an, auf den die Regel angewendet wird. Für den Parameter value wird eine einzelne Zahl oder – wenn type für between oder not between festgelegt ist – eine Gruppe mit zwei Zahlen festgelegt.


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 festzulegen, 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 die Regel angewendet wird.


font_color: "#1f3e5a"

color_application

Mit dem color_application-Parameter und den zugehörigen Unterparametern collection_id, palette_id und options lässt sich eine bestimmte Farbsammlung und Palette auf eine Regel zur bedingten Formatierung anwenden.

Sie können einem LookML-Dashboard Farben hinzufügen, indem Sie die Sammlungs-ID und die Paletten-ID angeben. Sie können die Benutzeroberfläche auch verwenden, um die gewünschten Farben zu finden, und die LookML generieren, um sie Ihrem Dashboard hinzuzufügen. Rufen Sie einen benutzerdefinierten Inhalt (z. B. Look, Dashboard oder Erkunden) auf 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 des Dashboard-LookML ausführen, den erstellten LookML-Code kopieren und ihn im 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 du type auf along a scale... gesetzt hast. Sie hat die folgenden untergeordneten Parameter:

  • steps: Dieser Parameter begrenzt die Anzahl der verwendeten Farben auf den angegebenen Wert und teilt die Daten in diese Anzahl von Gruppen auf. Wenn dieser Parameter nicht verwendet wird, werden die Daten entsprechend dem gesamten Farbverlauf farblich gekennzeichnet. Werte von 2 bis 100 sind zulässig.
  • mirror: Wenn dieser Parameter auf true gesetzt ist, wendet dieser Parameter auf jeder Seite der Farbpalette die gleichen Farbverschiebungen an, um beide Werte auf einer Seite des definierten Mittelpunkts zu erreichen. true oder false sind zulässig.
  • constraints: Mit diesem Parameter wird der Datenbereich festgelegt, für den die bedingte Formatierung gilt. Außerdem wird ein Mittelpunkt festgelegt, der für die Palettenanwendung verwendet werden soll. Folgende Syntax ist zulässig: constraints: {min: {type: number, value: 3}, max: {type: percentile, value: 99}, mid: {type: average}}
  • reverse: Dieser Parameter bestimmt, ob die Farbpalette während der Farbanwendung umgedreht wird. true oder false sind zulässig.

bold

Legen Sie bei der Farbcodierung basierend auf einer logischen Bedingung fest, ob die Werte, auf die Ihre Regel angewendet wird, fett formatiert werden sollen.


bold: true | false

italic

Legen Sie bei der Farbcodierung basierend auf einer logischen Bedingung fest, ob die Werte, auf die die Regel angewendet werden soll, kursiv dargestellt werden sollen.


italic: true | false

strikethrough

Legen Sie bei der Farbcodierung basierend auf einer logischen Bedingung fest, ob die Werte für Ihre Regel durchgestrichen formatiert 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 ]