[자료사전] 연결·반복·선택·주석 정리
자료사전(Data Dictionary)
자료사전(Data Dictionary)은 소프트웨어 설계 과정에서 핵심적인 역할을 수행하는 도구로, 시스템에서 사용되는 모든 데이터 요소들을 정의하고 정리한 저장소입니다. 시스템 분석과 설계 단계에서 등장하는 데이터 흐름도(DFD)나 ERD와 같은 다이어그램과 함께 사용되며, 이들에 나오는 모든 데이터에 대한 정의를 명확하게 기록합니다. 자료사전은 개발자, 설계자, 유지보수 담당자 간의 커뮤니케이션을 돕고, 시스템의 일관성과 완성도를 높이기 위한 필수적인 도구입니다.
특히 대규모 시스템 개발이나 팀 단위 프로젝트에서는 각자가 사용하는 데이터 구조나 용어가 다르면 개발 효율이 급격히 떨어질 수 있습니다. 이를 방지하기 위해 자료사전은 일종의 "데이터 사전(Dictionary)" 역할을 하며, 모든 데이터 요소의 명확한 정의, 형식, 단위, 유효 값 범위 등을 제공합니다.
1. 자료사전이란?
자료사전(Data Dictionary)은 시스템에서 사용되는 데이터 항목(Data Element), 데이터 구조(Data Structure), 데이터 흐름(Data Flow), 데이터 저장소(Data Store) 등에 대한 정보를 표준화된 형식으로 정리한 문서 또는 데이터베이스입니다.
자료사전의 목적은 다음과 같습니다:
- 데이터에 대한 명확한 정의 제공
- 분석자, 설계자, 개발자 간의 커뮤니케이션 통일
- 시스템 문서화 및 유지보수 용이성 확보
- 데이터 흐름도(DFD)와의 연결성 강화
- 데이터 사용에 대한 규칙 및 제약 조건 명시
2. 자료사전 구성 요소
| 구성 요소 | 설명 |
| 데이터 항목(Data Element) | 시스템에서 사용되는 가장 작은 단위의 데이터. 예: 이름(Name), 생년월일(Birthdate) |
| 데이터 구조(Data Structure) | 하나 이상의 데이터 항목으로 이루어진 논리적인 구조. 예: 회원정보 = 이름 + 생년월일 + 주소 |
| 데이터 흐름(Data Flow) | 데이터가 시스템 내부 또는 외부로 흐르는 경로와 내용을 설명 |
| 데이터 저장소(Data Store) | 시스템 내에 저장되는 데이터의 위치 또는 저장소, 예: 사용자 DB |
| 단위(Unit) | 데이터의 물리적/논리적 단위 예: 원(₩), 초(s), 개수 |
| 도메인(Domain) | 해당 데이터가 가질 수 있는 값의 범위 예: 성별 = {남, 여} |
| 설명(Description) | 해당 데이터의 의미와 사용처에 대한 상세한 설명 |
3. 자료사전 작성 방법
자료사전은 보통 표 형태나 구조화된 문서로 작성됩니다.
- 데이터 식별 : 시스템에서 사용되는 모든 데이터 항목을 식별합니다.
- 정의 작성 : 각 데이터 항목에 대해 명확한 정의를 작성합니다.
- 도메인 설정 : 해당 데이터의 유효 범위, 타입, 단위 등을 설정합니다.
- 구조 정의 : 데이터 항목들을 조합하여 데이터 구조를 만듭니다.
- 흐름과 저장소 연결 : 데이터 흐름도(DFD)나 ERD에서 사용된 데이터와 연결시킵니다.
- 문서화 : 최종적으로 문서 또는 툴을 통해 기록하고 관리합니다.
4. 자료사전에서 사용하는 주요 기호와 의미
| 기호 | 의미 | 설명 |
| + | 자료의 연결 | 두 개 이상의 자료 항목을 하나의 구조로 연결할 때 사용합니다 (예: 이름 + 생년월일) |
| {} | 자료의 반복 | 해당 데이터 항목이 여러 번 반복될 수 있음을 의미합니다. (예: {주문항목}) |
| [] | 자료의 선택 | 여러 항목 중 하나를 선택할 수 있음을 의미합니다. (예: [남자 | 여자]) |
| = | 정의 | 어떤 구조가 무엇으로 구성되는지를 정의할 때 사용 합니다. (예: 회원정보 = 이름 + 생년월일 + 주소) |
| () | 그룹화 | 데이터 항목들을 하나의 그룹으로 묶기 위해 사용 합니다. |
| /* */, @ 등 | 주석 (비공식) | 일부 문서에서는 주석을 표현할 때 @ 또는 C 스타일의 주석을 사용하지만, 공식적인 자료사전 기호는 아닙니다. |
5. 실무에서의 활용
자료사전은 다음과 같은 상황에서 실질적으로 유용합니다.
- 요구사항 명세 단계 : 사용자의 요구사항을 정확히 이해하고 문서화할 때
- 시스템 설계 단계 : DFD, ERD 등과 함께 데이터 흐름을 명확하게 정의할 때
- 코드 구현 단계 : 변수명, 테이블 스키마 설계 등에 있어 일관성을 유지할 때
- QA 및 테스트 단계 : 예상 값, 경계 값 테스트 기준을 만들 때
- 시스템 유지보수 : 시간이 지나도 시스템의 데이터 구조를 쉽게 파악할 수 있도록 할 때
6. 마무리
자료사전은 시스템 개발에서 데이터의 명확성, 일관성, 유지보수성을 높이기 위한 필수 도구입니다. 데이터 항목, 구조, 흐름, 저장소 등에 대한 정의를 체계적으로 정리하여 설계자의 의도를 문서화하고, 개발팀 전체의 소통을 원활하게 만들어줍니다. 작은 프로젝트라 하더라도 자료사전을 작성하는 습관은 장기적으로 큰 도움이 됩니다.