full_suggestions

用途

view: view_name {
  dimension: field_name {
    full_suggestions: yes 
  }
}
階層
view
フィールド タイプ
full_suggestions
使用可能なフィールドタイプ
ディメンション、ディメンショングループ、フィルタ、パラメータ

許可
ブール値（「はい」または「いいえ」）

定義

ユーザーが候補をサポートするフィールド タイプでデータ探索をフィルタすると、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

full_suggestions パラメータは、Looker がデータベースにクエリを実行して、Explore のフィルタでフィールドの値の候補を表示する方法を制御します。

  • full_suggestions: no: Looker は一般的なフィルタ候補クエリを使用し、フィルタ フィールドを含むビューのみをクエリします。

  • full_suggestions: yes: Looker はフィルタ候補クエリに Explore ロジックを追加します。つまり、Looker にはフィルタのフィールドをクエリするために必要な Explore の結合のいずれかが含まれ、Looker には次のパラメータを含む Explore のパラメータのロジックが含まれます。

デフォルトの動作

フィールドに full_suggestions パラメータが指定されていない場合、Looker は次の動作で候補値をクエリします。

  • sql_always_where、access_filter、always_join を使用する Explore の場合、Looker はデフォルトで full_suggestions: yes の動作になります。access_filter、sql_always_where、always_join パラメータは Explore クエリに制約を適用するため、これらの制約はフィルタ候補クエリにも適用されます。Looker がクエリ制約のある Explore の候補を提示する方法については、sql_always_where または access_filter を使用した Explore の考慮事項をご覧ください。
  • それ以外の場合、Looker はデフォルトで full_suggestions: no の動作になり、フィルタ フィールドのビューのみをクエリし、Explore のロジックは含まれません。full_suggestions: no 設定を使用すると、Looker は結合なしで単一のテーブルをクエリし、Explore で定義されたロジックを使用しないため、フィルタ候補のパフォーマンスが向上します。

例

ディメンションのフィルタ候補を表示するときに、Looker が Explore のロジックを使用してデータベースをクエリするようにするには、ディメンションの定義に full_suggestions: yes を追加します。

dimension: project_name {
  type: string
  sql: ${TABLE}.project_name ;;
  full_suggestions: yes
}

sql_always_where または access_filter を使用する Explore に関する考慮事項

sql_always_where パラメータと access_filter パラメータは、データアクセスを制御するためによく使用されます。Explore で sql_always_where または access_filter が使用されている場合、Looker は 候補をサポートするフィールド タイプに対して行うフィルタ候補にこれらの制限を適用します。ユーザーに適用されないフィルタ候補が表示されないようにするため、Looker では、Explore のフィルタ値候補に Explore ロジック（full_suggestions:yes）を適用する必要があります。したがって、Explore が sql_always_where または access_filter で定義されている場合、Looker は full_suggestions:no で定義されたフィールドのフィルタの候補を表示しません。

sql_always_where または access_filter を含む Explore があり、sql_always_where または access_filter のロジックを必要としないフィールドがある場合は、フィールドの定義に bypass_suggest_restrictions:yes を追加して動作をオーバーライドできます。bypass_suggest_restrictions:yes ステートメントは、フィルタ値の候補の完全なリストを提供するよう Looker に指示します。