사용
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을 사용하여 재사용 가능한 맞춤 형식 정의
named_value_format과 함께 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 언어는 결과를 2로만 반환합니다. 두 정수를 나눌 때 결과도 정수로 제공되기 때문입니다. 이 문제를 해결하려면 분자에 10진수 (예: 1.0 또는 100.0)를 곱하여 SQL이 십진수 결과를 반환하도록 할 수 있습니다. 예를 들면 다음과 같습니다.
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으로 적용된 형식 위에 적용됩니다. 예시를 확인하고 자세히 알아보려면 숫자 형식 현지화 문서 페이지를 참고하세요.