本頁面提供 LookML 參數總覽,這些參數會影響篩選器建議。這個頁面會列出每個參數,並提供完整參照頁面的連結,以及參數功能的簡短說明。
預設行為
根據預設,在 Look 或探索中,如果使用者為支援建議的欄位輸入篩選器值,Looker 會建議與使用者輸入內容相符的選項。在資訊主頁中,如果資訊主頁篩選器是依據支援建議的欄位進行篩選,Looker 也會建議篩選器選項。這些篩選器建議是根據欄位上的 SELECT DISTINCT 查詢建立,因此建議只會傳回與該欄位現有資料相符的值:
如果遇到任何非預期的行為,需要排解篩選器建議問題,請參閱「排解常見的篩選器建議問題」最佳做法頁面。
支援建議的欄位類型
Looker 支援下列 dimension
、dimension_group
、filter
和 parameter
欄位的 type
值建議。
支援建議的維度 type
值:
支援建議的維度群組 type
值:
type: time
,並具有下列timeframes
值:
支援建議的篩選器 type
值:
type: string
支援建議的 type
參數值:
type: string
type: unquoted
啟用或停用篩選器建議
本節說明下列 LookML 參數,可讓您啟用或停用篩選器建議:
suggestions
(檢視)
根據預設,使用者在支援建議的欄位上篩選探索時,Looker 會建議該欄位的可能值。
您可以定義 suggestions:no
,停用檢視畫面中所有欄位的建議。
suggestable
(欄位)
根據預設,使用者在支援建議的欄位上篩選探索時,Looker 會建議該欄位的可能值。
您可以使用 suggestable:no
定義個別欄位,停用該欄位的建議。
篩選建議值
本節說明下列 LookML 參數,這些參數可讓您設定或限制篩選器建議中顯示的值:
allowed_value
(欄位)bypass_suggest_restrictions
(欄位)case
(欄位)full_suggestions
(欄位)suggest_dimension
(欄位) 和suggest_explore
(欄位)suggestions
(欄位)
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"
}
}
這樣一來,使用者篩選參數時,就能選擇「低於 $50 美元」、「$50 美元到 $100 美元之間」和「高於 $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 會納入查詢篩選器欄位時所需的任何「探索」聯結,並納入「探索」參數的邏輯,例如sql_always_where
、access_filter
和conditionally_filter
。
如要瞭解 Looker 提供建議的預設行為,以及使用 sql_always_where
或 access_filter
探索時的注意事項,請參閱full_suggestions
頁面。
suggest_dimension
(欄位) 和 suggest_explore
(欄位)
Looker 通常會對篩選器欄位執行 SELECT DISTINCT 查詢,藉此產生篩選器建議。對於某些大型資料表,這項查詢可能過慢,或造成過大的資料庫負載。如果維度位於不同的探索中,您可以搭配使用 suggest_dimension
和 suggest_explore
,讓 Looker 查詢篩選條件建議的替代維度。
suggestions
(欄位)
suggestions
可讓您將可能的篩選建議值清單硬式編碼。如果您不希望系統在欄位中建議特定資料值,而是想指定更有限的清單,這項功能就非常實用。
快取篩選建議
本節說明 suggest_persist_for
參數,您可以使用這個參數設定篩選器建議的快取時間長度。
如要減輕資料庫的負擔,且欄位資料值數量非常多,建議使用參數停用欄位的篩選建議。如要顯示篩選建議,請考慮使用參數限制查詢的篩選值,或硬式編碼適當的選項。
suggest_persist_for
(欄位)
根據預設,篩選建議會快取六小時,因此在該時間長度內,建議清單會維持不變。suggest_persist_for
參數可讓你變更篩選條件建議的快取時間長度。