국적 코드를 효율적으로 관리하는 방법 — DB 설계부터 실전 예시까지

국적 코드를 효율적으로 관리하는 방법 — DB 설계부터 실전 예시까지

안녕하세요! 오늘은 국적(Nationality) 정보를 효율적으로 관리하는 데이터베이스(DB) 설계 방법에 대해 정리해보려 합니다.
특히 외국인 근로자 정보를 다루거나, 다국어 지원이 필요한 서비스를 개발할 때 유용한 방법이니 꼭 참고해보세요.

1. 왜 국적을 코드로 관리해야 할까요?

• 표현의 다양성 해결: Korea, South Korea, Republic of Korea 등 중복 문제 방지
• 다국어 지원이 쉬움: 영어, 한국어, 본국어 등 다양한 언어로 매핑 가능
• 데이터 정합성: 오타, 중복 입력 방지
• 성능 향상: 코드 기반 검색이 더 빠르고 가벼움

2. 추천 테이블 구조

CREATE TABLE `tb_nationality_code` (
  `CODE` varchar(3) NOT NULL,           -- ISO 3166-1 alpha-3 코드
  `NAME_EN` varchar(100) DEFAULT NULL,  -- 영어 국명
  `NAME_KO` varchar(100) DEFAULT NULL,  -- 한국어 국명
  `NAME_NATIVE` varchar(100) DEFAULT NULL, -- 해당 국가의 자국어 명칭
  `FLAG_URL` varchar(255) DEFAULT NULL,    -- 국기 이미지 URL (선택)
  PRIMARY KEY (`CODE`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8;

이 테이블을 통해 하나의 코드로 다양한 언어를 쉽게 매핑할 수 있습니다. 예를 들어 일본(JPN)은 영어로 "Japan", 한국어로는 "일본", 일본어로는 "日本"으로 관리할 수 있죠.

3. 실전 예시: 주요 외국인 근로자 및 대표 국가 등록

아래는 실제 DB에 등록할 수 있는 INSERT 문 예시입니다. 대한민국에서 근무하는 외국인 근로자들이 많은 국가와 주요 교류국들을 포함했습니다.

INSERT INTO tb_nationality_code (CODE, NAME_EN, NAME_KO, NAME_NATIVE, FLAG_URL) VALUES
('KOR', 'South Korea', '대한민국', '대한민국', 'https://flagcdn.com/w320/kr.png'),
('USA', 'United States', '미국', 'United States', 'https://flagcdn.com/w320/us.png'),
('JPN', 'Japan', '일본', '日本', 'https://flagcdn.com/w320/jp.png'),
('CHN', 'China', '중국', '中国', 'https://flagcdn.com/w320/cn.png'),
('VNM', 'Vietnam', '베트남', 'Việt Nam', 'https://flagcdn.com/w320/vn.png'),
('PHL', 'Philippines', '필리핀', 'Pilipinas', 'https://flagcdn.com/w320/ph.png'),
('THA', 'Thailand', '태국', 'ประเทศไทย', 'https://flagcdn.com/w320/th.png'),
('IDN', 'Indonesia', '인도네시아', 'Indonesia', 'https://flagcdn.com/w320/id.png'),
('MMR', 'Myanmar', '미얀마', 'မြန်မာ', 'https://flagcdn.com/w320/mm.png'),
('NPL', 'Nepal', '네팔', 'नेपाल', 'https://flagcdn.com/w320/np.png'),
('UZB', 'Uzbekistan', '우즈베키스탄', 'O‘zbekiston', 'https://flagcdn.com/w320/uz.png'),
('KHM', 'Cambodia', '캄보디아', 'កម្ពុជា', 'https://flagcdn.com/w320/kh.png'),
('MNG', 'Mongolia', '몽골', 'Монгол улс', 'https://flagcdn.com/w320/mn.png'),
('BGD', 'Bangladesh', '방글라데시', 'বাংলাদেশ', 'https://flagcdn.com/w320/bd.png'),
('LKA', 'Sri Lanka', '스리랑카', 'ශ්‍රී ලංකාව', 'https://flagcdn.com/w320/lk.png'),
('PAK', 'Pakistan', '파키스탄', 'پاکستان', 'https://flagcdn.com/w320/pk.png'),
('FRA', 'France', '프랑스', 'France', 'https://flagcdn.com/w320/fr.png'),
('DEU', 'Germany', '독일', 'Deutschland', 'https://flagcdn.com/w320/de.png'),
('GBR', 'United Kingdom', '영국', 'United Kingdom', 'https://flagcdn.com/w320/gb.png'),
('RUS', 'Russia', '러시아', 'Россия', 'https://flagcdn.com/w320/ru.png'),
('AUS', 'Australia', '호주', 'Australia', 'https://flagcdn.com/w320/au.png'),
('CAN', 'Canada', '캐나다', 'Canada', 'https://flagcdn.com/w320/ca.png'),
('BRA', 'Brazil', '브라질', 'Brasil', 'https://flagcdn.com/w320/br.png'),
('IND', 'India', '인도', 'भारत', 'https://flagcdn.com/w320/in.png'),
('ESP', 'Spain', '스페인', 'España', 'https://flagcdn.com/w320/es.png'),
('ITA', 'Italy', '이탈리아', 'Italia', 'https://flagcdn.com/w320/it.png');

4. 활용 팁

• 국기 아이콘을 함께 보여주는 UI로 사용자 경험 개선
• 국적 선택 드롭다운에서 자국어 포함된 국가명 제공 가능
• 필요시 CSV로 다운로드해 백오피스에 적용하거나 공유 가능

5. CSV 다운로드 버튼 예시 (HTML)

프론트엔드에서 아래와 같이 간단한 CSV 다운로드 기능을 넣을 수 있습니다:

국가코드 CSV 다운로드
function downloadCSV() {
  const csvData = `CODE,NAME_EN,NAME_KO,NAME_NATIVE,FLAG_URL\nKOR,South Korea,대한민국,대한민국,https://flagcdn.com/w320/kr.png\n...`;
  const blob = new Blob([csvData], { type: 'text/csv;charset=utf-8;' });
  const link = document.createElement('a');
  link.href = URL.createObjectURL(blob);
  link.download = 'nationality_codes.csv';
  document.body.appendChild(link);
  link.click();
  document.body.removeChild(link);
}

마무리

국적을 텍스트로 직접 입력받는 시대는 지났습니다. 국적 코드를 중심으로 한 데이터베이스 설계는 시스템의 일관성과 확장성을 높이는 핵심 전략입니다.
특히 외국인 대상 서비스를 기획하거나, 글로벌 데이터를 다룰 때 이 구조는 반드시 도움이 될 거예요.

도움이 되셨다면 댓글이나 공감 부탁드립니다! 궁금한 점 있으면 언제든 질문 주세요 😊