Diese Seite bietet einen Überblick über LookML-Parameter, die sich auf Filtervorschläge auswirken. Auf dieser Seite sind die einzelnen Parameter mit einem Link zur vollständigen Referenzseite, einer kurzen Beschreibung ihrer Funktion und einem Bild der Funktionsweise aufgeführt.
Standardverhalten
Wenn ein Nutzer in einem Look oder Explore einen Filterwert für eine Dimension von type: string
eingibt, schlägt Looker standardmäßig Optionen vor, die mit der Eingabe des Nutzers übereinstimmen. Wenn der Dashboardfilter auf einem Dashboard nach einem Feld von type: string
filtert, schlägt Looker auch Filteroptionen vor. Diese Filtervorschläge werden mit einer SELECT DISTINCT-Abfrage für die Dimension erstellt, sodass die Vorschläge nur Werte zurückgeben, die mit den vorhandenen Daten für dieses Feld übereinstimmen:
Falls unerwartetes Verhalten auftritt und Sie Fehler bei den Filtervorschlägen beheben müssen, lesen Sie die Best Practices unter Häufige Probleme mit Filtervorschlägen beheben.
Filtervorschläge aktivieren oder deaktivieren
In diesem Abschnitt werden die folgenden LookML-Parameter beschrieben, mit denen Sie Filtervorschläge aktivieren oder deaktivieren können:
suggestable
(Feld)
Wenn Sie suggestable
auf no
setzen, können Sie Vorschläge für eine Dimension oder einen Filter deaktivieren. Der Standardwert von suggestable
ist yes
. Daher macht Looker dem Nutzer nach Möglichkeit Vorschläge. Wenn Sie suggestable
stattdessen auf no
festlegen, macht Looker keine Vorschläge.
suggestions
(ansehen)
Wenn Sie suggestions
auf no
setzen, können Sie Vorschläge für alle Dimensionen in einer Ansicht deaktivieren. Der Standardwert von suggestions
ist yes
. Daher macht Looker dem Nutzer nach Möglichkeit Vorschläge. Wenn Sie suggestions
stattdessen auf no
festlegen, macht Looker keine Vorschläge.
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 Nur-parameter
-Filterfeld bereitstellt, können die von Nutzern eingegebenen oder ausgewählten Werte mithilfe 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 die beiden Unterparameter label
und value
. Mit dem Unterparameter label
werden die Optionen festgelegt, 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 aus den Optionen Weniger als 50 €, 50 € bis 100 € und Mehr als 100 € auswählen.
Weitere Informationen findest du in diesem Abschnitt der parameter
-Referenzseite.
bypass_suggest_restrictions
(Feld)
Mit bypass_suggest_restrictions
werden Filtervorschläge für Situationen aktiviert, in denen diese normalerweise deaktiviert oder eingeschränkt wären. Wenn Sie sql_always_where
oder access_filter
verwendet haben, um die Zeilen einzuschränken, die Nutzer sehen können, beschränkt Looker die Filtervorschläge ebenfalls auf die Werte in den zulässigen Zeilen. Wenn Sie jedoch sicher sind, dass es in einer bestimmten Dimension oder einem bestimmten Filterfeld keine möglichen Werte gibt, die vertrauliche Informationen preisgeben könnten, können Sie mit bypass_suggest_restrictions
alle Filtervorschläge wiederherstellen.
case
(Feld)
Mit case
können Sie die Ergebnisse einer Dimension nach Falllogik gruppieren. Dies wirkt sich auf Filtervorschläge aus, da nur die in der case
-Anweisung definierten Werte als Filtervorschläge für diese Dimension angezeigt werden.
Die Vorschläge, die Nutzern für eine Dimension mit
case
angezeigt werden, sind bei der Verwendung vonfull_suggestions
nicht eingeschränkt. Jede Option, die Sie in einemcase
-Parameter angeben, ist für alle Nutzer sichtbar.
Eine Dimension mit case
kann mit verknüpften Filtern verwendet werden, wenn die Dimension in dem Filter verwendet wird, mit dem der andere Filter aktualisiert wird. Eine Dimension mit case
kann im aktualisierten Filter nicht verwendet werden.
full_suggestions
(Feld)
Wenn full_suggestions
auf no
gesetzt ist, werden Filtervorschläge für eine Dimension deaktiviert.
Die Vorschläge, die Nutzern für eine Dimension mit
case
angezeigt werden, sind bei der Verwendung vonfull_suggestions
nicht eingeschränkt. Jede Option, die Sie in einemcase
-Parameter angeben, ist für alle Nutzer sichtbar.
suggest_dimension
(Feld) und suggest_explore
(Feld)
Looker generiert Filtervorschläge in der Regel durch die Ausführung einer SELECT DISTINCT-Abfrage für das Filterfeld. Bei einigen großen Tabellen kann diese Abfrage zu langsam sein oder eine zu hohe Datenbanklast verursachen. Sie können suggest_dimension
verwenden, um die Looker-Abfrage zu einer alternativen Dimension für Filtervorschläge zu machen, 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. Dies kann nützlich sein, wenn Sie nicht möchten, dass bestimmte Datenwerte in einem Feld als Vorschläge angezeigt werden, und wenn Sie stattdessen eine eingeschränkte Liste angeben möchten.
Filtervorschläge zwischenspeichern
In diesem Abschnitt wird der Parameter suggest_persist_for
beschrieben, mit dem Sie festlegen können, wie lange Filtervorschläge im Cache gespeichert werden.
Wenn Sie die Datenbanklast reduzieren möchten und die Anzahl der Datenwerte für eine Dimension sehr hoch ist, können Sie einen Parameter verwenden, um Filtervorschläge für die Dimension zu deaktivieren. Wenn Filtervorschläge angezeigt werden sollen, können Sie einen Parameter verwenden, um die abgefragten Filterwerte zu begrenzen oder die entsprechenden Optionen hart zu codieren.
suggest_persist_for
(Feld)
Standardmäßig werden Filtervorschläge sechs Stunden lang im Cache gespeichert, was zu derselben Liste für diesen Zeitraum führt. Mit dem Parameter suggest_persist_for
können Sie ändern, wie lange Filtervorschläge im Cache gespeichert werden.