데이터 정의서 작성방법, 서비스 기획자는 알아야 합니다

1. 데이터 정의서란 무엇인가?

데이터 정의서란, 쉽게 말해 특정 데이터에 대한 설명서입니다. 각 데이터의 속성, 용도, 데이터 유형, 길이 등 중요한 정보를 체계적으로 문서화하여, 데이터를 활용하는 모든 사람이 일관된 정보로 접근할 수 있게 도와줍니다. 데이터베이스 관리자는 물론, 다양한 부서의 사람들이 데이터를 이해하고 활용하는 데에 이 정의서가 큰 역할을 합니다. _{“그렇게 서비스 기획자가 되었다” 오픈채팅 바로가기}

2. 데이터 정의서 작성 시 필수 구성 요소

데이터 정의서를 작성할 때 빠질 수 없는 주요 구성 요소는 다음과 같습니다

1. 데이터 항목명

• 정의: 각 데이터를 식별할 수 있는 고유한 이름을 의미합니다. 데이터 항목명이 명확할수록 여러 팀원이 데이터를 쉽게 이해하고 활용할 수 있습니다.
• 작성 팁: 데이터 항목명을 작성할 때는 데이터의 역할을 직관적으로 드러내는 이름을 사용해야 합니다. 예를 들어, 고객 고유 번호를 “고객 ID”라고 정하면 여러 팀원이 쉽게 이해할 수 있지만, 줄임말이나 특정 부서에서만 사용하는 은어는 피해야 합니다.

2. 데이터 설명

• 정의: 데이터가 왜 필요한지, 어떤 목적으로 사용하는지 간단히 설명하는 항목입니다. 데이터 설명은 다른 팀원들이 데이터를 올바르게 활용하는 데 중요한 역할을 합니다.
• 작성 팁: 설명은 데이터의 목적과 맥락을 포함해야 합니다. 한두 문장으로 간결하게 작성하되, 충분히 구체적인 정보를 포함하는 것이 좋습니다. 데이터가 어떻게 사용될지 예측하고, 작성자의 의도나 데이터를 생성한 의도를 담으면 데이터 사용 중 혼동을 줄일 수 있습니다. 고객 ID 항목의 경우 “고객 식별을 위한 고유 번호로, 각 고객의 계정을 구분하는 데 사용됩니다”라고 작성하면 데이터를 처음 접하는 팀원도 데이터의 목적과 용도를 이해할 수 있었습니다. 특히 팀 내부의 새로운 팀원이 이를 보았을 때, 데이터 사용 맥락을 파악하는 데 큰 도움이 되었습니다.

3. 데이터 타입 및 길이

• 정의: 데이터가 숫자, 문자, 날짜 등 어떤 유형인지와 데이터 입력 시 허용되는 최대 길이를 명시합니다. 데이터 타입과 길이는 데이터베이스 구조 설계 시 꼭 필요한 정보입니다.
• 작성 팁: 데이터 타입과 길이를 정의할 때는 일관성이 중요합니다. 예를 들어, ‘문자형 데이터’라 하더라도 일부 필드는 50자, 다른 필드는 100자까지 허용하면 혼란이 생길 수 있습니다. 필요한 길이를 미리 검토하고 일관된 형식을 유지하는 것이 좋습니다.
• 고객의 연락처를 기록할 때, 전화번호 필드를 15자로 제한하였습니다. 숫자형으로 기록하면 “0”이 맨 앞에 올 수 없기 때문에 문자형으로 지정했고, 연락처가 국제번호를 포함할 수 있음을 반영하여 길이를 설정했습니다. 이러한 기준을 미리 명시해 두니, 데이터 입력 시 오류를 줄일 수 있었습니다.

4. 데이터 범위 및 값의 제한 조건

• 정의: 데이터 입력 시 허용되는 값의 범위를 지정하여 잘못된 데이터 입력을 방지합니다. 이는 데이터의 품질과 신뢰성을 높이는 중요한 요소입니다.
• 작성 팁: 데이터의 범위를 설정할 때는 업무적 요구 사항과 데이터 활용 목적을 모두 고려해야 합니다. 예를 들어, 나이 데이터의 경우 0~120까지 허용하고, 이에 해당하지 않는 값이 입력되면 오류로 처리하도록 설정했습니다.
• 고객의 나이 데이터는 부정확하게 입력될 위험이 크기 때문에, 특정 범위를 명시하여 설정했습니다. “나이는 0~120 사이의 값만 허용”하는 식으로 데이터 정의서에 기재했고, 실제로도 그 기준에 맞게 데이터를 관리했습니다. 이 기준을 정함으로써 데이터 품질 검증이 쉬워졌고, 오류를 미리 방지할 수 있었습니다.

