사이트 소개

데이터 준비 › 예제

예시 데이터로 따라가기

유형 · 절차읽는 시간 · 약 10분데이터 제공 담당자

목차목차
  1. ① 데이터 개요
  2. ② 발견 계층 작성
  3. ③ 품질 측정
  4. ④ 목적별 준비
  5. 남은 일과 그 이유

예시 파일 한 건(사업장 등록 정보 20건)에 준비 단계를 차례로 적용해, 단계마다 무엇을 기재하고 측정 결과가 어떻게 달라지는지 보여 줍니다.

예시 예시 파일은 예시용 가상 데이터입니다. 실재하는 조직이나 데이터를 가리키지 않습니다. 이 페이지의 수치는 예시 파일을 이 사이트의 측정 엔진(시험용)으로 측정한 값입니다. 같은 결과를 재현하려면 같은 입력 파일 · 도구 버전 · 측정 규칙을 사용해야 합니다.

① 데이터 개요

원본 파일

원본 파일은 example.csv입니다. 20행 · 8열 · UTF-8 인코딩의 CSV 파일입니다. 처음 세 행은 다음과 같습니다.

bizIdbizNameindustryCoderegionCodeemployeeCountrevenueBandregisteredOnclosedFlag
B-2019-0001가온정밀C292941168042B32019-03-110
B-2019-0014대성포장C222404113517B22019-05-020
B-2019-0033한별전자C2642928185133B42019-07-190

시작 시점에는 파일만 있고 설명이 없습니다.

유형 판정: 표 형태 STRUCT — 예시 파일은 행과 열이 있고 컬럼마다 자료형이 정해집니다. [제1부 5.6 표 5-5]

개인정보 확인 — 사업장명은 법인 정보입니다. 개인사업자의 사업장명은 개인정보에 해당할 수 있습니다. 담당자는 단독으로 판단하지 않고 개인정보 보호 담당 부서와 함께 확인합니다. 확인 절차는 데이터 확인에 있습니다.

② 발견 계층 작성 (기재 항목 · 컬럼 정의서)

예시 데이터 · 실측 1단계에서 담당자는 데이터 설명서(마니페스트)의 발견 계층을 채웁니다. 1단계는 데이터값을 바꾸지 않습니다. 1단계가 더하는 것은 값의 의미 · 형식 · 출처를 설명하는 정보입니다.

담당자가 채운 것: 데이터셋 기재 항목 19개

데이터셋 기재 항목 19개 — 표 17행 펼치기
항목채운 값
데이터셋 식별자https://data.example.go.kr/id/dataset/biz-registry
제목예시 사업장 등록 정보
설명지역별 사업장의 등록 정보와 영업 상태를 수록한 데이터셋
키워드사업장 · 산업분류 · 지역 · 영업상태 (4개)
데이터 서비스 유형FILE (파일)
데이터셋 구조 유형Structured (표 형태)
언어KOR
라이프사이클 상태Discoverable
주제 분류INDUSTRY_EMPLOYMENT
랜딩 페이지https://data.example.go.kr/dataset/biz-registry
생산 주체 · 제공 주체예시기관
관리 부서 · 연락처예시기관 데이터관리팀 · data@example.go.kr
생성 방법collected (조사 · 측정)
갱신 주기ANNUAL (연 1회)
라이선스KOGL-1 (공공누리 제1유형)
이용 조건공공누리 제1유형. 출처를 표시하면 상업적 이용과 변형을 허용합니다.
접근 권한PUBLIC

값 목록 항목은 표기 값(예: KOR · KOGL-1)으로 고릅니다. 마니페스트에는 어휘표의 개념 URI가 들어갑니다. 항목별 기재 방법은 기재 항목에 있습니다.

예시 조직에는 식별자 발급 정책이 없습니다. 그래서 담당자는 고유 식별자 정하기의 기본 형식 https://data.<조직 도메인>/id/dataset/<이름>을 적용했습니다. 데이터셋 식별자는 다음과 같습니다.

https://data.example.go.kr/id/dataset/biz-registry

