變更篩選器建議

本頁面概要說明影響篩選器建議的 LookML 參數。本頁面列出各個參數，並提供其完整參考頁面的連結，以及簡短的功能說明。

預設行為

根據預設，在 Look 或 Explore 中，當使用者在支援建議的欄位中輸入篩選器值時，Looker 會建議與使用者輸入內容相符的選項。如果資訊主頁篩選器篩選的欄位支援建議，Looker 也會提供篩選器選項建議。這些篩選器建議是使用 SELECT DISTINCT 查詢建立，因此建議只會傳回與該欄位現有資料相符的值：

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

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

支援建議的欄位類型

Looker 支援 dimension、dimension_group、filter 和 parameter 欄位的以下 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 有兩個子參數：label 和 value。label 子參數會指定使用者在篩選器建議中看到的選項。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"
  }
}

接著，當使用者篩選參數時，可以選擇「Less than $50」、「Between $50 and $100」和「Over $100」。

詳情請參閱 parameter 參考資料頁面的這個部分。

bypass_suggest_restrictions (欄位)

bypass_suggest_restrictions 會在濾鏡建議遭停用或受限的情況下啟用濾鏡建議。如果您使用 sql_always_where 或 access_filter 限制使用者可查看的資料列，Looker 也會將篩選器建議限制為允許資料列中的值。不過，如果您確定特定欄位中沒有可能洩漏敏感資訊的值，可以使用 bypass_suggest_restrictions 恢復完整的篩選器建議。

case (欄位)

case 可讓您使用情況邏輯將維度的結果分組。這會影響篩選器建議，因為只有在 case 陳述式中定義的值會顯示為該維度的篩選器建議。

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

full_suggestions (欄位)

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

  • full_suggestions: no：Looker 會使用基本查詢來查詢不同的值，並只查詢包含篩選器欄位的檢視畫面。
  • full_suggestions: yes：Looker 會將探索邏輯加入篩選器建議查詢，也就是說，Looker 會加入任何探索的彙整，這些彙整是查詢篩選器欄位所需的，Looker 也會加入探索參數的邏輯，例如 sql_always_where、access_filter 和 conditionally_filter。

請參閱 full_suggestions 頁面，瞭解Looker 提供建議的預設行為，以及使用 sql_always_where 或 access_filter 的 Explore 時應考量的事項。

suggest_dimension (欄位) 和 suggest_explore (欄位)

Looker 通常會在篩選器欄位上執行 SELECT DISTINCT 查詢，產生篩選建議。對於某些大型資料表，這項查詢可能會過慢，或造成過大的資料庫負載。您可以使用 suggest_dimension 搭配 suggest_explore，讓 Looker 查詢篩選建議的替代維度 (如果該維度位於其他探索中)。

suggestions (欄位)

suggestions 可讓您將可能的篩選建議值列表硬式編碼。如果您不希望欄位中的特定資料值顯示為建議，而是想指定較受限的清單，這項功能就很實用。

快取篩選器建議

本節說明 suggest_persist_for 參數，可讓您設定篩選器建議的快取時間長度。

如果您想減少資料庫的負載，且欄位資料值的數量非常高，建議您使用參數停用欄位的篩選建議。如果您想顯示篩選器建議，建議您使用參數限制要查詢的篩選器值，或將適當選項硬式編碼。

suggest_persist_for (欄位)

根據預設，篩選器建議會快取六小時，因此在該時間範圍內，系統會顯示相同的建議清單。您可以使用 suggest_persist_for 參數變更篩選建議的快取時間長度。