공통표준용어 적용하는 법 — 행안부 공통표준단어 3,282개를 단어사전으로

2026년 9월 22일 · 갱신 2026년 9월 22일

공공 SI 프로젝트의 설계 단계에서는 거의 항상 같은 대화가 오갑니다. “공통표준용어 반영하셨죠?” 그리고 누군가 공공데이터포털에서 받은 CSV를 엑셀로 열어, 컬럼명을 지을 때마다 Ctrl+F로 찾아봅니다. 3천 행이 넘는 시트를 사람이 대조하는 구조라, 산출물 검토 때 PROD_NM이 GDS_NM이어야 했다는 지적이 나오는 것도 흔한 일입니다.

이 글은 그 CSV가 무엇이고, 어떻게 써야 컬럼명을 짓는 순간에 적용되는지에 대한 글입니다. 표준단어사전 일반론은 표준단어사전 만드는 법에서 다뤘고, 여기서는 공공 부문의 사정 하나를 깊게 봅니다.

공공기관에는 선택이 아니라 의무입니다

근거는 행정안전부 고시 「공공기관의 데이터베이스 표준화 지침」입니다(최근 개정 2025-02-24). 제11조가 두 가지를 정합니다.

• 공공기관의 장은 구축·운영 중인 모든 공공 데이터베이스에 공통표준용어를 일관되게 적용해야 합니다.
• 기관표준용어를 정의할 때 공통표준용어를 우선 적용해야 합니다.

즉 기관 사전을 백지에서 만들 수 없습니다. 공통표준에 있는 단어는 공통표준의 표기를 따르고, 공통표준에 없는 기관 고유의 단어만 기관이 정합니다. 앞 글에서 “수천 행짜리 기성 사전을 통째로 들여오지 말고 실사용 어휘에서 시작하라”고 권했는데, 공공기관은 이 점에서 예외입니다. 들여오는 게 규정이고, 들여온 사전 위에 기관 단어를 얹는 순서가 맞습니다.

공통표준용어는 공통표준단어와 공통표준도메인의 조합으로 구성됩니다(지침 제12조). “민원 접수 일시”라는 용어는 민원·접수·일시 세 단어와 일시 도메인으로 만들어진다는 뜻입니다. 그래서 적용의 출발점은 용어 1만 3천 건이 아니라 그 재료인 단어입니다.

공통표준단어 파일에 들어 있는 것

행정안전부가 공공데이터포털에 공통표준단어·공통표준용어·공통표준도메인을 파일데이터로 올려 두었습니다. 이용허락 제한이 없고, 해마다 개정판이 올라옵니다. 이 글은 2025-11-01판 기준입니다.

단어 파일에서 실제로 일을 하는 칸은 몇 개뿐입니다.

• 영문약어명이 물리명에 들어가는 표기입니다. 민원 → CVLCPT, 일련번호 → SN.
• 이음동의어는 같은 뜻의 다른 표기입니다. 일련번호의 이음동의어가 순번, 연번이라, “순번”이라고 써도 SN이 되어야 합니다.
• 금칙어는 쓰지 말아야 할 표기입니다. 19개뿐이지만 현장에서 자주 보이는 것들입니다 — 유저(→ 사용자), 컨텐츠(→ 콘텐츠), 메세지(→ 메시지), 디폴트(→ 기본).
• 개정구분이 폐기인 행은 더 이상 쓰지 않는 단어입니다. 2025-11판에는 2개(법정리, 실효)가 있습니다. 빼고 써야 합니다.

민간 관행 약어와 갈리는 곳

공통표준 약어는 영어 단어를 줄인 것이 아니라 한국어 단어의 뜻을 옮긴 영문을 줄인 것이 많습니다. 그래서 민간 프로젝트에서 익숙한 약어와 자주 다릅니다.

마지막 두 줄이 특히 위험합니다. 민간에서 DT는 흔히 날짜인데, 공통표준에서 DT는 일시(날짜+시간)이고 날짜는 YMD입니다. 머릿속 관행대로 쓰면 틀렸다는 느낌조차 들지 않습니다. 사람이 시트를 보고 대조하는 방식으로는 이런 차이가 검토 단계까지 살아남습니다.

파일을 단어사전으로 쓰기

대조를 사람이 하지 않으려면, 공통표준단어가 컬럼명을 만드는 쪽에 있어야 합니다. Sqemo에서는 공공데이터포털에서 받은 파일을 손대지 않고 그대로 가져오면 됩니다.