담당자가 채운 것: 컬럼 정의서 8개 컬럼

담당자는 컬럼 정의서(csvw:tableSchema)에 8개 컬럼의 자료형과 설명을 적었습니다.

컬럼 정의서 — 표 8행 펼치기
컬럼자료형설명
bizIdstring사업장 고유 등록번호. B-YYYY-NNNN 형식. 필수 컬럼
bizNamestring사업장 명칭
industryCodestring한국표준산업분류 세세분류 코드
regionCodestring행정표준코드 법정동 시군구 코드
employeeCountinteger상시 종업원 수. 0 이상 100000 이하
revenueBandstring매출 구간 코드. B1부터 B4까지
registeredOndate최초 등록일. ISO 8601-1 날짜
closedFlaginteger폐업 여부. 0은 영업, 1은 폐업

담당자는 bizId를 필수 컬럼으로 표시했습니다. 필수 컬럼 표시가 있어야 진단 도구가 D1-01(필수 필드 충족도)을 측정할 수 있습니다.

담당자는 코드값의 의미도 적어야 합니다. 예를 들어 revenueBand의 B3가 어느 매출 구간인지 적혀 있지 않으면 이용자와 에이전트는 revenueBand 컬럼을 해석할 수 없습니다.

employeeCount 설명에 적은 「0 이상 100000 이하」는 사람이 읽는 설명입니다. 진단 도구가 D5-02(수치 범위 유효성)를 측정하려면 컬럼 정의서의 자료형에 최소값 · 최대값(CSVW datatype의 minimum · maximum)을 따로 적어야 합니다. 이 예시는 설명에만 적었으므로 D5-02는 미측정으로 남습니다.

배포 자원 기재 항목 4개

항목값작성 주체
접근 주소https://data.example.go.kr/aird/.../example.csv담당자
미디어 타입text/csv측정 엔진
파일 형식CSV담당자
체크섬7ad8add25d7a6383… (SHA-256)측정 엔진이 파일에서 계산

측정 엔진은 컬럼별 관측값(비어 있지 않은 비율 · 고유값 수 · 예시값)도 만들었습니다. 이 예시에서는 측정 엔진이 체크섬을 계산했습니다. 담당자는 sha256sum 같은 일반 도구로 체크섬을 직접 계산할 수도 있습니다.

③ 품질 측정

예시 데이터 · 실측 이 사이트의 측정 엔진(시험용)으로 예시 파일을 두 번 측정했습니다. 첫 번째는 파일만 있을 때입니다. 두 번째는 1단계 기재 항목을 채우고 레코드 키를 bizId로 지정한 뒤입니다. 아래 수치는 계산 예가 아니라 측정값입니다.

파일만 있을 때와 1단계 후의 비교

항목파일만1단계 후
기재 항목1 / 2323 / 23
컬럼 설명0 / 88 / 8
측정한 정식 필수 지표6 / 137 / 13
측정 완성도(표준 용어: 진단 성숙도, DM)DM-0 (잠정)DM-0 (잠정)
품질 등급판정하지 않음: 운영 지침 미적용판정하지 않음: 운영 지침 미적용
에이전트가 추정해야 하는 판단102
  • 파일만 있을 때 충족한 기재 항목 1개는 측정 엔진이 파일에서 계산한 체크섬입니다.
  • 1단계 후 측정한 지표는 1개 늘었습니다. 담당자가 bizId에 필수 표시를 달아 D1-01(필수 필드 충족도)을 측정할 수 있게 되었습니다.
  • 데이터값은 바뀌지 않았습니다. 값을 해석하는 데 필요한 기재 정보만 늘었습니다.

최소 측정 지표(MMI) 4개(D5-03 · D6-01 · D7-01 · D7-02)는 두 측정 모두에서 측정했습니다. D5-03(통계적 타당성)은 운영 지침이 없어 [제2부 부록 Ⅰ]의 예시 패턴으로 측정한 잠정값입니다. 정식 필수 지표 13개 중 7개만 측정했으므로 측정 완성도는 DM-2가 되지 않습니다. 측정 완성도를 결정하는 결정표는 판정 절차에 있습니다.

