DB·테이블·컬럼 이름을 지을 때 따르는 표기 규칙(소문자·언더스코어·날짜 형식)과 서비스명 약어 사전
목적
통일된 명명 규칙 없이 테이블이나 컬럼 이름을 정하면, 작성자나 팀에 따라 이름 형식이 혼용되는 사례가 발생한다.
- 동일한 데이터를 지칭하는 이름인데도 형식이 다른 경우:
mican_login_session_ga_hstvs.miricanvas_loginsession_google_analytics_history sales_data_2023_01vs.sales_2023_01_data
명명 규칙을 통일하면 검색 효율성(이름 규칙이 명확하면 원하는 데이터를 빠르게 찾을 수 있다)과 유지보수 용이성(테이블 이름만 보고도 데이터의 성격과 역할을 파악할 수 있다)이 높아진다.
수행 방법
DB 및 테이블 이름을 작성할 때 아래 규칙을 따른다.
- 소문자 사용 — 모든 이름은 소문자로 작성한다. 예:
user_data,sales_report_2023 - 단어 구분은 언더스코어 사용 — 여러 단어로 구성된 이름은 언더스코어(
_)로 구분한다. 예:purchase_history,customer_feedback - 일관된 시간 표현 — 날짜나 시간은
YYYYMMDD형식으로 작성한다. 예:sales_20230101,log_20231231 - 명확하고 간결한 이름 — 이름만으로 데이터의 목적과 내용을 이해할 수 있도록 작성한다. 서비스 이름이나 기타 사전은 아래 표를 참고한다.
서비스명 약어 사전
| category | full name | short name | description |
|---|---|---|---|
| 서비스 명 | miricanvas | mican | 미리캔버스 |
| 서비스 명 | bizhows | biz | 비즈하우스 |
| 서비스 명 | designhub | dehub | 디자인허브 |
| 서비스 명 | smilecat | scat | 스마일캣 |
| 그 외 | google analytics | ga | 구글 애널리틱스 |
새로 추가하고 싶은 용어가 있으면 원문 위키를 갱신해 공유한다.