suggestions（ビュー用）

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

suggestions は、suggestions（フィールド用）パラメータのドキュメント ページで説明されているように、ディメンションまたはフィルタ フィールドの一部としても使用できます。

用途

view: view_name {
  suggestions: yes
}
階層
view
suggestions
デフォルト値
yes

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

定義

ユーザーが候補をサポートするフィールドで Explore をフィルタすると、デフォルトでは、Looker はそのフィールドの候補値を提案します（フィルタ候補に影響を与える方法については、フィルタ候補を変更するをご覧ください）。

Looker は、データベースからディメンションの可能な値を取得し、ユーザーがフィルタ フィールドに入力した内容に基づいて可能な値を提案します。ほとんどの言語では、候補はデフォルトでオンになっています。suggestions: no ステートメントを view 定義に追加すると、候補をサポートするビュー内のすべてのディメンションのフィルタ値候補が無効になります。

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

例

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

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

知っておくべきこと

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

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

個々のディメンションの候補を無効にするには、ディメンションに suggestable: no ステートメントを使用します。

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

個々のディメンションの候補を無効にする場合は、ビュー全体に suggestions: no を使用する代わりに、ディメンションの定義に suggestable: no ステートメントを追加します。ただし、逆は機能しません。suggestions: no でビューを定義してから、suggestable: yes ステートメントを使用してビュー内の個々のディメンションの候補を有効にすることはできません。この動作がこのように設定されているのは、デベロッパーがビューレベルで suggestions: no を指定している場合、そのビューのデータベースに対するコストの高いクエリを回避したいと考えているためです。そのため、ビュー内のすべてのディメンションで候補をオフにする必要があります。

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