품질 등급을 판정하지 않은 원인은 데이터가 아니라 운영 지침 미적용입니다. 점수가 모두 1.0000이어도 운영 지침을 적용하지 않으면 등급을 판정하지 않습니다. 결과서의 평가 상태 PROVISIONAL은 잠정 측정을 뜻하며 등급이 아닙니다.

파일만 있을 때의 지표별 점수

행 20 · 열 8 · 인코딩 UTF-8

1. 기재 항목 23개      충족 1 / 23
2. 컬럼 스키마         없음: 헤더와 값에서 초안을 생성한다
3. 품질 측정
     D1-02  필수 메타데이터 항목 충실도   0.0435
     D5-01  형식 유효성               1.0000
     D5-03  통계적 타당성              1.0000 (잠정)
     D6-01  유일성                   1.0000
     D7-01  인코딩 일관성              1.0000
     D7-02  기술적 유효성              1.0000

파일은 열리고 형식도 유효하지만 설명이 없습니다. 레코드 키를 지정하지 않았으므로 D6-01(유일성)은 전체 컬럼 조합으로 측정한 값입니다.

1단계 후의 지표별 점수

지표측정 대상점수
D1-01필수 필드 충족도1.0000
D1-02필수 메타데이터 항목 충실도1.0000
D5-01형식 유효성1.0000
D5-03통계적 타당성 · MMI1.0000 (잠정)
D6-01유일성 · MMI1.0000
D7-01인코딩 일관성 · MMI1.0000
D7-02기술적 유효성 · MMI1.0000

20건 모두 형식이 맞아 수정할 값이 없었습니다. 예시 파일은 형식 오류를 제거한 파일입니다. 실제 데이터에서는 D5-01(형식 유효성)과 D7-01(인코딩 일관성)이 1.0000 미만으로 측정될 수 있습니다. 실제 공공데이터의 측정 결과는 공공데이터 예제에 있습니다.

미측정 지표와 사유

결과서(표준 용어: 진단 리포트)는 미측정 지표와 측정에 필요한 자료를 함께 기록합니다. 예시 파일의 미측정 지표 6개는 다음과 같습니다. 이 목록이 담당자가 구해야 할 자료의 목록입니다.

지표측정에 필요한 자료
D2-01 필드 간 관계 일관성컬럼 정의서 또는 마니페스트에 정의된 관계 규칙
D2-02 참조 무결성대조할 마스터 코드 테이블의 실제 값 (주소 · 참조만으로는 미충족)
D2-03 파생값 정확성파생값 계산 규칙의 정의 (저장된 파생값이 없으면 해당 없음)
D3-01 표준 명칭 정합성코드–명칭 대응으로 쓸 수 있는 공인 참조 기준. 데이터에 코드와 명칭이 함께 있어야 함
D4-01 최신성기준 시점과 갱신 이력
D5-02 수치 범위 유효성컬럼별 허용 수치 범위의 정의

미측정 사유를 읽는 방법은 결과서 읽기 (2단계)에 있습니다.

결과서 발췌

generatedAt   2026-10-05T...
datasetFile   example.csv
fileChecksum  SHA-256 7ad8add2...
dataType      STRUCT
recordCount   20
indicators    D1-01 1.0 (필수) · D5-01 1.0 (필수) · D5-03 1.0 (필수 · 잠정) · ...
notMeasured   D2-02 (필수): 마스터 코드 테이블의 실제 값을 대조할 것
              D3-01 (필수): 공인 참조 기준이 필요함
formalAssessmentCoverage  0.5385
diagnosticMaturity        DM-0
assessmentStatus          PROVISIONAL
thresholdProfile          예시 프로파일 (EXAMPLE)
note   예시 프로파일로 산출한 잠정 결과서다. 공식 공시와 조직 간 비교에 쓰지 않는다.
  • formalAssessmentCoverage 0.5385는 정식 필수 지표 13개 중 7개를 측정했다는 범위값입니다. 품질 점수나 등급이 아닙니다.
  • assessmentStatus PROVISIONAL은 D5-03을 예시 패턴으로 잠정 측정했다는 평가 상태입니다.
  • thresholdProfile의 예시 임계 프로파일(판정 기준값)은 상태가 EXAMPLE입니다. 예시 임계 프로파일은 잠정 계산용이며 등급 판정에 쓰지 않습니다.

