このページでは、フィルタの候補に影響する LookML パラメータの概要について説明します。本ページでは、パラメータと詳しい説明ページへのリンク、その機能の簡単な説明、パラメータが何を行うかのイメージを示します。
デフォルトの動作
デフォルトでは、ユーザーが Look または Explore で type: string ディメンションのフィルタ値を入力すると、Looker はユーザーが入力した内容と一致するオプションを提案します。ダッシュボードで、ダッシュボード フィルタが type: string のフィールドをフィルタリングしている場合、Looker はフィルタ オプションも提案します。これらのフィルタの候補は、ディメンションに対して SELECT DISTINCT クエリを使用して作成されるため、そのフィールドの既存のデータと一致する値のみが返されます。
予期しない動作が発生し、フィルタの候補のトラブルシューティングが必要な場合は、フィルタ候補の一般的な問題のトラブルシューティングをご覧ください。
フィルタの候補を有効または無効にする
このセクションでは、フィルタの候補を有効または無効にできる以下の LookML パラメータについて説明します。
suggestable（フィールド）
suggestable を no に設定すると、ディメンションまたはフィルタの候補を無効にできます。suggestable のデフォルト値は yes であるため、Looker は可能であればユーザーに候補を提示します。suggestable を no に設定すると、Looker は候補を提示しません。
suggestions（ビュー）
suggestions を no に設定すると、ビュー内のすべてのディメンションの候補が無効になります。suggestions のデフォルト値は yes であるため、Looker は可能であればユーザーに候補を提示します。suggestions を no に設定すると、Looker は候補を提示しません。
候補の値をフィルタする
このセクションでは、フィルタの候補に表示される値を設定または制限できる以下の LookML パラメータについて説明します。
allowed_value（フィールド）bypass_suggest_restrictions（フィールド）case（フィールド）full_suggestions（フィールド）suggest_dimension（フィールド）とsuggest_explore（フィールド）suggestions（フィールド）
allowed_value（フィールド）
allowed_value は parameter LookML パラメータと連携します。Looker デベロッパーが parameter フィルタ専用フィールドを提供する場合、ユーザーが入力または選択した値を {% parameter %} Liquid 変数を使って参照できます。必要に応じて、allowed_value を使用して、ユーザーがこのパラメータ フィールドに対して選択できる値のリストを定義できます。
allowed_value に label と value の 2 つのサブパラメータがあります。label サブパラメータは、フィルタ候補に表示するオプションを指定します。value サブパラメータには、{% parameter %} Liquid 変数に渡される値が含まれます。
たとえば、パラメータは次のように定義できます。
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"
}
}
ユーザーがパラメータをフィルタする際には、[ $50 未満]、[ $50～$100]、[ $100 超] から選択できます。
詳しくは、parameter リファレンス ページのこのセクションをご覧ください。
bypass_suggest_restrictions（フィールド）
bypass_suggest_restrictions: 無効であるか、制限されている場合に、フィルタ候補を有効にします。sql_always_where または access_filter を使用してユーザーが閲覧できる行を制限している場合、Looker はフィルタ候補を許可された行の値に制限します。ただし、特定のディメンションやフィルタ フィールドに機密情報を示す値がないことが確実な場合は、bypass_suggest_restrictions を使用してフィルタの候補をすべて復元できます。
case（フィールド）
case を使用すると、ケースロジックを使用してディメンションの結果をバケット化できます。case 文で定義された値のみがそのディメンションのフィルタ候補として表示されるため、これはフィルタ候補に影響します。
caseを使用してディメンションに対してユーザーに表示される候補は、full_suggestionsの使用時には制限されません。caseパラメータに含めるオプションは、すべてのオプションが表示されます。
他のフィルタを更新するフィルタでディメンションが使用されている場合、case を使用するディメンションはリンクされたフィルタで使用できます。case を使用するディメンションは、更新中のフィルタでは使用できません。
full_suggestions（フィールド）
full_suggestions を no に設定すると、ディメンションのフィルタ候補が無効になります。
caseを使用してディメンションに対してユーザーに表示される候補は、full_suggestionsの使用時には制限されません。caseパラメータに含めるオプションは、すべてのオプションが表示されます。
suggest_dimension（フィールド）と suggest_explore（フィールド）
Looker は通常、フィルタ フィールドで SELECT DISTINCT クエリを実行して、フィルタ候補を生成します。一部の大きなテーブルでは、このクエリが遅すぎるか、データベースの負荷が大きすぎる可能性があります。ディメンションが別の Explore に存在する場合は、suggest_dimension を使用して、suggest_explore と組み合わせて Looker のクエリをフィルタ候補の代替ディメンションにすることができます。
suggestions（フィールド）
suggestions を使用すると、フィルタ候補値のリストをハードコードできます。これは、フィールド内の特定のデータ値を候補として表示せず、より限定されたリストを指定する場合に便利です。
フィルター提案のキャッシング
このセクションでは、フィルタ パラメータがキャッシュに保存される期間を構成する suggest_persist_for パラメータについて説明します。
データベースへの負荷を軽減したい場合、ディメンションのデータ値の数が非常に多ければ、パラメータを使用してディメンションのフィルタ候補を無効化します。フィルタの候補を表示する場合は、パラメータを使用してクエリ対象のフィルタ値を制限するか、適切なオプションをハードコードします。
suggest_persist_for（フィールド）
デフォルトでは、フィルタの候補は 6 時間キャッシュされ、その時間に候補の同じリストが表示されます。suggest_persist_for パラメータを使用すると、フィルタ候補のキャッシュ保存期間を変更できます。