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 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