變更篩選器建議

本頁面提供 LookML 參數總覽,這些參數會影響篩選器建議。這個頁面會列出每個參數,並提供完整參照頁面的連結,以及參數功能的簡短說明。

預設行為

根據預設,在 Look 或探索中,如果使用者為支援建議的欄位輸入篩選器值,Looker 會建議與使用者輸入內容相符的選項。在資訊主頁中,如果資訊主頁篩選器是依據支援建議的欄位進行篩選,Looker 也會建議篩選器選項。這些篩選器建議是根據欄位上的 SELECT DISTINCT 查詢建立,因此建議只會傳回與該欄位現有資料相符的值:

使用者選取篩選器值欄位時,下拉式選單會顯示篩選器建議。

如果遇到任何非預期的行為,需要排解篩選器建議問題,請參閱「排解常見的篩選器建議問題」最佳做法頁面。

支援建議的欄位類型

Looker 支援下列 dimensiondimension_groupfilterparameter 欄位的 type 值建議。

支援建議的維度 type 值:

支援建議的維度群組 type 值:

支援建議的篩選器 type 值:

  • type: string

支援建議的 type 參數值:

啟用或停用篩選器建議

本節說明下列 LookML 參數,可讓您啟用或停用篩選器建議:

suggestions (檢視)

根據預設,使用者在支援建議的欄位篩選探索時,Looker 會建議該欄位的可能值。

您可以定義 suggestions:no,停用檢視畫面中所有欄位的建議。

suggestable (欄位)

根據預設,使用者在支援建議的欄位篩選探索時,Looker 會建議該欄位的可能值。

您可以使用 suggestable:no 定義個別欄位,停用該欄位的建議。

篩選建議值

本節說明下列 LookML 參數,這些參數可讓您設定或限制篩選器建議中顯示的值:

allowed_value (欄位)

allowed_value 適用於 parameter LookML 參數。如果 Looker 開發人員提供parameter僅限篩選的欄位,使用者輸入或選取的值可使用 {% parameter %} Liquid 變數參照。您也可以使用 allowed_value,為該參數欄位定義使用者可選擇的值清單。

allowed_value 有兩個子參數,分別是 labelvaluelabel 子參數會指定使用者在篩選建議中看到的選項。value 子參數包含傳遞至 {% parameter %} Liquid 變數的值。

舉例來說,參數可以定義如下:

parameter: order_amount {
  type: string
  allowed_value: {
    label: "Less than $50"
    value:"< 50"
  }
  allowed_value: {
    label: "Between $50 and $100"
    value:"<= 100"
  }
  allowed_value: {
    label: "Over $100"
    value:"> 100"
  }
}

這樣一來,使用者篩選參數時,就能選擇「低於 $50 美元」、「$50 美元到 $100 美元之間」和「高於 $100 美元」等選項。

詳情請參閱 parameter 參考資料頁面的這個章節

bypass_suggest_restrictions (欄位)

bypass_suggest_restrictions 可在原本會停用或限制篩選建議的情況下啟用這項功能。如果您已使用 sql_always_whereaccess_filter 限制使用者可查看的資料列,Looker 也會將篩選器建議限制為允許的資料列中的值。不過,如果您確定特定欄位中沒有任何可能揭露私密資訊的值,可以使用 bypass_suggest_restrictions 恢復整組篩選建議。

case (欄位)

case 可讓您使用案例邏輯,將維度的結果分組。這會影響篩選器建議,因為系統只會將 case 陳述式中定義的值,顯示為該維度的篩選器建議。

如果維度用於更新其他篩選器的篩選器,則使用 case 的維度可以搭配連結的篩選器使用。使用 case 的維度無法用於要更新的篩選器。

full_suggestions (欄位)

您可以使用 full_suggestions 參數定義欄位,控管 Looker 查詢資料庫的方式,為篩選器的欄位值提供建議:

  • full_suggestions: no:Looker 會使用不重複值的基本查詢,且只會查詢包含篩選器欄位的資料檢視。
  • full_suggestions: yes:Looker 會將「探索」邏輯新增至篩選器建議查詢,也就是說,Looker 會納入查詢篩選器欄位時所需的任何「探索」聯結,並納入「探索」參數的邏輯,例如 sql_always_whereaccess_filterconditionally_filter

如要瞭解 Looker 提供建議的預設行為,以及使用 sql_always_whereaccess_filter 探索時的注意事項,請參閱full_suggestions頁面。

suggest_dimension (欄位) 和 suggest_explore (欄位)

Looker 通常會對篩選器欄位執行 SELECT DISTINCT 查詢,藉此產生篩選器建議。對於某些大型資料表,這項查詢可能過慢,或造成過大的資料庫負載。如果維度位於不同的探索中,您可以搭配使用 suggest_dimensionsuggest_explore,讓 Looker 查詢篩選條件建議的替代維度。

suggestions (欄位)

suggestions 可讓您將可能的篩選建議值清單硬式編碼。如果您不希望系統在欄位中建議特定資料值,而是想指定更有限的清單,這項功能就非常實用。

快取篩選建議

本節說明 suggest_persist_for 參數,您可以使用這個參數設定篩選器建議的快取時間長度。

如要減輕資料庫的負擔,且欄位資料值數量非常多,建議使用參數停用欄位的篩選建議。如要顯示篩選建議,請考慮使用參數限制查詢的篩選值,或硬式編碼適當的選項

suggest_persist_for (欄位)

根據預設,篩選建議會快取六小時,因此在該時間長度內,建議清單會維持不變。suggest_persist_for 參數可讓你變更篩選條件建議的快取時間長度。