Diese Seite bietet einen Überblick über LookML-Parameter, die sich auf Filtervorschläge auswirken. Auf dieser Seite sind alle Parameter mit einem Link zur vollständigen Referenzseite und einer kurzen Beschreibung der Funktion aufgeführt.
Standardverhalten
Wenn ein Nutzer in einem Look oder Explore einen Filterwert für ein Feld eingibt, das Vorschläge unterstützt, werden in Looker standardmäßig Optionen vorgeschlagen, die mit der Eingabe des Nutzers übereinstimmen. Wenn in einem Dashboard der Dashboard-Filter auf ein Feld angewendet wird, das Vorschläge unterstützt, schlägt Looker auch Filteroptionen vor. Diese Filtervorschläge werden mit einer SELECT DISTINCT-Abfrage für das Feld erstellt. Daher werden nur Werte zurückgegeben, die mit vorhandenen Daten für das Feld übereinstimmen:
Wenn unerwartetes Verhalten auftritt und Sie Filtervorschläge beheben müssen, finden Sie auf der Seite mit Best Practices Fehlerbehebung bei häufigen Problemen mit Filtervorschlägen weitere Informationen.
Feldtypen, für die Vorschläge unterstützt werden
In Looker werden Vorschläge für die folgenden type
-Werte für die Felder dimension
, dimension_group
, filter
und parameter
unterstützt.
Dimensionswerte für type
, die Vorschläge unterstützen:
type
-Wert für Dimensionsgruppe, der Vorschläge unterstützt:
type: time
mit den folgendentimeframes
-Werten:
Filtern Sie den type
-Wert, der Vorschläge unterstützt:
type: string
Parameterwerte für type
, die Vorschläge unterstützen:
type: string
type: unquoted
Filtervorschläge aktivieren oder deaktivieren
In diesem Abschnitt werden die folgenden LookML-Parameter beschrieben, mit denen Sie Filtervorschläge aktivieren oder deaktivieren können:
suggestions
(Ansicht)
Wenn ein Nutzer ein Feld, das Vorschläge unterstützt, für den Filter eines Explores verwendet, werden in Looker standardmäßig mögliche Werte für das Feld vorgeschlagen.
Sie können eine Ansicht mit suggestions:no
definieren, um Vorschläge für alle Felder in der Ansicht zu deaktivieren.
suggestable
(Feld)
Wenn ein Nutzer ein Feld, das Vorschläge unterstützt, für den Filter eines Explores verwendet, werden in Looker standardmäßig mögliche Werte für das Feld vorgeschlagen.
Sie können ein einzelnes Feld mit suggestable:no
definieren, um Vorschläge für das Feld zu deaktivieren.
Werte für Filtervorschläge
In diesem Abschnitt werden die folgenden LookML-Parameter beschrieben, mit denen Sie die in Filtervorschlägen angezeigten Werte festlegen oder einschränken können:
allowed_value
(Feld)bypass_suggest_restrictions
(Feld)case
(Feld)full_suggestions
(Feld)suggest_dimension
(Feld) undsuggest_explore
(Feld)suggestions
(Feld)
allowed_value
(Feld)
allowed_value
funktioniert mit dem LookML-Parameter parameter
. Wenn ein Looker-Entwickler ein parameter
-Nur-Filter-Feld bereitstellt, können die von Nutzern eingegebenen oder ausgewählten Werte mit einer {% parameter %}-Liquid-Variable referenziert werden. Optional können Sie mit allowed_value
eine Liste von Werten definieren, die ein Nutzer für dieses Parameterfeld auswählen kann.
allowed_value
hat zwei Unterparameter: label
und value
. Der Unterparameter label
gibt die Optionen an, die dem Nutzer in den Filtervorschlägen angezeigt werden. Der Unterparameter value
enthält die Werte, die an die Liquid-Variable {% parameter %}
übergeben werden.
Ein Parameter kann beispielsweise so definiert werden:
parameter: order_amount {
type: string
allowed_value: {
label: "Less than $50"
value:"< 50"
}
allowed_value: {
label: "Between $50 and $100"
value:"<= 100"
}
allowed_value: {
label: "Over $100"
value:"> 100"
}
}
Wenn ein Nutzer dann nach dem Parameter filtert, kann er eine der Optionen Weniger als 50 €, Zwischen 50 € und 100 € und Über 100 € auswählen.
Weitere Informationen finden Sie in diesem Abschnitt der Referenzseite für parameter
.
bypass_suggest_restrictions
(Feld)
Mit bypass_suggest_restrictions
werden Filtervorschläge für Situationen aktiviert, in denen sie deaktiviert oder eingeschränkt wären. Wenn Sie sql_always_where
oder access_filter
verwendet haben, um die für Nutzer sichtbaren Zeilen einzuschränken, werden die Filtervorschläge in Looker ebenfalls auf die Werte in den zulässigen Zeilen beschränkt. Wenn Sie jedoch sicher sind, dass in einem bestimmten Feld keine Werte vorhanden sind, die vertrauliche Informationen offenlegen könnten, können Sie mit bypass_suggest_restrictions
die vollständigen Filtervorschläge wiederherstellen.
case
(Feld)
Mit case
können Sie die Ergebnisse einer Dimension mit Case-Logik gruppieren. Das wirkt sich auf Filtervorschläge aus, da nur die in der case
-Anweisung definierten Werte als Filtervorschläge für diese Dimension angezeigt werden.
Eine Dimension, in der case
verwendet wird, kann mit verknüpften Filtern verwendet werden, wenn die Dimension in dem Filter verwendet wird, mit dem der andere Filter aktualisiert wird. Eine Dimension, für die case
verwendet wird, kann nicht im aktualisierten Filter verwendet werden.
full_suggestions
(Feld)
Sie können ein Feld mit dem Parameter full_suggestions
definieren, um festzulegen, wie Looker Ihre Datenbank abfragt, um Vorschläge für die Werte des Felds für einen Filter zu erhalten:
full_suggestions: no
: Looker verwendet eine einfache Abfrage mit unterschiedlichen Werten und fragt nur die Ansicht ab, die das Filterfeld enthält.full_suggestions: yes
: Looker fügt der Abfrage für Filtervorschläge die Logik des Explores hinzu. Das bedeutet, dass Looker alle Joins des Explores einschließt, die für die Abfrage des Felds des Filters erforderlich sind. Außerdem wird die Logik aus den Parametern des Explores eingeschlossen, z. B.sql_always_where
,access_filter
undconditionally_filter
.
Auf der Seite full_suggestions
finden Sie Informationen zum Standardverhalten von Looker beim Bereitstellen von Vorschlägen und zu Hinweisen für Explores mit sql_always_where
oder access_filter
.
suggest_dimension
(Feld) und suggest_explore
(Feld)
Looker generiert Filtervorschläge in der Regel, indem eine SELECT DISTINCT-Abfrage für das Filterfeld ausgeführt wird. Bei einigen großen Tabellen kann diese Abfrage zu langsam sein oder zu viel Datenbanklast verursachen. Mit suggest_dimension
können Sie Looker auffordern, eine alternative Dimension für Filtervorschläge abzufragen. Verwenden Sie dazu in Kombination mit suggest_explore
, wenn sich diese Dimension in einem anderen Explore befindet.
suggestions
(Feld)
Mit suggestions
können Sie eine Liste möglicher Werte für Filtervorschläge hartcodieren. Das kann hilfreich sein, wenn Sie nicht möchten, dass bestimmte Datenwerte in einem Feld als Vorschläge angezeigt werden, sondern stattdessen eine eingeschränktere Liste angeben möchten.
Filtervorschläge zwischenspeichern
In diesem Abschnitt wird der Parameter suggest_persist_for
beschrieben, mit dem Sie die Dauer konfigurieren können, für die Filtervorschläge im Cache gespeichert werden.
Wenn Sie die Auslastung Ihrer Datenbank reduzieren möchten und die Anzahl der Datenwerte für ein Feld sehr hoch ist, können Sie mit einem Parameter Filtervorschläge für das Feld deaktivieren. Wenn Sie Filtervorschläge anzeigen lassen möchten, können Sie einen Parameter verwenden, um die abgefragten Filterwerte einzuschränken oder die entsprechenden Optionen hartzucodieren.
suggest_persist_for
(Feld)
Standardmäßig werden Filtervorschläge sechs Stunden lang im Cache gespeichert. In diesem Zeitraum wird immer dieselbe Liste von Vorschlägen angezeigt. Mit dem Parameter suggest_persist_for
können Sie ändern, wie lange Filtervorschläge im Cache gespeichert werden.