建議 (適用於欄位)

本頁面是指 suggestions 參數,該參數是維度篩選器欄位參數的一部分。

您也可以將 suggestions 做為檢視區塊的一部分,詳情請參閱suggestions (適用於檢視區塊) 參數說明文件頁面。

用量

view: view_name {
  dimension: field_name {
    suggestions: ["suggestion string", "suggestion string", "…"]
  }
}
階層
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

suggestion 參數可讓您為維度篩選器欄位參數,硬式編碼建議值清單。使用者透過該欄位篩選查詢時,系統就會顯示這些建議值。

如果該欄位位於大型資料表中,這項查詢可能會過慢,或造成過大的資料庫負載。使用 suggestions 即可改為對可能的值清單進行硬式編碼,進而提升效能。

如果您不希望特定欄位值顯示為建議,suggestions 參數也很有用,因為您可以指定更有限的清單。

範例

colors 維度的預設建議替換為硬式編碼清單:

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