Auf dieser Seite finden Sie Links zu allen LookML-Parametern, mit denen Felder definiert werden.
Es gibt verschiedene Arten von Feldern:
- Dimensionen stellen eine Spalte in einer Tabelle oder einen berechneten Wert dar, der auf einer Art von Spaltenmanipulation oder -kombination basiert.
- Dimensionsgruppen werden nur für zeitbasierte Daten verwendet und ermöglichen es Ihnen, viele zeitbasierte Dimensionen gleichzeitig zu erstellen.
- Messwerte ähneln Aggregatfunktionen in SQL (z. B.
COUNT,SUM,AVG) und stellen Informationen zu mehreren Zeilen dar. - Mit Filtern wird ein reines Filterfeld erstellt, mit dem Nutzer Eingaben für einen Vorlagenfilter oder einen bedingten Join machen können.
- Mit Parametern wird ein Nur-Filter-Feld erstellt, mit dem Nutzer Eingaben für ein Liquid-
{% parameter %}-Tag machen können.
Nutzungsbeispiel
Bewegen Sie den Mauszeiger auf einen Parameternamen, um eine kurze Beschreibung aufzurufen. Klicken Sie auf einen Parameternamen, um die zugehörige Referenzseite aufzurufen.
Wenn ein Parameter auf eine von mehreren spezifischen Optionen festgelegt werden kann, wird der Standardwert zuerst aufgeführt.
## STRUCTURAL PARAMETERS view: view_name { (dimension |dimension_group |measure |filter | parameter):field_name{ intervals: [interval, interval, …] timeframes: [timeframe, timeframe, …] # ACTION AND LINKING PARAMETERS action: { label: "Label to Appear in Action Menu" url: "url" icon_url: "url" form_url: "url" param: { name: "name string" value: "value string" } # Possibly more param definitions form_param: { name: "title" type: select | string | textarea label: "desired label name" required: yes | no default: "value string" option: { name: "name string" value: "value string" } # Possibly more option definitions } # Possibly more form_param definitions } drill_fields: [field_or_set, field_or_set, ...] tags: ["string1", "string2", ...] link: { label: "desired label name;" url: "desired_url" icon_url: "url_of_an_image_file" } # Possibly more link definitions # DISPLAY PARAMETERS alias: [old_field_name, old_field_name, ...] alpha_sort: yes | no description: "description string" group_label: "desired group label name" group_item_label: "label to use under the group label in the field picker" hidden: yes | no label: "desired label name" label_from_parameter: parameter_name order_by_field: dimension_name | dimension_group_name | measure_name style: classic | interval | integer | relational view_label: "desired label name" # FILTER PARAMETERS can_filter: yes | no case_sensitive: yes | no filters: [dimension: "filter expression", dimension: "filter expression", ...] skip_drill_filter: yes | no # FILTER SUGGESTION PARAMETERS allowed_value: { label: "desired label name" value: "looker filter expression" } # Possibly more allowed_value definitions bypass_suggest_restrictions: yes | no full_suggestions: yes | no suggest_dimension: dimension_name suggest_explore: explore_name suggest_persist_for: "N (seconds | minutes | hours)" suggestable: yes | no suggestions: ["suggestion string", "suggestion string", "…"]< # QUERY PARAMETERS allow_approximate_optimization: yes | no approximate: yes | no approximate_threshold: N convert_tz: yes | no datatype: epoch | timestamp | datetime | date | yyyymmdd fanout_on: repeated_record_name precision: N primary_key: yes | no required_access_grants: [access_grant_name, access_grant_name, ...] required_fields: [field_name, field_name, ...] sql_distinct_key: SQL expression to define repeated entities ;; # VALUE AND FORMATTING PARAMETERS case: { when: { sql: SQL condition ;; label: "value" } # Possibly more when statements } default_value: "desired default value" direction: "row | column" end_location_field: dimension_name html: HTML expression using Liquid template elements ;; list_field: dimension_name percentile: Nth percentile sql: SQL expression to generate the field value ;; sql_end: SQL expression indicating the end time of a duration ;; sql_latitude: SQL expression to generate a latitude ;; sql_longitude: SQL expression to generate a longitude ;; sql_start: SQL expression indicating the start time of a duration ;; start_location_field: dimension_name synonyms: [synonym1, synonym2, ...] tiers: [N, N, ...] type: dimension_field_type # For a dimension field type: dimension_group_type # For a dimension_group field type: measure_field_type # For a measure field type: filter_field_type # For a filter field type: parameter_field_type # For a parameter field string_datatype: unicode # For a dimension field units: feet | kilometers | meters | miles | nautical_miles | yards value_format: "excel-style formatting string" value_format_name: format_name # VISUALIZATION PARAMETERS allow_fill: yes | no map_layer_name: name_of_map_layer } }
Parameterdefinitionen
- D = Dimension
- DG = Dimensionsgruppe
- M = Measure (Messen)
- F = Filter
- P = Parameter
| Parametername | Gültige Feldtypen | Beschreibung |
|---|---|---|
| Strukturparameter | ||
dimension
|
D | Erstellt ein Dimensionsfeld |
dimension_group
|
DG | Erstellt mehrere zeitbasierte Dimensionen gleichzeitig |
filter
|
F | Erstellt ein reines Filterfeld für die Verwendung in einem Vorlagenfilter oder einem bedingten Join |
measure
|
M | Erstellt ein Messwertfeld |
parameter
|
P | Erstellt ein reines Filterfeld, mit dem Benutzer Eingaben für ein Liquid-{% parameter %}-Tag machen können. |
intervals
|
DG | Definiert die gewünschten Zeitdauerdimensionen in einer dimension_group vom Typ type: duration. |
timeframes
|
DG | Definiert die gewünschten Zeitrahmen-Dimensionen in einer dimension_group vom Typ type: time. |
| Aktions- und Verknüpfungsparameter | ||
action
|
D M | Erstellt eine Datenaktion in einem Feld, mit der Benutzer direkt über Looker Aufgaben in anderen Tools durchführen können. |
drill_fields
|
D DG M | Deklariert die Liste der Felder, die angezeigt werden sollen, wenn ein Messwert oder eine Dimension aufgeschlüsselt wird |
link
|
D M | Erstellt Links zu anderen Looker- und externen Inhalten. |
tags
|
D DG M F P | Fügt Text hinzu, der an andere Anwendungen weitergeleitet werden kann, um Daten zu einem Feld bereitzustellen |
| Anzeigeparameter | ||
alias
|
D DG M F P | Legt fest, dass gespeicherte URLs mit alten Feldnamen nach der Umbenennung eines Feldes funktionsfähig bleiben |
alpha_sort
|
D | Legen Sie fest, dass die Bedingungen des Parameters case alphabetisch sortiert werden sollen.
|
description
|
D DG M F P | Fügt eine Beschreibung zum Feld hinzu, die Benutzern angezeigt wird, wenn sie mit der Maus auf das Feld zeigen. |
group_label
|
D DG M F | Gruppiert Felder innerhalb einer Ansicht in der Feldauswahl |
group_item_label
|
D DG M F | Gibt ein Label an, das für das Feld unter dem Gruppenlabel in der Feldauswahl verwendet werden soll |
hidden
|
D DG M F P | Blendet ein Feld in der Explore-Benutzeroberfläche aus |
label
|
D DG M F P | Ändert die Darstellung eines Feldnamens in der Feldauswahl |
label_from_parameter
|
D M | Ändert die Art und Weise, wie ein Feldname in einer Visualisierung basierend auf der Eingabe in einem parameter angezeigt wird |
order_by_field
|
D DG M | Sortiert ein Feld anhand der Werte eines anderen Feldes Unterstützt für Dimensionen, Dimensionsgruppen Unterstützt für Measures |
style
|
D | Ändert die Art und Weise, wie Ebenen in der Looker-Benutzeroberfläche für eine Dimension vom Typ type: tier angezeigt werden. |
view_label
|
D DG M F P | Ändert die Felder, die innerhalb einer Ansicht in der Feldauswahl angezeigt werden |
| Filterparameter | ||
can_filter
|
D DG M | Bestimmt, ob eine Dimension oder ein Messwert als Filter verwendet werden kann |
case_sensitive
|
D F | Bestimmt, ob bei Filtern für eine Dimension zwischen Groß- und Kleinschreibung unterschieden werden soll |
filter
|
F | Erstellt ein reines Filterfeld für die Verwendung in einem Vorlagenfilter |
filters
|
M | Schränkt die Berechnung eines Messwerts auf der Grundlage von Dimensionsbegrenzungen ein. |
skip_drill_filter
|
D | Verhindert, dass eine Dimension im Rahmen der Aufschlüsselung eines Messwerts zu den Filtern hinzugefügt wird |
| Parameter für Filtervorschläge | ||
allowed_value
|
P | Gibt die Auswahlmöglichkeiten für ein parameter an. |
bypass_suggest_restrictions
|
D DG F P | Zeigt den Benutzern Vorschläge an, wenn sql_always_where verwendet wird. Diese Einschränkungen werden jedoch nicht auf die Vorschläge angewendet. |
full_suggestions
|
D DG F P | Steuert, wie Looker Ihre Datenbank abfragt, um Vorschläge für die Werte eines Felds im Filter eines Explores zu erhalten. Looker kann eine einfache SELECT DISTINCT-Abfrage oder die vollständige Logik des Explores verwenden, einschließlich Joins und der Parameter sql_always_where und access_filter. |
suggest_dimension
|
D DG M F P | Gibt die Vorschläge für ein Feld basierend auf den Werten einer anderen Dimension an |
suggest_explore
|
D DG M F P | Gibt die Vorschläge für ein Feld basierend auf den Werten eines anderen Explore an |
suggest_persist_for
|
D F P | Ändert die Cache-Einstellungen für Looker-Filtervorschläge |
suggestable
|
D DG M F P | Aktiviert oder deaktiviert Vorschläge für ein Feld |
suggestions
|
D F P | Deklariert eine Liste mit Werten, die für die Vorschläge zu einem Feld verwendet werden sollen |
| Suchparameter | ||
allow_approximate_optimization |
M | Ermöglicht Näherungswerte für die Anzahl unterschiedlicher Werte für Measures vom Typ type: count oder type: count_distinct, sodass das Measure für Aggregat-Awareness verwendet werden kann |
approximate |
M | Führt eine ungefähre Zählung für einen Messwert von type: count_distinct durch. Eine Liste der Dialekte, die diesen Parameter unterstützen, finden Sie auf der Dokumentationsseite zu approximate. |
approximate_threshold
|
M | Legt die Anzahl von Messwerten fest, bei der BigQuery von einer genauen Anzahl zu einer ungefähren Anzahl wechseln soll |
convert_tz
|
D DG M F P | Deaktiviert die automatische Zeitzonenumwandlung für ein Feld |
datatype
|
D DG F M | Gibt den Typ der Zeitdaten an, die für ein Feld bereitgestellt werden |
fanout_on
|
D DG M | Aktiviert den Zugriff auf sich wiederholende Felder in Google BigQuery |
precision
|
M | Gibt die Anzahl der Dezimalstellen an, die bei Berechnungen für symmetrische Aggregate in Looker verwendet werden sollen |
primary_key
|
D | Deklariert eine Dimension als Primärschlüssel einer Ansicht |
required_access_grants |
D DG F M P | Beschränkt den Zugriff auf das Feld auf die Benutzer, deren Benutzerattributwerte mit den Zugriffsrechten übereinstimmen |
required_fields
|
D M | Legt fest, dass bei Auswahl eines Feldes zusätzliche Felder zu einer Abfrage hinzugefügt werden müssen |
sql_distinct_key
|
M | Definiert die eindeutigen Entitäten, für die ein Messwert von type: sum_distinct oder type: average_distinct berechnet wird |
| Wert- und Formatierungsparameter | ||
case
|
D | Erstellt einen diskreten Satz von Werten, den eine Dimension haben kann, bestimmt durch SQL-Bedingungen. |
default_value
|
F P | Legt einen Standardwert für Filterfelder fest. |
direction
|
M | Bestimmt die Richtung, in der ein Messwert vom Typ type: percent_of_total oder type: running_total berechnet wird, wenn Pivots verwendet werden |
end_location_field
|
D | Definiert das Feld, das den Zielort für ein Feld vom Typ type: distance enthält |
html
|
D DG M | Ändert die HTML-Ausgabe eines Feldes mithilfe von Liquid-Vorlagen |
list_field
|
M | Gibt die Dimension an, anhand derer ein Messwert vom Typ type: list berechnet wird |
percentile
|
M | Gibt den Bruchwert (das n-te Perzentil) für einen Messwert vom Typ type: percentile oder type: percentile_distinct an. |
sql
|
D DG M F | Legt die Berechnungsmethode für ein Feld fest |
sql_end
|
D DG | Definiert die Endzeit einer Dauer für eine Dimensionsgruppe vom Typ „Dauer“ oder eine Dimension vom Typ „Dauer“ |
sql_latitude
|
D | Definiert den Breitengrad einer Dimension vom Typ type: location |
sql_longitude
|
D | Definiert den Längengrad einer Dimension vom Typ type: location. |
sql_start
|
D DG | Definiert den Beginn einer Dauer für eine Dimensionsgruppe vom Typ „Dauer“ oder eine Dimension vom Typ „Dauer“ |
start_location_field
|
D | Definiert das Feld, das die Startposition für ein Feld vom Typ type: distance enthält. |
synonyms
|
D DG F M P | Gibt eine Liste von String-Synonymen (Wörtern oder Wortgruppen) an, die Large Language Models und App-Entwicklern helfen können, andere Möglichkeiten zu verstehen, wie Nutzer auf ein Feld verweisen können |
tiers
|
D | Definiert die Ebenen für eine Dimension vom Typ type: tier |
type (für Dimension, Filter oder Parameter)
|
D F P | Gibt den Typ der Dimension, des Filters oder des Parameters an |
type (für Dimensionsgruppe)
|
DG | Gibt den Typ der Dimensionsgruppe an |
type (für Messwert)
|
M | Gibt den Typ des Messwerts an |
string_datatype
|
D | Gibt den Unicode-Datentyp für ein Feld vom Typ type: string für SQL Server oder MySQL an. |
units
|
D | Gibt die Einheiten an, die für ein Feld vom Typ type: distance verwendet werden sollen |
value_format
|
D M | Formatiert die Ausgabe eines Feldes mithilfe von Excel-Stiloptionen |
value_format_name
|
D M | Formatiert die Ausgabe eines Feldes mithilfe eines integrierten oder benutzerdefinierten Formats |
| Visualisierungsparameter | ||
allow_fill
|
D DG | Bestimmt, ob für eine bestimmte Dimension die Dimensionsbefüllung zulässig sein soll |
map_layer_name
|
D | Gibt eine Zuordnung von einem Datenwert zu einem geografischen Bereich an, die Sie auf einer integrierten oder benutzerdefinierten Karte definiert haben |
| Unzulässige Parameter | ||
decimals
|
D M |
5.4 entfernt
Ersetzt durch value_format
|
format
|
D M |
Entfernt in Version 3.16
Ersetzt durch value_format |