사용
view: view_name {
dimension: field_name {
value_format:"$#.00;($#.00)"
}
}
|
계층 구조
value_format |
가능한 필드 유형
측정기준, 측정값
허용
Excel 스타일 형식이 포함된 문자열
|
정의
value_format 매개변수를 사용하면 Excel 스타일 형식을 사용하여 Looker에서 데이터 값의 형식을 지정할 수 있습니다. 다음과 같은 방법으로 value_format을 사용할 수 있습니다.
- 필드 수준에서 자체적으로 특정 측정기준 또는 측정값에 Excel 스타일 형식을 직접 적용합니다.
- 모델 수준에서
named_value_format매개변수의 하위 매개변수로 여러 필드에 적용할 수 있는 재사용 가능한 커스텀 형식을 만듭니다.
측정기준 및 측정값에 value_format 직접 적용
value_format 매개변수는 측정기준과 측정값 모두에서 사용할 수 있습니다. value_format을 통해 측정기준에 Excel 스타일 형식을 적용하려면 측정기준 유형이 number여야 합니다. value_format을 통해 측정값에 Excel 스타일 형식을 적용하려면 측정값이 숫자이고 type: string이 아닌지 확인합니다. 예를 들면 다음과 같습니다.
dimension: order_amount {
type: number
sql: ${TABLE}.order_amount ;;
value_format: "$#.00;($#.00)"
}
measure: total_order_amount {
type: sum
sql: ${order_amount} ;;
value_format: "$#.00;($#.00)"
}
value_format을 사용하여 재사용 가능한 커스텀 형식 정의
재사용 가능한 형식을 정의하기 위해 value_format을 named_value_format과 함께 사용하는 방법에 대한 자세한 내용은 named_value_format 매개변수의 문서 페이지를 참고하세요.
기본 형식 지정 옵션
Looker의 기본 제공 값 형식 중 하나를 적용하려면 기본 형식 이름 섹션에 나열된 형식 중에서 value_format_name 매개변수의 문서 페이지에 있는 선택하면 됩니다. 기본 제공 형식을 적용하기 위해 value_format_name을 사용하는 방법에 대한 안내는 해당 페이지를 참고하세요.
일반적인 형식 지정 문자열
value_format은 Excel 스타일 형식 지정 문자열을 허용합니다.
value_format매개변수와 함께 사용되는 형식은 시각화의 값 형식 필드에 사용되는 형식과 동일하지만,value_format매개변수를 사용하기 위해서는 형식 지정 문자열을 큰따옴표로 묶어야 합니다. 시각화의 값 형식에 대한 자세한 내용은 열 차트 옵션 문서 페이지를 참고하세요.
이러한 형식을 지정하는 방법은 Excel의 전체 가이드 문서에 설명되어 있습니다. 하지만 현재 Looker에서는 날짜 형식 지정, 색상 형식 지정, 16진수 변환이 지원되지 않습니다.
가장 일반적인 형식 지정 옵션은 다음과 같습니다. 국제 통화 기호와 같은 일부 특수문자는 큰따옴표로 묶어야 합니다.
value_format: "0" # Integer (123)
value_format: "*00#" # Integer zero-padded to 3 places (001)
value_format: "0 \" String\"" # Integer followed by a string (123 String)
# Note \"String\" can be replaced with any other word
value_format: "0.##" # Number up to 2 decimals (1. or 1.2 or 1.23)
value_format: "0.00" # Number with exactly 2 decimals (1.23)
value_format: "*00#.00" # Number zero-padded to 3 places and exactly 2 decimals (001.23)
value_format: "#,##0" # Number with comma between thousands (1,234)
value_format: "#,##0.00" # Number with comma between thousands and 2 decimals (1,234.00)
value_format: "0.000,,\" M\"" # Number in millions with 3 decimals (1.234 M)
# Note division by 1 million happens automatically
value_format: "0.000,\" K\"" # Number in thousands with 3 decimals (1.234 K)
# Note division by 1 thousand happens automatically
value_format: "$0" # Dollars with 0 decimals ($123)
value_format: "$0.00" # Dollars with 2 decimals ($123.00)
value_format: "\"€\"0" # Euros with 0 decimals (€123)
value_format: "$#,##0.00" # Dollars with comma btwn thousands and 2 decimals ($1,234.00)
value_format: "$#.00;($#.00)" # Dollars with 2 decimals, positive values displayed
# normally, negative values wrapped in parenthesis
value_format: "0\%" # Display as percent with 0 decimals (1 becomes 1%)
value_format: "0.00\%" # Display as percent with 2 decimals (1 becomes 1.00%)
value_format: "0%" # Convert to percent with 0 decimals (.01 becomes 1%)
value_format: "0.00%" # Convert to percent with 2 decimals (.01 becomes 1.00%)
value_format 매개변수를 사용한 고급 조건부 형식 지정의 예는 value_format을 사용한 조건부 형식 지정 권장사항 페이지를 참고하세요.
일반 과제
나누기 시 소수점 손실
value_format을 사용할 때 발생하는 일반적인 SQL 특이사항 중 하나는 SQL이 정수 수학을 처리하는 방식입니다. 5를 2로 나누면 대부분의 사용자는 결과가 2.5일 것으로 예상합니다. 하지만 많은 SQL 언어는 결과를 정수로 반환합니다. 두 정수를 나누면 결과도 정수로 반환하기 때문입니다. 이 문제를 해결하려면 분자에 10진수 (예: 1.0 또는 100.0)를 곱하여 SQL이 10진수 결과를 반환하도록 할 수 있습니다. 예를 들면 다음과 같습니다.
measure: active_users_percent {
type: number
sql: 100.000 * ${active_users} / ${users} ;;
value_format: "0.000"
}
number_format 사용자 속성과 함께 value_format 사용
모델에서 필드 형식을 지정하기 위해 value_format을 사용하는 경우 number_format 사용자 속성에서 선택한 숫자 형식이 value_format으로 적용된 형식 위에 적용됩니다. 예를 보고 자세히 알아보려면 숫자 형식 현지화 문서 페이지를 참고하세요.