Auf dieser Seite wird beschrieben, wie Sie ein LookML-Dashboard-Element von type: looker_grid
mit LookML-Dashboard-Parametern in einer dashboard.lkml
-Datei hinzufügen und anpassen.
Informationen zum Erstellen eines Tabellendiagramms über die Looker-Benutzeroberfläche finden Sie auf der Dokumentationsseite zu Tabellendiagrammoptionen.
Nutzungsbeispiel
## BASIC PARAMETERS
name: element_name
title: 'Element Title'
type: looker_grid
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, …]
pivots: [view_name.field_name, view_name.field_name, …]
fill_fields: [view_name.field_name, view_name.field_name, …]
subtotals: [view_name.field_name, view_name.field_name, …]
total: true | false
row_total: right | left | false
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
query_timezone: 'specific timezone' | user_timezone
analysis_config: # can only be used when the Forecasting Labs feature is enabled
forecasting:
- confidence_interval: N
field_name: view_name.field_name
forecast_n: N
forecast_interval: day | month | a time frame with dimension fill
seasonality: N
merged_queries:
- 'primary query definition'
- 'next source query definition'
join_fields:
- field_name: view_name.field_name
source_field_name: view_name.field_name
## COLUMN PARAMETERS
auto_size_all_columns: true | false
column_order: [view_name.field_name, view_name.field_name, …]
pinned_columns:
view_name.field_name: left
## PLOT PARAMETERS
table_theme: editable | white | gray | transparent | unstyled
show_row_numbers: true | false
hide_totals: true | false
hide_row_totals: true | false
transpose: 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_text: true | false
show_view_names: true | false
size_to_fit: true | false
dynamic_fields:
- table_calculation: {'table calculation definition'}
- measure: {'custom measure or custom filtered measure definition'}
- dimension: {'custom dimension definition'}
series_labels:
view_name.field_name: 'Series Label'
series_column_widths:
view_name.field_name: N
series_cell_visualizations:
view_name.field_name:
is_active: true | false
palette:
palette_id: 'palette ID'
collection_id: 'collection ID'
custom_colors:
- 'color value'
value_display: true | false
series_text_format:
view_name.field_name:
fg_color: 'color value'
bg_color: 'color value'
bold: true | false
italic: true | false
align: left | center | right
series_collapsed:
view_name.field_name: true | false
series_value_format:
view_name.field_name:
format_string: 'value formatting string'
## FORMATTING PARAMETERS
color_application:
collection_id: 'collection ID'
palette_id: 'palette ID'
header_font_color: 'color value'
header_background_color: 'color value'
header_text_alignment: left | center | right
header_font_size: N
rows_font_size: N
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_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 in einem 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 | |
pivots |
Definiert die Dimensionen, die für die Abfrage des Elements verwendet werden sollen | |
fill_fields |
Definiert die Dimensionen, für die die Option Dimensionsfüllung verwendet wird | |
subtotals |
Definiert die Felder mit Zwischensumme | |
total |
Gibt an, ob Spaltensummen für eine Tabellenvisualisierung angezeigt werden | |
row_total |
Gibt an, ob Zeilensummen für eine Tabellenvisualisierung angezeigt werden | |
limit |
Definiert das Zeilenlimit, das für die Abfrage des Elements verwendet werden soll | |
column_limit |
Definiert das Spaltenlimit, 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. |
|
query_timezone |
Definiert die Zeitzone, die bei der Ausführung der Abfrage verwendet werden soll | |
analysis_config |
ADDED 21.14 Definiert die Prognoseanalyse, die beim Ausführen der Abfrage ausgeführt werden soll. Hierfür muss die Labs-Funktion Prognose aktiviert sein. | |
merged_queries |
Definiert eine merged results-Abfrage. | |
Spaltenparameter | ||
auto_size_all_columns |
Die Größe jeder Tabellenspalte wird automatisch an die Spaltenüberschrift oder den längsten Datenwert angepasst, je nachdem, welcher Wert größer ist | |
column_order |
Spalten im Tabellendiagramm anordnen | |
pinned_columns |
Definiert die Spalten, die auf der linken Seite des Tabellendiagramms angepinnt oder fixiert werden sollen | |
Parameter festlegen | ||
table_theme |
Eine von fünf Tabellenfarboptionen auf eine Tabellenvisualisierung anwenden | |
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 | |
transpose |
Legt fest, ob Tabellenzeilen in Spalten transponiert 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 | |
Parameter der Reihe | ||
truncate_text |
Kürzt Spaltenüberschriften und Text in Datenzellen mit Auslassungspunkten (...) | |
show_view_names |
Zeigt den Namen der Ansicht zusammen mit dem Feldnamen der einzelnen Spaltenüberschriften an | |
size_to_fit |
Die Breite der Spalten wird automatisch an die Breite des Elements angepasst, in dem sie dargestellt wird. | |
dynamic_fields |
Enthält Tabellenberechnungen oder benutzerdefinierte Felder in Ihrem Tabellendiagramm | |
series_labels |
Gibt für jede Spalte in der Visualisierung ein benutzerdefiniertes Label an | |
series_column_widths |
Gibt bestimmte Breiten für Spalten in der Visualisierung an | |
series_cell_visualizations |
Gibt an, ob Spalten die Visualisierungsoption Zellenvisualisierung verwenden. Dieser Parameter hat die Unterparameter is_active , palette und value_display . |
|
series_text_format |
Gibt das Textlayout für jede Spalte an. Dieser Parameter hat die Unterparameter fg_color , bg_color , bold , italic und align . |
|
series_collapsed |
Gibt an, ob eine Spalte mit Zwischensummen minimiert wird | |
series_value_format |
Definiert das Werteformat für eine Spalte mithilfe der benutzerdefinierten Formatierung. | |
Parameter formatieren | ||
color_application |
Wendet Farben auf Zellenvisualisierungen und bedingte Formatierung an | |
header_font_color |
Schriftfarbe wird auf Spaltenüberschriften angewendet | |
header_background_color |
Farbe auf die Hintergründe von Spaltenüberschriften anwenden | |
header_text_alignment |
Wendet links, rechts oder zentriert an den Spaltenüberschriften an | |
header_font_size |
Schriftgröße wird auf Spaltenüberschriften angewendet | |
rows_font_size |
Schriftgröße wird auf Text in Datenzellen angewendet | |
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 Parametertype
(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 Parameterexplore
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]
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]
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]
subtotals
Der Parameter subtotals
definiert die Dimensionen, für die die Option Zwischensummen verwendet wird. Verwenden Sie die Syntax view_name.dimension_name
, um die Abmessungen anzugeben.
subtotals: [products.department, distribution_centers.name]
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
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
column_limit
Der Parameter column_limit
definiert das Spaltenlimit, das für die Elementabfrage verwendet werden soll. Das Limit gilt für die Anzahl der Spalten, nachdem Pivots angewendet wurden.
- name: orders_by_date
column_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 Parameterfilters
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.
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
analysis_config
Der Parameter analysis_config
und seine Unterparameter beschreiben alle Abfrageanalysen für die Visualisierung ab Looker 21.14. Die Labs-Funktion Prognosen muss aktiviert sein, damit Analysen zu Visualisierungen durchgeführt werden können.
Mit den folgenden Unterparametern können Sie Analysen definieren:
Sie können eine Prognose mit einer Syntax wie dieser erstellen:
analysis_config:
- forecasting:
confidence_interval: 0.95
field_name: orders.count
forecast_n: 14
forecast_interval: day
seasonality: 7
forecasting
forecasting
ist ein Analysetyp, bei dem eine Prognose auf eine Visualisierung angewendet wird. Mithilfe von Prognosen können Analysten neuen oder vorhandenen Explore-Abfragen schnell Datenprojektionen hinzufügen, damit Nutzer bestimmte Datenpunkte vorhersagen und beobachten können.
Weitere Informationen finden Sie auf der Dokumentationsseite Prognosen in Visualisierungen.
Damit Visualisierungen Prognosen erstellt werden können, muss die Labs-Funktion Prognosen aktiviert sein.
confidence_interval
confidence_interval
legt die Grenzen der prognostizierten Datenwerte fest, die als Dezimalausdrücke von Prozentsätzen eingegeben werden. confidence_interval
ist optional und leer.
confidence_interval: 0.99 | 0.98 | 0.95 | 0.90 | 0.80
Weitere Informationen finden Sie im Abschnitt Vorhersageintervall auf der Dokumentationsseite Prognosen in Visualisierungen.
Damit Visualisierungen Prognosen erstellt werden können, muss die Labs-Funktion Prognosen aktiviert sein.
field_name
field_name
gibt die Namen der Maßnahmen (bis zu fünf) an, die in die Prognosen einbezogen werden sollen.
field_name: view_name.field_name
forecast_n
forecast_n
gibt die Länge der Prognose an.
forecast_n: N # An integer that represents the length of the forecast
Weitere Informationen finden Sie im Abschnitt Länge auf der Dokumentationsseite Prognosen in Visualisierungen.
Damit Visualisierungen Prognosen erstellt werden können, muss die Labs-Funktion Prognosen aktiviert sein.
forecast_interval
forecast_interval
legt das Zeitintervall fest, für das Datenwerte prognostiziert werden sollen. forecast_interval
wird automatisch basierend auf der Zeitraumdimension in der Abfrage „Erkunden“ ausgefüllt.
forecast_interval: day | month # a timeframe with dimension fill
Weitere Informationen finden Sie auf der Dokumentationsseite Länge.
Damit Visualisierungen Prognosen erstellt werden können, muss die Labs-Funktion Prognosen aktiviert sein.
seasonality
Mit seasonality
können Analysten in einer Prognose bekannte Zyklen oder sich wiederholende Datentrends berücksichtigen. seasonality
ist optional und leer.
seasonality: N # An integer that represents the number of rows over which a cycle or pattern repeats
Die Saisoneinstellung Automatisch wird als leerer Wert für seasonality
dargestellt.
Weitere Informationen finden Sie im Abschnitt Saisonalität auf der Dokumentationsseite Prognosen in Visualisierungen.
Damit Visualisierungen Prognosen erstellt werden können, muss die Labs-Funktion Prognosen aktiviert sein.
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.
Spaltenparameter
Die folgenden Parameter entsprechen der Funktion zum Verschieben und Anpinnen von Spalten in Tabellendiagrammen.
auto_size_all_columns
Mit dem Parameter auto_size_all_columns
wird die Größe jeder Tabellenspalte automatisch an die Spaltenüberschrift oder den längsten Datenwert angepasst – je nachdem, welcher Wert größer ist. Dieser Parameter überschreibt die Parameter series_column_widths
und size_to_fit
, wenn sie definiert sind.
- name: orders_by_date
auto_size_all_columns: true
column_order
Der Parameter column_order
definiert die Reihenfolge der Spalten im Tabellendiagramm.
- name: orders_by_date
column_order: [customer.city, customer.state, customer.count]
pinned_columns
Der Parameter pinned_columns
definiert alle Spalten, die links vom Tabellendiagramm angepinnt sind.
- name: orders_by_date
pinned_columns:
orders.created_date: left
distribution_centers.name: left
Parameter darstellen
Die folgenden Parameter entsprechen den Optionen im Menü Diagramm des Visualisierungseditors für Tabellendiagramme.
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 vontable_theme
auftransparent
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
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
transpose
Mit dem Parameter transpose
können Sie Tabellenzeilen in Spalten transponieren. true
oder false
sind zulässig.
- name: orders_by_date
transpose: true
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 Menü Reihe des Visualisierungseditors für Tabellendiagramme.
truncate_text
Mit dem Parameter truncate_text
wird festgelegt, ob Spaltenüberschriften und Text in Datenzellen mit Auslassungspunkten (...) gekürzt werden sollen.
truncate_text: 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
size_to_fit
Mit dem Parameter size_to_fit
wird festgelegt, ob die Breite aller Spalten so angepasst werden soll, dass die Tabelle genau der Breite des Elements entspricht, in dem sie dargestellt wird. Wenn der Parameter auto_size_all_columns
auf true
gesetzt ist, wird size_to_fit
überschrieben.
size_to_fit: true | false
dynamic_fields
Der Parameter dynamic_fields
und seine Unterparameter beschreiben alle Tabellenberechnungen oder benutzerdefinierten Felder, die für die Visualisierung verwendet werden. Sie benötigen die Berechtigung zum Erstellen benutzerdefinierter Felder, um eine description
mit bis zu 255 Zeichen hinzuzufügen oder calculation_type
für benutzerdefinierte Gruppen oder benutzerdefinierte Klassen zu verwenden. Sie benötigen die Berechtigung zum Erstellen von Tabellenberechnungen, um Tabellenberechnungen eine description
mit bis zu 255 Zeichen hinzufügen oder calculation_type
für Verknüpfungsberechnungen verwenden zu können.
Mit den folgenden Unterparametern können Sie dynamische Felder definieren:
table_calculation
measure
dimension
label
based_on
type
expression
filter_expression
value_format
value_format_name
calculation_type
args
_kind_hint
_type_hint
is_disabled
description
Sie können eine Tabellenberechnung mit einer Syntax wie der folgenden erstellen:
dynamic_fields:
- table_calculation: running_total
label: Running Total of Items
expression: running_total(${inventory_items.count})
value_format_name: decimal_0
description: your description of up to 255 characters here
_kind_hint: measure
_type_hint: number
is_disabled: false
Sie können Verknüpfungsberechnungen für mehrere Berechnungs typen mit einer Syntax wie dieser erstellen:
dynamic_fields:
- category: table_calculation
description: your description of up to 255 characters here
label: Percent of Orders Count
value_format:
value_format_name: percent_0
calculation_type: percent_of_column_sum
table_calculation: percent_of_orders_count
args:
- orders.count
_kind_hint: measure
_type_hint: number
- category: table_calculation
description: your description of up to 255 characters here
label: Percent of previous - Orders Count
value_format:
value_format_name: percent_0
calculation_type: percent_of_previous
table_calculation: percent_of_previous_orders_count
args:
- orders.count
_kind_hint: measure
_type_hint: number
- category: table_calculation
description: your description of up to 255 characters here
label: Percent change from previous - Orders Count
value_format:
value_format_name: percent_0
calculation_type: percent_difference_from_previous
table_calculation: percent_change_from_previous_orders_count
args:
- orders.count
_kind_hint: measure
_type_hint: number
- category: table_calculation
description: your description of up to 255 characters here
label: Rank of Orders Count
value_format: ## this field is optional
value_format_name: ## this field is optional
calculation_type: rank_of_column
table_calculation: rank_of_orders_count
args:
- orders.count
_kind_hint: measure
_type_hint: number
- category: table_calculation
description: your description of up to 255 characters here
label: Running total of Orders Count
value_format: ## this field is optional
value_format_name: ## this field is optional
calculation_type: running_total
table_calculation: running_total_of_orders_count
args:
- orders.count
_kind_hint: measure
_type_hint: number
Sie können ein benutzerdefiniertes Maß für die Visualisierung mit einer Syntax wie der folgenden erstellen:
dynamic_fields:
- measure: avg_sale_price
label: Average Sale Price
based_on: products.sale_price
type: average
value_format_name: usd
description: your description of up to 255 characters here
_kind_hint: measure
_type_hint: number
Sie können ein gefiltertes benutzerdefiniertes Maß mit folgender Syntax für die Visualisierung erstellen:
dynamic_fields:
- measure: order_count_for_25_47_year_olds
based_on: order_items.order_count
type: count_distinct
label: Order Count for 25- to 47-Year-Olds
description: your description of up to 255 characters here
value_format: 00#
_kind_hint: measure
_type_hint: number
filter_expression: "${users.age} >= 25 AND ${users.age} <= 47"
Sie können eine benutzerdefinierte Dimension mit folgender Syntax erstellen:
dynamic_fields:
- dimension: user_city_state
label: User City and State
expression: concat(${users.city}, ", ", ${users.state})
description: your description of up to 255 characters here
_kind_hint: dimension
_type_hint: string
Sie können benutzerdefinierte Gruppen für eine Dimension erstellen, um sie in der Visualisierung zu verwenden. Verwenden Sie dazu eine Syntax:
- category: dimension
description: 'States by region'
label: State Groups
value_format: ## this field is optional
value_format_name: ## this field is optional
calculation_type: group_by
dimension: state_groups
args:
- users.state
- - label: Pacific Northwest
filter: Oregon,Idaho,Washington
- Other
_kind_hint: dimension
_type_hint: string
Mit der folgenden Syntax können Sie benutzerdefinierte Klassen für eine Dimension erstellen:
- category: dimension
description: Order item sale prices, in tiers of 10
label: Sale Price Bins
value_format:
value_format_name:
calculation_type: bin
dimension: sale_price_bins
args:
- order_items.sale_price
- '10'
- '0'
- '100'
-
- classic
_kind_hint: dimension
_type_hint: string
Sie können Ihrem Element mehrere dynamische Felder hinzufügen. Sie müssen dem Parameter fields
keine Tabellenberechnungen hinzufügen, damit sie in der Visualisierung erscheinen. Sie müssen jedoch andere Arten von dynamischen Feldern zu fields
hinzufügen, damit sie angezeigt werden.
table_calculation
Wenn Sie eine Tabellenberechnung definieren, gibt der Unterparameter table_calculation
die Tabellenberechnung an. Dieser Name wird verwendet, wenn Sie in LookML auf die Tabellenberechnung verweisen.
measure
Der Unterparameter measure
definiert den Namen eines benutzerdefinierten Messwerts oder eines gefilterten benutzerdefinierten Messwerts. Dies ist der Name, den Sie zum Verweis auf die Messung in LookML verwenden.
dimension
Der Unterparameter dimension
definiert den Namen für eine benutzerdefinierte Dimension. Dies ist der Name, mit dem auf die Dimension in LookML verwiesen wird.
label
Der Unterparameter label
definiert den Titel des dynamischen Felds, wie er in der Visualisierung angezeigt werden soll. Er kann mit dem Namen in den Unterparametern table_calculation
, measure
oder dimension
übereinstimmen oder sich davon unterscheiden.
based_on
Wenn du ein benutzerdefiniertes Maß oder ein gefiltertes benutzerdefiniertes Maß verwendest, gibt der Unterparameter based_on
mithilfe der Systaxe view_name.field_name
den entsprechenden Messwert an.
type
Wenn Sie ein benutzerdefiniertes Maß verwenden, wird mit dem Unterparameter type
der Aggregationstyp angegeben. Zulässig sind count_distinct
, sum
, average
, min
, max
und median
.
description
Mit dem Unterparameter description
können Sie einem benutzerdefinierten Feld oder einer benutzerdefinierten Tabelle eine Beschreibung von bis zu 255 Zeichen hinzufügen. Looker zeigt die Beschreibung an, wenn der Nutzer auf das Informationssymbol rechts neben dem Feldnamen in der Feldauswahl klickt und in einer Erkundung, einem Dashboard oder einem Look den Mauszeiger auf den Spaltennamen in einer Visualisierung von Tabellen oder Tabellendiagrammen bewegt.
expression
Wenn Sie eine Tabellenberechnung verwenden, wird mit dem Unterparameter expression
der Looker-Ausdruck definiert, der zum Erstellen der Tabellenberechnung verwendet wird.
filter_expression
Wenn Sie einen benutzerdefinierten gefilterten Messwert verwenden, definiert der Unterparameter filter_expression
den Looker-Ausdruck, der zum Filtern des Messwerts verwendet wird.
value_format
Der optionale Unterparameter value_format
definiert das Wertformat für ein dynamisches Feld, wenn Sie die benutzerdefinierte Formatierung verwenden. Wenn Sie ein Standard-Looker-Format verwenden möchten, verwenden Sie stattdessen value_format_name
.
value_format_name
Mit dem optionalen Unterparameter value_format_name
wird ein Standardformat auf das dynamische Feld angewendet. Wenn Sie ein benutzerdefiniertes Format verwenden möchten, verwenden Sie stattdessen value_format
.
calculation_type
Mit dem Unterparameter calculation_type
wird der Typ der Verknüpfungsberechnung oder Gruppe definiert, um eine Tabellenberechnung oder eine benutzerdefinierte Gruppe für eine Dimension zu erstellen:
Optionen für benutzerdefinierte Felder calculation_type
:
group_by
: Gruppiert Dimensionswerte unter einem benutzerdefinierten festen Label basierend auf einer angegebenen benutzerdefinierten Bedingung. Ähnlich wieCASE WHEN
in SQL oder dem Feldparametercase
von LookML.bin
: Gruppiert Werte in benutzerdefinierten Klassen oder Stufen für numerische Typdimensionen und benutzerdefinierte Dimensionen. Ähnelt dem Dimensionstyptier
von LookML.
calculation_type
-Optionen für Tabellenberechnungen:
percent_of_column_sum
: Ein Zeilenwert geteilt durch die Summe der Werte in der Spalte. (Diese Berechnung nimmt nur Werte in die Datentabelle auf, wenn die Zeilengrenze der Abfrage erreicht ist.)percent_of_previous
: Der Wert einer aktuellen Zeile geteilt durch den Wert der Zeile darunter.percent_difference_from_previous
: Die Differenz zwischen dem Wert der aktuellen Zeile und dem Wert der Zeile unten, geteilt durch den Wert der Zeile unten.rank_of_column
: Der Rang des Zeilenwerts aus allen Werten in der Spalte. (Diese Berechnung nimmt nur Werte in die Datentabelle auf, wenn die Zeilengrenze der Abfrage erreicht ist.)running_total
: Die kumulative Summe des Werts der aktuellen Zeile und aller vorherigen Zeilen in der Spalte.percent_of_previous_column
: Bei Pivot-Feldern wird der Wert der aktuellen Spalte durch den Wert der Spalte links davon geteilt.percent_change_from_previous_column
: Bei Pivot-Feldern wird die Differenz zwischen dem Wert der aktuellen Spalte und dem Wert der Spalte links, geteilt durch den Wert der Spalte links, berechnet.percent_of_row
: Für Felder mit Pivoting der Prozentsatz des aktuellen Werts geteilt durch die Summe der Zeilen dieses Felds.running_row_total
: Bei Pivot-Feldern die kumulative Summe der aktuellen Spalte und aller vorherigen Spalten in dieser Zeile.
args
für benutzerdefinierte Gruppen
Wenn Sie benutzerdefinierte Gruppen für eine Dimension verwenden, gibt args
die Argumente für die Anwendung von festen Labels auf Dimensionswerte an. args
hat das folgende Format:
args:
- view_name.field_name
- label: specified custom label
filter: condition for values
- label: another specified custom label
filter: a different condition for values
- Other ## An optional customizable group label for values that do not meet specified conditions.
Sie können je nach Anzahl der gewünschten Gruppen beliebig viele label
- und filter
-Bedingungen hinzufügen.
Im vorherigen Beispiel sehen Sie eine Referenz.
args
für benutzerdefinierte Klassen
Wenn Sie benutzerdefinierte Klassen für eine numerische Dimension verwenden, gibt args
die Argumente für die Anwendung von festen Stufen auf Dimensionswerte an. args
hat das folgende Format:
args:
- view_name.field_name
- bin_size ## The numeric interval on which to base each bin, in single quotes
- min ## The numeric value of the minimum bin size, in single quotes
- max ## The numeric value of the maximum bin size, in single quotes
- override ## A value will only appear when a custom bin uses a Custom-sized bin type.
- style ## The bin display style. Currently, only classic is supported.
Im vorherigen Beispiel sehen Sie eine Referenz.
args
für Kurzberechnungen
Im Unterparameter args
geben Sie die Namen der numerischen Felder an, die Sie für eine Verknüpfungsberechnung verwenden. Ein Argument hat das folgende Format:
- args:
- view_name.field_name ## the field on which the calculation is based
Im vorherigen Beispiel sehen Sie eine Referenz.
_kind_hint
Der optionale Unterparameter _kind_hint
gibt an, ob das dynamische Feld eine Dimension oder einen Messwert zurückgibt. Die Werte dimension
und measure
werden akzeptiert.
_type_hint
Der optionale Unterparameter _type_hint
gibt den Datentyp an, den der Ausdruck des dynamischen Felds generieren soll.
is_disabled
Der optionale Unterparameter is_disabled
gibt an, ob eine Tabellenberechnung in der Visualisierung und in der zugrunde liegenden Ansicht „Erkunden“ angezeigt wird. Die Werte true
und false
werden akzeptiert.
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
series_column_widths
Die Breite einer oder mehrerer Spalten basierend auf dem Reihennamen festlegen. Wenn der Parameter auto_size_all_columns
auf true
gesetzt ist, wird series_column_widths
überschrieben.
series_column_widths:
order_times.shipping_time: 50
orders.count: 60
series_cell_visualizations
Geben Sie an, ob eine oder mehrere Spalten die Option Zellenvisualisierung verwenden. Geben Sie dazu den Seriennamen im Format view_name.field_name
an. series_cell_visualizations
hat die Unterparameter is_active
, palette
und value_display
.
series_cell_visualizations:
order_items.count:
is_active: true
palette:
palette_id: my-custom-colors-sequential-0
collection_id: my-custom-colors
value_display: true
is_active
Der optionale Unterparameter is_active
akzeptiert true
oder false
, um anzugeben, ob Balkenvisualisierungen für diese Reihe aktiviert sind. Wenn is_active
nicht definiert ist, wird standardmäßig true
verwendet.
palette
Der Unterparameter palette
ist optional. Wenn sie nicht verwendet wird, wird die Vorlage standardmäßig in der Standard-Farbsammlung der Instanz als abweichende Vorlage verwendet.
Wenn palette
verwendet wird, wenden die untergeordneten Parameter palette_id
und collection_id
die Farben aus einer bestimmten Palette auf die Balkenvisualisierungen an. Für palette_id
müssen Sie die ID einer sequenziellen oder abweichenden Palette verwenden. Weitere Informationen zu Paletten- und Farberfassungs-IDs finden Sie im Abschnitt color_application
.
palette
hat einen alternativen untergeordneten Parameter, custom_colors
, der zwei bis fünf benutzerdefinierte Farben für die Balken festlegt:
series_cell_visualizations:
order_items.count:
palette:
custom_colors:
- orange
- "#0000ff"
- red
value_display
Der optionale Unterparameter value_display
akzeptiert true
oder false
, um anzugeben, ob die Werte für jede Datenzelle zusammen mit der Zellenvisualisierung angezeigt werden sollen. Wenn value_display
nicht definiert ist, wird standardmäßig true
verwendet.
series_text_format
Der Parameter series_text_format
und seine Unterparameter geben das Zellentextlayout für jede Spalte an. Die zu formatierende Reihe wird mit der Syntax view_name.field_name
angegeben und die Unterparameter beschreiben die Formatierung.
Alle Unterparameter sind optional. Verwenden Sie nur diejenigen, die Sie benötigen.
series_text_format:
order_items.shipping_time:
align: right
order_items.shipped_date:
align: center
fg_color: "#EA8A2F"
bg_color: "#64518A"
bold: true
italic: true
fg_color
Der Unterparameter fg_color
gibt die Schriftfarbe für Zellentext an. Der Farbwert kann einen Hexadezimalstring wie #2ca6cd
oder einen CSS-benannten Farbstring wie mediumblue
haben.
bg_color
Der Unterparameter bg_color
gibt die Hintergrundfarbe der Zelle an. Der Farbwert kann einen Hexadezimalstring wie #2ca6cd
oder einen CSS-benannten Farbstring wie mediumblue
haben.
bold
Der Unterparameter bold
gibt an, ob der Zellentext fett formatiert ist, und akzeptiert true
oder false
.
italic
Der Unterparameter italic
gibt an, ob der Text kursiv ist, und akzeptiert true
oder false
.
align
Der Unterparameter align
gibt die Ausrichtung des Zellentexts an und akzeptiert left
, center
oder right
.
series_collapsed
Der Parameter series_collapsed
definiert, ob die Zwischensummen für eine bestimmte Reihe minimiert oder maximiert werden. Bestimme die Reihe mit der Syntax view_name.field_name
und true
oder false
.
series_collapsed:
users.city: false
users.state: true
Wenn die Spalte minimiert ist, werden die einzelnen Elemente der Zwischensumme durch Klicken auf den Pfeil links neben der Datenzelle angezeigt.
series_value_format
Der Parameter series_value_format
gibt die Formatierung an, die auf eine Datenreihe angewendet werden soll, unabhängig von der Formatierung, die auf die zugrunde liegende Dimension oder das zugrunde liegende Maß angewendet wird. Wenn series_value_format
nicht angegeben ist, wird der Wert im Format der zugrunde liegenden Dimension oder des zugrunde liegenden Messwerts angezeigt.
Legen Sie die zu formatierende Reihe mithilfe der view_name.field_name
-Syntax fest.
Mit dem Unterparameter format_string
können Sie das Format für die Datenreihe im Excel-Format definieren.
series_value_format:
products.retail_price:
format_string: "$#,##0.00"
Sie können die Formatierung auch so definieren:
series_value_format:
order_items.count: "00#"
Die im Unterparameter format_string
verwendete Formatierung entspricht der Formatierung im LookML-Parameter value_format
. Informationen dazu, wie Sie diese Formate angeben, finden Sie auf der Dokumentationsseite Benutzerdefinierte Formatierung zu numerischen Feldern hinzufügen.
Parameter formatieren
Die folgenden Parameter entsprechen den Optionen im Menü Formatierung des Visualisierungseditors für Tabellendiagramme.
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.
header_font_color
Der Parameter header_font_color
wendet eine Schriftfarbe auf die Spaltenüberschriften an.
Der Farbwert kann einen Hexadezimalstring wie #2ca6cd
oder einen CSS-benannten Farbstring wie mediumblue
haben.
header_font_color: purple
Die Standardfarbe hängt vom Tabellendesign ab, das mit dem Parameter table_theme
definiert wird.
header_background_color
Der Parameter header_background_color
wendet eine Farbe auf die Spaltenüberschriften im Hintergrund an.
Der Farbwert kann einen Hexadezimalstring wie #2ca6cd
oder einen CSS-benannten Farbstring wie mediumblue
haben.
header_background_color: #add8e6
Die Standardfarbe hängt vom Tabellendesign ab, das mit dem Parameter table_theme
definiert wird.
header_text_alignment
Der Parameter header_text_alignment
wendet die left
-, right
- oder center
-Ausrichtung auf Spaltenüberschriften an.
header_text_alignment: center
Die Standardausrichtung ist left
.
header_font_size
Der Parameter header_font_size
wendet eine Schriftgröße von 1
bis 99
auf die Spaltenüberschriften an.
header_font_size: 16
Die Standardgröße für Schriftarten für Kopfzeilen und Zeilen beträgt 12
.
rows_font_size
Der Parameter rows_font_size
wendet eine Schriftgröße von 1
bis 99
auf Text in Datenzellen an, aber nicht auf die Spaltenüberschriften.
rows_font_size: 8
Die Standardgröße für Schriftarten für Kopfzeilen und Zeilen beträgt 12
.
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ürvalue
angegebenen Zahl entsprechen.not equal to
: Die Regel gilt für Werte, die nicht der fürvalue
angegebenen Zahl entsprechen.greater than
: Die Regel gilt für Werte, die größer sind als die fürvalue
angegebene Zahl.less than
: Die Regel gilt für Werte, die kleiner als die fürvalue
angegebene Zahl sind.between
: Die Regel gilt für Werte, die zwischen den beiden fürvalue
angegebenen Zahlen liegen.not between
: Die Regel gilt für Werte, die nicht zwischen den beiden fürvalue
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 von2
bis100
sind zulässig.mirror
: Wenn dieser Parameter auftrue
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
oderfalse
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
oderfalse
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 ]