본문으로 건너뛰기
리뷰 완료

데이터 네이밍 가이드라인

플랫폼엔지니어링 / data-platform담당자이지훈마지막 발행26.10.22
AI 요약

DB·테이블·컬럼 이름을 지을 때 따르는 표기 규칙(소문자·언더스코어·날짜 형식)과 서비스명 약어 사전

목적

통일된 명명 규칙 없이 테이블이나 컬럼 이름을 정하면, 작성자나 팀에 따라 이름 형식이 혼용되는 사례가 발생한다.

  • 동일한 데이터를 지칭하는 이름인데도 형식이 다른 경우: mican_login_session_ga_hst vs. miricanvas_loginsession_google_analytics_history
  • sales_data_2023_01 vs. sales_2023_01_data

명명 규칙을 통일하면 검색 효율성(이름 규칙이 명확하면 원하는 데이터를 빠르게 찾을 수 있다)과 유지보수 용이성(테이블 이름만 보고도 데이터의 성격과 역할을 파악할 수 있다)이 높아진다.

수행 방법

DB 및 테이블 이름을 작성할 때 아래 규칙을 따른다.

  1. 소문자 사용 — 모든 이름은 소문자로 작성한다. 예: user_data, sales_report_2023
  2. 단어 구분은 언더스코어 사용 — 여러 단어로 구성된 이름은 언더스코어(_)로 구분한다. 예: purchase_history, customer_feedback
  3. 일관된 시간 표현 — 날짜나 시간은 YYYYMMDD 형식으로 작성한다. 예: sales_20230101, log_20231231
  4. 명확하고 간결한 이름 — 이름만으로 데이터의 목적과 내용을 이해할 수 있도록 작성한다. 서비스 이름이나 기타 사전은 아래 표를 참고한다.

서비스명 약어 사전

category full name short name description
서비스 명 miricanvas mican 미리캔버스
서비스 명 bizhows biz 비즈하우스
서비스 명 designhub dehub 디자인허브
서비스 명 smilecat scat 스마일캣
그 외 google analytics ga 구글 애널리틱스

새로 추가하고 싶은 용어가 있으면 원문 위키를 갱신해 공유한다.

코멘트

아직 코멘트가 없어요