allow_fill

用量

view: view_name {
  dimension: field_name {
    allow_fill: yes 
  }
}
階層
allow_fill
可能的欄位類型
維度、維度群組

預設值
yes

接受
布林值 (是或否)

定義

部分資料集的值 (例如日期) 會遵循可預測的模式。使用者可能會依時間範圍提取資料,並發現某些日期、週、月或其他日期類型沒有對應的值。根據預設,資料表和視覺化圖表會顯示查詢傳回的日期,並略過任何缺少的日期。

在這些情況下,使用者可以透過 Looker 的維度填入選項,在資料表和查詢的視覺化圖表軸中填入缺少的日期和值。這個選項位於「探索」的「資料」部分,在維度的齒輪選單中。

維度的 allow_fill 參數可用來啟用或停用選項,以填入資料表和視覺化圖表軸中的遺漏值。根據預設,如果維度類型支援填入遺漏值,維度的齒輪選單中就會顯示這個選項。如要停用填寫維度遺漏值的選項,請將 allow_fill 設為 no

allow_fill 選項適用於值數量固定的維度群組和維度,例如「是/否」和分層值,以及 day_of_weekhour_of_day 等日期類型。

您也可以使用 casetier 參數,將「allow_fill」選項套用至任何以值清單為基礎的維度選項。如果查詢只使用單一維度和/或單一資料透視,且使用者未對任何指標套用篩選器,系統就會自動填入遺漏值。

您可以在查詢中一次對多個維度套用維度填補功能,包括已透視的維度。不過,如果 Looker 偵測到系統會產生過多填補值,可能會自動停用維度填補功能,以提升查詢效能。

範例

禁止使用者填寫「建立日期」維度的遺漏值:

dimension: created_date {
  type: date
  sql: ${TABLE}.created_date ;;
  allow_fill: no
}

注意事項

在下列情況下,使用者也無法填寫維度:

  • 維度使用 order_by_field 參數時。

  • 維度套用篩選器,且值數量固定,例如「是/否」、「星期幾」、「幾號」等。針對這些欄位類型進行篩選,可排除 Looker 準確填入遺漏值時所需的固定值數量。

  • 使用者深入查看透視維度時。

  • 當 Looker 偵測到系統會產生過多填入值的資料列或資料欄時,就會自動停用維度填入功能,以提升查詢效能。