1. 공통표준단어 페이지에서 CSV를 내려받습니다(공통표준단어_점검.csv, 로그인 없이 받을 수 있습니다).
2. Sqemo 편집기에서 가져오기 → 단어사전 가져오기로 그 파일을 고릅니다. 한글 헤더를 알아보고 영문약어명을 물리 단어로, 이음동의어를 동의어로 옮깁니다. 폐기된 단어는 건너뜁니다.
3. 결과: 단어 3,282개가 사전에 들어옵니다.

이제 논리명을 한글로 적으면 물리명이 공통표준 약어로 계산됩니다. 아래는 민원 엔터티를 논리명만 적어서 만든 결과입니다.

사람이 약어를 하나도 타이핑하지 않았습니다. 민원이 CVLCPT인지, 담당자가 PIC인지 외울 필요가 없습니다. 띄어쓰기 없이 “민원접수일시”라고 적어도 사전의 가장 긴 단어부터 맞춰 CVLCPT_RCPT_DT로 나눕니다.

마지막 행이 유저_ID로 남은 것은 의도한 결과입니다. 유저는 공통표준 금칙어라 사전에 없고, 사전에 없는 단어는 모델 검증 패널이 그 자리에서 짚습니다. 금칙어 목록 자체를 따로 대조하지는 않지만, 금칙어는 공통표준단어에 없으므로 미등록 단어로 똑같이 걸립니다. “사용자 아이디”로 고치면 USER_ID가 됩니다.

이미 만든 모델에 적용할 때

새 모델이 아니라 이미 컬럼명이 지어진 모델이라면, 사전을 가져올 때 병합을 고릅니다. 같은 논리 단어는 공통표준 값으로 갱신되고, 기관 고유 단어는 그대로 남습니다.

병합만으로 기존 물리명이 바뀌지는 않습니다. 대신 사전 기준과 달라진 물리명이 모델 검증 패널에 모입니다. 쇼핑몰 샘플 모델에 공통표준단어를 병합하면 27건이 나옵니다.

목록을 검토한 뒤 일괄 반영을 누르면 한 번에 공통표준 표기로 바뀝니다. 목록에 GDS_CATEGORY처럼 공통표준 약어와 기관 단어가 섞인 결과가 보이는데, 카테고리가 공통표준단어에 없기 때문입니다. 이런 단어는 기관표준단어로 정식 등록할지, 공통표준에 있는 다른 단어(분류 → CLSF)로 바꿀지 결정하면 됩니다. 이 결정이 지침이 말하는 “기관표준용어 정의”입니다.

운영 중인 DB라면 물리명 변경은 곧 스키마 변경입니다. 일괄 반영은 모델을 고치는 것이지 DB를 고치는 것이 아니므로, 실제 반영은 이행 계획과 함께 따로 진행하셔야 합니다.

아직 되지 않는 것

정확히 적어 둡니다.

• 형식단어 규칙(번호·일자·여부 같은 형식단어가 용어 끝에 와야 한다는 규칙)은 검사하지 않습니다. 형식단어 여부 칸은 가져오지 않습니다.
• 공통표준용어(1만 3천 건)와 도메인은 가져오지 않습니다. 단어 조합으로 물리명을 만들 뿐, “이 용어는 공통표준용어에 있고 도메인은 무엇”까지 대조하지는 않습니다.
• 감리 제출 서식(표준단어정의서 등 별지 서식)으로의 내보내기는 없습니다. 단어사전은 CSV·JSON으로, 정의서는 CSV·Markdown으로 내보냅니다.
• 공통표준은 해마다 개정됩니다. 개정판이 나오면 새 파일을 다시 병합해야 합니다.

정리

공통표준용어 적용이 어려운 것은 단어가 많아서가 아니라, 대조를 사람이 하기 때문입니다. 3천 행 시트를 옆에 두고 컬럼명을 짓는 한, 민간 관행과 다른 약어는 검토 단계에서야 발견됩니다. 공통표준단어가 이름을 만드는 사전에 들어가 있으면, 대조는 이름을 짓는 순간에 끝납니다.

단어사전 가져오기·물리명 생성·모델 검증은 무료이고 가입 없이 쓸 수 있습니다. 편집기를 열고 공공데이터포털에서 받은 파일을 그대로 가져와 보시면, 기존 모델이 공통표준에서 얼마나 떨어져 있는지 몇 분 안에 확인하실 수 있습니다. 팀이 하나의 사전을 공유하고 단어 추가를 제안·승인으로 관리하는 방법은 명명 표준 문서에 있습니다.

출처: 공공기관의 데이터베이스 표준화 지침(행정안전부 고시) · 공통표준단어 · 공통표준용어 · 공통표준도메인