候補（ビュー用）

このページでは、ビューの一部である suggestions パラメータについて説明します。

suggestions は、ディメンションまたはフィルタ フィールドの一部として使用することもできます。詳しくは、suggestions（フィールド用）パラメータ ドキュメントをご覧ください。

使用状況

表示: view_name {
オプション: はい
}
階層
view
suggestions
デフォルト値
yes

許可
ブール値（yes または no）

定義

Explore でユーザーが type: string ディメンションでクエリをフィルタすると、Looker はユーザーの入力に応じてフィルタ値のテキスト ボックスに候補を表示します。Looker はデータベースからディメンションの有効な値を提供し、ユーザーがテキスト ボックスに入力した内容に基づいて有効な値を提案します。候補は type: string のディメンションでのみサポートされ、ほとんどの言語に対してデフォルトで有効になっています。suggestions: no 文を view 定義に追加すると、ビュー内のすべての type: string ディメンションでフィルタ値の候補を無効にできます。

Amazon Athena、Qubole Presto、Trino、Cloudera Impala、Apache Hive、Apache Spark など、一部の言語では、候補を表示するにはデータベースのクエリが必要ですが、高額になる可能性があります。そのため、Looker でこれらの言語に対してデータベースからプロジェクトを自動的に生成すると、Looker は suggestions: no 宣言を使用してビューを作成します。

例

type: string のすべてのディメンションで候補が無効になっている例を次に示します。

view: aircraft_types {
  sql_table_name: flightstats.aircraft_types ;;
  suggestions: no
...
}

-

知っておくべきこと

ビューレベルでの suggestions の動作は、ディメンション レベルでは suggestions とは異なります

このページで説明する suggestions パラメータはビューに適用され、ディメンションに適用される suggestions パラメータとは異なります。suggestions をディメンション レベルで適用すると、そのディメンションの提案のリストをハードコードできます。

個々の type: string ディメンションの提案を無効にする場合は、ディメンションに suggestable: no ステートメントを使用します。

個々のディメンションに対する提案を無効にできます

個々の type: string ディメンションの提案を無効にする場合は、ビュー全体で suggestions: no を使用する代わりに、suggestable: no ステートメントをディメンションの定義に追加します。その逆は機能しません。suggestions: no でビューを定義し、suggestable: yes ステートメントを使用して、そのビューの個々の type: string ディメンションの提案を有効にすることはできません。この動作は、ビューレベルで suggestions: no を指定している場合に、データベースが高コストになるのを防止したいので、このようなビューに設定されています。ビュー内のすべてのディメンションについて、候補の表示をオフにする必要があるためです。

別の方法として、suggestions: no のビューでは、type: string ディメンションごとに suggestions パラメータを使用すると、ディメンションのビューに suggestions: no ステートメントがある場合でも、フィルタに使用可能な値をハードコードできます。ハードコードされた値はデータベースに対するクエリを必要としないためです。