候補（フィールドの場合）

このページでは、suggestions パラメータについて説明します。これは、ディメンション、フィルタ フィールド、または パラメータ の一部です。

ビューの一部としてsuggestionsを使用することもできます。これは、suggestions（ビューの場合）パラメータ ドキュメント ページで説明されています。

用途

view: view_name {
  dimension: field_name {
    suggestions: ["suggestion string", "suggestion string", "…"]
  }
}

階層 ビューファイル view フィールド タイプ suggestions

使用可能なフィールドタイプ ディメンション、フィルタ、パラメータ 許可 文字列または文字列のリスト

定義

ユーザーが Explore をフィルタすると、候補をサポートするフィールド タイプで、デフォルトで Looker はフィールドの候補値を提案します（フィルタ候補に影響を与える方法については、フィルタ候補を変更するをご覧ください）。フィルタ フィールドの候補を提供するために、Looker はデータベースに対してクエリを実行して、フィールドの一意の値のリストを取得します。通常、Looker はフィルタ フィールドに対して次のようなクエリを実行して、これらの候補を生成します。

SELECT DISTINCT field_name FROM table
WHERE (field_name LIKE '%' OR field_name LIKE '% %')
GROUP BY 1 ORDER BY 1 LIMIT 1000

suggestions パラメータを使用すると、ユーザーがそのフィールドを使用してクエリをフィルタするときに表示される ディメンション、フィルタ フィールド、またはパラメータの候補値のリストをハードコードできます。

**注:** Looker はこのクエリの結果を最大 1,000 件までキャッシュに保存しますが、フィルタ候補としてユーザーに表示されるのは最初の 100 件のみです。

フィールドが大きなテーブルにある場合、このクエリは遅すぎるか、データベースの負荷が大きすぎる可能性があります。suggestions を使用すると、候補値のリストをハードコードしてパフォーマンスを改善できます。

suggestions パラメータは、フィールドの特定の値が候補として表示されないように、より限定的なリストを指定できるため便利です。

注意: label 値は、case パラメータからユーザーに提示される候補よりも suggestions パラメータが優先されます。

例

colors ディメンションのデフォルトの候補をハードコードされたリストに置き換えます。

dimension: colors {
  type: string
  sql: ${TABLE}.colors ;;
  suggestions: ["red", "yellow", "blue"]
}