계산된 필드와 파라미터 네이밍 가이드
데이터 원본에 있는 기본 필드와 달리, 직접 생성하는 계산식과 파라미터는 명확한 규칙을 가지고 이름을 지어두면 수많은 필드 속에서 원하는 항목을 찾는 시간을 획기적으로 줄일 수 있습니다. 실무에서 가장 널리 쓰이는 명명 규칙과 효율적인 팁들을 정리했습니다.
1. 화면에 노출되는 필드: 보여질 이름 그대로 명명하기
도구 설명(Tooltip), 축 이름, 표의 머리글 등 대시보드 화면에 사용자에게 직접적으로 노출되는 계산된 필드는 최종적으로 보여질 이름 자체를 사용하는 것이 가장 좋습니다.
개발자 편의를 위해 'Calc_Sales_01'처럼 복잡하게 이름을 짓게 되면, 뷰에 올렸을 때 별칭이나 머리글 텍스트를 변경하는 추가 작업을 거쳐야 합니다. 처음부터 'Sales' 혹은 'Total Revenue'와 같이 직관적인 최종 명칭으로 생성하면 이러한 불필요한 반복 작업을 최소화할 수 있습니다.
황예환
2. 파라미터(매개 변수): 영문 사용 및 접두사(Prefix) 활용
대시보드에 동적인 상호작용을 더해주는 파라미터는 가급적 영문으로 작성하는 것을 강력히 권장합니다.
파라미터는 서버에 게시된 후 URL 동작(URL Actions)을 통해 값을 전달받거나, 웹 페이지에 대시보드를 임베딩(Embedding)할 때 자바스크립트 API 등 개발 언어와 상호작용하는 경우가 많습니다. 이때 파라미터 이름이 한글이나 특수문자로 되어 있으면 인코딩 오류가 발생하거나 코드가 정상적으로 작동하지 않을 수 있습니다.
- 접두사(Prefix) 사용: 파라미터는 계산된 필드와 섞여 있을 때 구분하기 어렵기 때문에
p.또는Param_과 같은 접두사를 붙이는 것이 업계 표준입니다. - 표기법: 띄어쓰기 대신 개발 친화적인 CamelCase나 snake_case를 사용하는 것이 안전합니다.
- 권장 예시:
p.SelectMeasure,Param_StartDate - 비권장 예시:
측정값 선택 파라미터,p. Select Measure
- 권장 예시:
3. 필터 및 특정 용도의 필드: 기호로 묶어서 정렬하기
대부분의 BI 툴은 필드를 알파벳 또는 가나다순으로 자동 정렬합니다. 단순히 화면에 보여주기 위한 용도가 아니라 특정 로직을 거쳐 '필터'로 사용하거나 '임시'로 만든 필드들은 이름 앞에 특정한 기호를 붙여 한곳에 모여 있도록 만들면 관리가 매우 편리합니다.
- 필터용 필드:
f.또는_기호를 붙여 상단이나 하단에 모아둡니다. (예:f. Top 10 Customers,_Date Filter) - 임시/테스트용 필드: 작업 중이거나 검증이 필요한 필드는
z_를 붙여 목록의 맨 아래로 보내는 방식을 많이 사용합니다. (예:z_Test_Sales_Calc)
4. 집계 방식(Aggregation)과 데이터 타입 명시
계산식 내부에 이미 특정 집계 함수(SUM, AVG 등)가 포함되어 있는지, 혹은 비율이나 논리값(Boolean)을 반환하는지 이름만 보고도 알 수 있도록 규칙을 정하는 것이 좋습니다. 이를 통해 뷰에 올렸을 때 비율을 다시 합산해버리는 등의 치명적인 오류를 방지할 수 있습니다.
- 집계 방식 명시:
Avg. Profit Margin,Total Sales - 비율 및 차이: 전년 대비(YoY), 전월 대비(MoM) 등은 접미사로 통일합니다. (예:
Sales YoY,Traffic MoM) - 논리값(Boolean): 참/거짓을 반환하는 계산식은
is_또는has_로 시작하여 직관성을 높입니다. (예:is_Profitable,has_Discount)
5. 세부 수준 식(LOD) 등 복잡한 계산식 표기
Fixed, Include, Exclude와 같은 세부 수준 식이나 복잡한 테이블 계산이 들어간 필드는 일반 필드와 명확히 구분해 주는 것이 협업 시 큰 도움이 됩니다.
- 예시:
LOD_Customer First Purchase Date,TC_Moving Avg Sales
명확한 네이밍 규칙은 혼자 작업할 때는 속도를 높여주고, 여러 명이 협업할 때는 원활한 커뮤니케이션을 돕는 훌륭한 도구가 됩니다. 소개된 가이드를 참고하여 현재 환경에 맞는 깔끔한 데이터 명명 규칙을 구축해 보시기 바랍니다.