使用 LookML 設定資料值的格式

本頁概略說明 LookML 參數,可用於修改資料表和視覺化圖表中顯示的資料值外觀和行為。舉例來說,您可以指定貨幣格式,讓資料值 (例如 1234) 在資料表和視覺化圖表中顯示為 $1,234.00。您也可以為欄位指定可點選的行為,讓使用者點選欄位觸發動作或追蹤連結

修改資料值的格式

本節說明可變更資料值在使用者畫面上顯示方式的 LookML 參數。

參數 說明 範例
value_format 使用 value_format 以 Excel 格式設定 type: number 欄位的輸出格式。

請注意,value_format 不會對非 type: number 的欄位產生影響。
measure: total_order_amount {
  type: sum
  sql: ${order_amount} ;;
  value_format: "$#,##0.00"
 }
value_format_name 使用 value_format 搭配內建或自訂的 named_value_format,設定 type: number 欄位的輸出格式。

請注意,value_formatvalue_format_name 不會對非 type: number 的欄位產生影響。
measure: total_order_amount {
  type: sum
  sql: ${order_amount} ;;
  value_format_name: usd
}
style 使用 style 參數變更 type: tier 欄位的格式。

請注意,style 是唯一會影響 type: tier 欄位格式的 LookML 參數。
dimension: age_tier {
  type: tier
  tiers: [0, 10, 20, 30, 40, 50, 60, 70, 80]
  style: classic
  sql: ${age} ;;
}
  
html 使用 html 參數,將 HTML 格式套用至欄位。

例如,您可以變更字型、字型大小、字型粗細或字型顏色。本表中的範例說明如何根據欄位值在欄位中加入表情符號。
dimension: status {
  sql: ${TABLE}.status ;;
  html: {% if value == 'Shipped' or value == 'Complete' %}
      <p>✅ {{value}}</p>
    {% elsif value == 'Processing' %}
      <p>⏳ {{value}}</p>
    {% else %}
      <p>❌ {{value}}</p>
    {% endif %}
   ;;
}
sql 使用 sql 參數,透過 SQL 變更資料值。

使用資料庫允許的任何 SQL 轉換。本表中的範例說明如何根據欄位值在欄位中加入表情符號。
dimension: status {
  sql: CASE WHEN (${TABLE}.status = 'Shipped' OR ${TABLE}.status = 'Complete') ;;
     THEN CONCAT('✅ ', ${TABLE}.status)
   WHEN ${TABLE}.status = 'Processing'
     THEN CONCAT('⏳ ', ${TABLE}.status)
   ELSE
     CONCAT('❌ ', ${TABLE}.status)
   END ;;
}

修改資料值的可點選動作

本節說明 LookML 參數,可用於決定在資料表或圖表中點選資料值時,欄位的行為。

參數 說明 範例
drill_fields 使用 drill_fields 指定使用者深入資料時要顯示哪些欄位。請注意,維度和資料表有不同的鑽研行為

如要瞭解建構自訂鑽研路徑的進階選項,請參閱「更強大的資料鑽研功能」。
dimension: country {
  sql: ${TABLE}.country ;;
  drill_fields: [state, city]
}
action 使用 action 在欄位上建立資料動作,讓使用者直接在 Looker 中執行其他工具中的作業。

如果欄位已定義一或多個動作,資料表中的欄位旁邊就會顯示省略號 (...)。點選欄位或橢圓形圖示會顯示選單,使用者可從中選取動作或深入瞭解資料。
dimension: action_example {
  action: {
    label: "Send a Thing"
    url:
      "https://example.com/ping/{{value}}"
    form_url:
      "https://example.com/ping/{{value}}/form.json"
  }
}
link 使用 link 在欄位上建立連結。

如果欄位已定義一或多個連結,資料表中的欄位旁邊就會顯示省略號 (...)。點選欄位或省略號會顯示選單,使用者可以選取連結或深入探討資料。
dimension: artist_name {
  link: {
    label: "Google"
    url: "http://www.google.com/search?q={{value}}"
    icon_url: "http://google.com/favicon.ico"
   }
}
html 使用 html 為欄位編寫自訂 HTML 格式。您可以使用 HTML 標記 (例如 <a> 標記),在欄位中指定一或多個超連結。

如果欄位定義了一或多個動作或連結,資料表中的欄位旁邊就會顯示省略號 (...),不論 html 定義為何。點選欄位或省略號會顯示選單,使用者可從中選取任何可用的連結或動作。
dimension: artist_name {
  html: <p>{{value}}
    <a href="#drillmenu">Drill menu</a>,
    <a href="http://www.google.com/search?q={{value}}">
      Google search
    </a></p>;;
    sql: ${TABLE}.artist_name ;;
    type: string
}