suggestions（ビュー用）

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

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

用途

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 ステートメントがある場合でも、フィルタの候補値をハードコードできます。ハードコードされた値にはデータベースのクエリは必要ないためです。