5. 데이터 출처

• 정의: 데이터가 어디에서 생성되었는지, 누구에 의해 수집되었는지를 명시합니다. 출처 정보는 데이터의 신뢰성과 정확성을 평가하는 데 매우 중요합니다.
• 작성 팁: 데이터 출처는 구체적으로 명시해야 합니다. 데이터를 생성하는 시스템이나, 담당 부서 및 사용된 수집 방법을 기록하는 것이 좋습니다. 특히 데이터가 주기적으로 업데이트되는 경우에는 출처와 더불어 최신 수정일자도 함께 기재해 두면 유용합니다.
• 고객 정보에서 ‘고객 등록 시스템’을 출처로 기록한 예시가 있습니다. 데이터를 담당하는 부서와 수집 방법을 적어두니, 후에 데이터의 정확성을 확인할 필요가 있을 때 출처에 따라 바로 추적할 수 있었습니다. 또한, 데이터 검토가 필요한 경우 담당 부서와 협력할 때 도움이 됐습니다.

3. 데이터 정의서 템플릿 예시

실제로 데이터를 관리하다 보면, 직접 데이터 정의서를 작성해야 할 일이 많습니다. 아래는 일반적인 데이터 정의서 템플릿 예시로, 기본적인 항목과 함께 작성할 수 있는 형식을 제공합니다.

위 템플릿을 통해, 작성해야 할 항목이 무엇인지 더 명확하게 알 수 있습니다. 실제 데이터를 바탕으로 항목을 채워 나가면 데이터 정의서를 쉽게 완성할 수 있습니다. 아래 다운로드 버튼을 클릭하셔서 데이터 정의서 템플릿 예시를 받아서 활용하시기 바랍니다. (구글 드라이브로 연결해 놓았습니다)

4. 데이터 정의서 작성 시 유의할 점

4.1. 명확하고 일관된 용어 사용

데이터 정의서의 가장 중요한 목표 중 하나는 모든 팀원과 이해관계자가 동일한 데이터에 대해 동일하게 이해하도록 돕는 것입니다. 이를 위해서는 데이터 항목명과 설명이 명확하고 일관되게 작성되어야 합니다.

• 항목명 명명 규칙 설정: 예를 들어, 고객 정보를 나타내는 항목명으로 ‘고객ID’, ‘고객번호’ 등 다양한 표현이 사용될 수 있습니다. 이 경우, 모든 항목명에 일관성을 유지하기 위해 명명 규칙을 수립하고 모든 팀이 이를 따르도록 해야 합니다. 명명 규칙이 있으면 신규 데이터 정의서 작성 시에도 혼란이 줄어듭니다.
• 필수적인 정보 포함: 항목 설명에는 데이터의 역할, 목적, 그리고 사용 범위에 대한 정보를 명확히 포함시켜야 합니다. 예를 들어, 고객 ID 항목이라면 “고객 식별을 위해 시스템 내에서 사용되는 고유 번호”와 같이 용도를 구체적으로 설명합니다.
• 기술 용어와 일반 용어 구분: 기술 부서와 비기술 부서가 함께 데이터를 다루는 환경에서는 기술적인 용어가 일반 팀원들에게 어려울 수 있습니다. 따라서 기술 용어를 사용해야 하는 경우, 비기술자도 쉽게 이해할 수 있도록 용어를 정의서 첫머리 또는 별도 용어집에 추가해 설명하는 것이 좋습니다.

4.2. 정기적인 업데이트

데이터 정의서는 작성 시점에서만 필요한 문서가 아닙니다. 데이터 자체가 변하거나 시스템이 업데이트될 때마다 정기적인 검토와 업데이트가 필요합니다. 특히 데이터 관리 환경이 복잡한 경우 최신 정보 유지를 위한 업데이트 주기를 사전에 정해두는 것이 중요합니다.

