Feldparameter

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 Spaltenbearbeitung oder -kombination basiert.
• Dimensionsgruppen werden nur für zeitbasierte Daten verwendet. Damit können Sie viele zeitbasierte Dimensionen gleichzeitig 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 reines Filterfeld erstellt, mit dem Nutzer Eingaben für ein Liquid-{% parameter %}-Tag machen können.

Nutzungsbeispiel

Bewegen Sie den Mauszeiger auf einen Parameternamen, um eine Kurzbeschreibung aufzurufen. Klicken Sie auf einen Parameternamen, um zur zugehörigen Referenzseite zu springen.

Wenn ein Parameter auf eine von mehreren bestimmten 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 (Messung)
• 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 Nutzer Eingaben für ein Liquid-{% parameter %}-Tag machen können
intervals	DG	Definiert die Gruppe der Zeitspannen-Dimensionen, die Sie in einem dimension_group von type: duration haben möchten.
timeframes	DG	Definiert die gewünschten Zeitrahmen-Dimensionen in einem dimension_group von 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
Parameter für die Anzeige
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	Legt 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 den Mauszeiger auf das Feld verschieben.
group_label	D DG M F	Felder innerhalb einer Ansicht im Field Picker gruppieren
group_item_label	D DG M F	Gibt ein Label an, das für das Feld unter seinem 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 Art und Weise, wie ein Feldname im Field Picker angezeigt wird
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 und Dimensionsgruppen Unterstützt für Messungen
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 im Field Picker 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 Empfehlungen filtern
allowed_value	P	Gibt die Optionen für eine parameter an.
bypass_suggest_restrictions	D DG F P	Zeigen Sie den Nutzern Vorschläge an, wenn sql_always_where verwendet wird. Wenden Sie diese Einschränkungen jedoch nicht auf die Vorschläge an.
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 machen. Looker kann eine einfache SELECT DISTINCT-Abfrage oder die vollständige Logik des Explores verwenden, einschließlich Joins sowie sql_always_where- und access_filter-Parametern.
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 Schätzungen der Anzahl der eindeutigen Werte für Messwerte von type: count oder type: count_distinct, sodass der Messwert für zusammengefasste Bekanntheit verwendet werden kann.
approximate	M	Führt eine ungefähre Zählung für einen Messwert von type: count_distinct aus. 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 Looker-Summen 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 Nutzer, deren Nutzerattributwerte 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 Einheiten, für die ein Messwert für type: sum_distinct oder type: average_distinct berechnet wird.
Parameter für Werte und Formatierung
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 von type: percent_of_total oder type: running_total berechnet wird, wenn Pivots verwendet werden.
end_location_field	D	Definiert das Feld, das den Endstandort 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	Deklariert die Dimension, anhand derer ein Messwert vom Typ type: list berechnet wird
percentile	M	Gibt den Bruchwert (das N. Perzentil) für ein Maß von 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 eines Zeitraums für eine Dimensionsgruppe vom Typ „Zeitraum“ oder eine Dimension vom Typ „Zeitraum“.
sql_latitude	D	Definiert den Breitengrad einer Dimension von type: location
sql_longitude	D	Definiert den Längengrad einer Dimension von type: location
sql_start	D DG	Definiert die Startzeit eines Zeitraums für eine Dimensionsgruppe vom Typ „Zeitraum“ oder eine Dimension vom Typ „Zeitraum“.
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 verwendet werden können, damit Large Language Models und App-Entwickler andere Möglichkeiten verstehen, wie Nutzer sich auf ein Feld beziehen können.
tiers	D	Definiert die Stufen für eine Dimension von 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 Analyse)	M	Gibt den Typ des Messwerts an
string_datatype	D	Gibt den Unicode-Datentyp für ein Feld von 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 Dimensionsfüllung zulässig sein soll.
map_layer_name	D	Gibt die Art der Zuordnung zwischen einem Datenwert und einem geografischen Bereich an, die in einer vor- bzw. benutzerdefinierten Zuordnung festgelegt wurde
Unzulässige Parameter
decimals	D M	Entfernt 5.4 Ersetzt durch value_format
format	D M	Entfernt 3.16 Ersetzt durch value_format