④ 목적별 준비

예시 데이터 · 실측 담당자는 예시 데이터로 성립할 수 있는 활용 목적을 가려냅니다. 검토 대상은 예시 데이터에 해당하는 목적으로 한정합니다.

활용 목적예시 데이터의 해당 사항판단
ML(기계학습)정답 컬럼 후보 closedFlag (폐업 여부)후보
KG(지식그래프)표준 코드 컬럼 industryCode · regionCode후보
Stats(통계 분석)registeredOn은 등록 시점이며 시간 순서 측정값이 아님해당 없음
RAG(검색증강생성)자연어 문서 없음해당 없음
DL(심층학습)이미지 없음해당 없음
FineTuning(미세조정)지시문 · 응답 쌍(PT) 없음해당 없음

목적을 고르는 것만으로 3단계가 끝나지 않습니다. 3단계의 산출물은 목적 유형마다 하나씩 만드는 목적별 운용 파일입니다. 목적 등급은 그 목적의 목적 프로파일이 등록되어야 판정합니다. 목적 프로파일이 등록되지 않았으면 담당자는 목적 등급을 「판정하지 않음」으로 적고 사유 PROFILE_NOT_REGISTERED(목적 프로파일 미등록)를 함께 적습니다.

3단계는 활용 목적이 확정된 뒤에 수행합니다. 예시 데이터는 1단계를 마쳐 찾을 수 있는 데이터(Discoverable)의 기재 요건을 갖추었고, 2단계 결과서를 갖추었습니다. 품질이 확인된 데이터(Quality-Ready)가 되려면 측정 완성도 DM-2와 운영 지침을 적용한 Tier 1 이상의 등급이 필요합니다.

남은 일과 그 이유

예시 파일은 1단계 기재와 2단계 측정까지 마쳤습니다. 측정 완성도 DM-2 · 품질 등급 · 목적별 운용 파일이 남아 있습니다. 담당자는 남은 항목마다 사유를 구분해 기록합니다. 데이터 자체의 미충족과 운영 지침 미적용을 섞어 적지 않습니다. 사유의 목록은 상태값과 판정값에 있습니다.

사유 구분뜻예시 파일의 항목
즉시 수행 가능추가 자료 불필요레코드 키 지정 · 기재 항목 입력 (1단계에서 완료) · 한계 기록
자료 확보 후 수행확보할 자료와 측정 가능해지는 지표코드표 → D2-02 · D3-01, 기준 시점 · 갱신 이력 → D4-01
담당자 범위 외사유 기록 후 대기운영 지침 적용 → 품질 등급 판정

담당자 후속 조치

측정 엔진이 결과서와 함께 만든 후속 조치 목록은 다음과 같습니다.

  1. 산업분류 · 법정동 코드표를 확보합니다. 결과: D2-02(참조 무결성)를 측정할 수 있습니다.
  2. 코드–명칭 대응 자료를 확보합니다. 결과: D3-01(표준 명칭 정합성)을 측정할 수 있습니다.
  3. 기준 시점과 갱신 이력을 정리합니다. 결과: D4-01(최신성)을 측정할 수 있습니다.
  4. 수정할 수 없는 한계를 기록합니다. 예: 「폐업 신고 지연으로 closedFlag가 실제보다 늦게 반영될 수 있음」. 결과: 마니페스트 이해 계층의 한계 기록.
  5. 운영 지침을 적용해 운영 지침이 요구하는 지표를 다시 측정합니다. 필요한 것: 표준 제공 운영 지침(표준 제정 시 공개, 2026년 12월 예상) 또는 조직이 구성 · 공개한 운영 지침. 결과: 새 결과서와 그 운영 지침 기준으로 판정한 등급.
최종 수정 · 2026-10-07오류 신고