• 업데이트 주기 설정: 일반적으로 데이터 정의서는 분기마다 혹은 연간 단위로 검토하는 것이 좋습니다. 이를 통해 변경된 데이터를 반영하고, 필요하지 않게 된 항목을 삭제하거나 새로 추가된 데이터를 기록할 수 있습니다.
• 자동화 도구 활용: 많은 데이터 정의 항목을 수동으로 관리하기 어렵다면, 데이터베이스 관리 툴이나 메타데이터 관리 시스템을 활용하여 자동으로 항목을 업데이트할 수 있는 도구를 도입하는 것도 좋습니다. 이러한 시스템은 특정 필드의 변경 내역을 기록하고 버전 관리를 지원할 수 있습니다.
• 수정 내역 기록: 모든 업데이트 내용은 별도의 기록 문서에 작성하여 변경 사항을 쉽게 추적할 수 있어야 합니다. 예를 들어, 데이터 구조 변경으로 고객 정보에 ‘이메일 주소’ 항목이 추가되었을 경우, 언제 누구에 의해 추가되었는지를 기록해 두면 팀원들이 최신 정보에 쉽게 접근할 수 있습니다.

4.3. 팀원 간의 협력

데이터 정의서 작성은 한 부서에서 독립적으로 수행하기보다는 관련 부서의 의견과 협력을 통해 이루어져야 합니다. 데이터는 다양한 부서에서 각기 다른 방식으로 활용되기 때문에 모든 부서가 공유할 수 있는 정의서가 되어야 합니다.

• 각 부서의 데이터 담당자 지정: 각 부서에 데이터 담당자를 지정하여 데이터 정의서 작성 및 검토 과정에 참여하도록 합니다. 예를 들어, 마케팅 부서는 고객 행동 데이터를, 영업 부서는 고객 연락처 정보를 중요하게 생각할 수 있습니다. 따라서 각 부서 담당자가 각 데이터에 대해 상세히 설명하도록 하여 데이터 정의서에 부서별 관점을 반영할 수 있습니다.
• 검토 회의 주최: 데이터 정의서 작성 과정에서 정기적으로 검토 회의를 열어 새로운 데이터 추가, 기존 항목 수정, 데이터 관리 방법 등을 협의합니다. 이 과정을 통해 데이터 정의서의 품질을 높일 수 있으며, 각 부서가 정의서에 포함된 정보를 이해하고 활용할 수 있게 됩니다.
• 부서 간 데이터 사용 방안 명확화: 서로 다른 부서가 데이터를 다르게 사용하거나 다른 기준으로 해석할 수 있습니다. 이를 방지하기 위해 데이터 정의서 내에서 특정 데이터가 어떤 부서에서, 어떤 목적으로 주로 활용되는지를 명시할 수 있습니다. 예를 들어, ‘고객 상태’라는 항목의 경우, 영업 부서에서는 활성 고객과 휴면 고객으로 구분할 수 있고, 마케팅 부서에서는 특정 캠페인 참여 고객을 더 주의 깊게 볼 수 있습니다. 데이터 정의서 내에서 이러한 사용 목적을 상세히 기재하면 혼란을 줄일 수 있습니다.

5. 데이터 정의서로 데이터 관리를 더 쉽게!

데이터 정의서는 데이터 관리의 기본이자 중요한 첫걸음입니다. 모든 데이터가 명확히 정의된 문서를 갖추면, 데이터 관련 업무의 효율성도 크게 향상됩니다. 위의 설명과 템플릿 예시를 활용해 직접 데이터 정의서를 작성해 보시면 의외로 쉽습니다. 서비스 기획자가 데이터 정의서 작성에 중요한 기여를 할수 있습니다. 시스템이 어떻게 동작하고, 사용자에게 어떤 데이터를 제공해야 하는지를 정의하는 역할을 하기 때문입니다. 서비스 기획자는 사용자와의 접점, 비즈니스 로직을 명확히 이해하고 있으므로, 개발자가 잘 이해하기 힘든 업무적인 의미와 데이터의 흐름을 명확히 설명할 수 있어, 데이터 정의서를 함께 작성하거나 리뷰하는 역할을 수행할 수 있습니다.