사이트 소개

데이터 준비 › 절차

팩 구성과 배포

유형 · 절차읽는 시간 · 약 4분데이터 제공 담당자 · 도구 개발자

목차목차
  1. 기본 원칙
  2. 준비 상태별 필요한 파일
  3. 원본과 요약
  4. 배포 전 검증
  5. 배포와 게시

준비를 마친 데이터를 배포하는 단위인 팩(Pack)의 구성 파일, 파일 사이의 참조, 배포 전 검증 방법입니다.

팩은 배포 단위입니다 [제1부 3.15 · 5.5 · 제3부 5.1]. 팩의 세부 구조(파일 배치 · 묶음 형식)는 운영 지침이 설정합니다. 표준이 제공하는 운영 지침은 표준 제정 시 공개합니다(2026년 12월 예상). 이 페이지의 파일 이름과 주소는 모두 예시입니다.

기본 원칙

  1. 데이터셋은 실체이고, 마니페스트는 데이터셋을 기술하는 문서입니다. 마니페스트의 식별자는 데이터셋의 식별자와 다릅니다. [제3부 5.1]
  2. 마니페스트는 결과서(진단 리포트)와 운용 파일을 주소와 SHA-256 해시로 가리킵니다. [제3부 5.2]
  3. 결과서는 품질 판정 결과의 원본입니다. 마니페스트의 품질 항목은 결과서의 요약입니다. [제3부 5.2 · 제2부 9]
  4. 데이터 파일은 팩에 넣지 않습니다. 마니페스트의 배포 자원이 데이터 파일을 주소와 해시로 가리킵니다. [제3부 5.1]
  5. 계층(발견 · 이해 · 운용)은 메타데이터의 기능으로 나눕니다. 파일의 형식이나 위치로 나누지 않습니다. [제3부 5.1]

준비 상태별 필요한 파일

각 상태의 기재 범위는 앞 상태의 기재 범위를 포함합니다. [제3부 5.3]

상태를 고르면 그 상태에 필요한 파일만 밝게 표시됩니다. 파일을 고르면 표준 근거와 다른 파일을 가리키는 방식이 나타납니다. 파일 이름 · 주소 · 해시 · 점수는 모두 설명용 가상 값입니다.

표준 심의본 본문이 규정합니다어휘표 어휘표 v0.10.5가 정의합니다. 심의본 본문에는 같은 형태가 없습니다적용 예시 표준이 정하지 않아 이 예시에서 택한 방식입니다
표로 보기
준비 상태필요한 파일기재하는 계층전이 판정
찾을 수 있는 데이터 (Discoverable)마니페스트 1개. 컬럼 정의서를 별도 문서로 두면 그 문서도 포함발견 계층확인 지점 G1 — 발견 계층 필수 항목 충족
품질이 확인된 데이터 (Quality-Ready)마니페스트 · 결과서 · 팩 마니페스트발견 · 이해 계층확인 지점 G2 — 측정 완성도 DM-2, 운영 지침의 임계 프로파일로 판정한 등급 Tier 1 이상
목적에 맞게 준비된 데이터 (Purpose-Ready)Quality-Ready 팩 + 활용 목적 유형마다 운용 파일 1개발견 · 이해 · 운용 계층확인 지점 G3 — 등록된 목적 프로파일의 운용 계층 필수 항목 충족

Discoverable 상태에서는 마니페스트를 공개합니다. 팩은 Quality-Ready 이상에서 만드는 배포 단위입니다. 확인 지점의 판정 절차 세부는 제4부후속 부가 다룹니다.

원본과 요약

마니페스트는 결과서를 주소와 해시로 가리키고, 결과서 값의 일부를 이해 계층에 요약해 기재합니다. 요약 대상 항목은 제2부 표 9-2가 규정합니다. 요약 값과 결과서 값이 다르면 결과서 값이 우선하고, 불일치는 검증 실패로 처리합니다. [제3부 5.2 · 제2부 9.2]

제2부 표 9-2 항목결과서 키마니페스트 속성 (어휘표 번호)예시 값
최소 차원 점수qualityIndex.minDimensionScoreaird:qualityIndexMin (2.2.9)0.82
가중 평균qualityIndex.weightedAverageaird:qualityIndexAvg (2.2.10)0.91
최소 측정 지표(MMI) 점수qualityIndex.mmiScoreaird:qualityIndexMMI (2.2.11)1.0
품질 등급과 라벨qTier.tier · qTier.labelaird:qualityTier · aird:qualityTierLabel (2.2.3 · 2.2.5)Tier2 · Silver (Tier 2, STRUCT)
측정 완성도(진단 성숙도)diagnosticMaturityaird:diagnosticMaturity (2.2.12)DM-2
데이터 유형dataTypeaird:dataType (2.2.2)STRUCT
진단 일시generatedAtprov:generatedAtTime (2.2.15)2026-…T…+09:00
임계 프로파일의 식별 정보thresholdProfileaird:thresholdProfile (2.2.20)식별자 · 1.0 · 해시 · OFFICIAL
판정 규칙 버전과 스키마 버전diagnosticInfo.ruleVersion · schemaVersionaird:ruleVersion · aird:schemaVersion (2.2.17 · 2.2.18)…
전이 적격성qTier.qualityReadyEligibleaird:qualityReadyEligible (2.2.14)true

마니페스트 속성은 어휘표 v0.10.5의 품질 판정(aird:QualityAssessment) 항목입니다. 제2부 표 9-2와 이 속성의 대응은 심의본 본문에는 없습니다. 예시 값의 등급은 가상의 조직 운영 지침(OFFICIAL 임계 프로파일)을 적용한 값입니다.

배포 전 검증

팩이 포함하거나 참조하는 모든 파일은 팩에 넣었는지와 관계없이 SHA-256 해시를 기재합니다. 해시가 하나라도 일치하지 않으면 검증에 실패합니다. 해시 불일치는 효력 정지(Stale) 사유입니다. 검증 항목은 다섯 가지입니다. [제3부 9.2 · 표 9-3]

#검증 항목내용팩에서 보는 곳
1결과서 참조마니페스트가 가리키는 결과서의 주소가 유효하고 해시가 일치합니다마니페스트 품질 판정 → 결과서
2요약 값 일치마니페스트의 요약 값이 결과서의 값과 일치합니다. 대상은 제2부 표 9-2품질 판정 항목 ↔ 결과서
3이해 계층 완비선언한 상태의 필수 항목과 참조 무결성이 모두 갖추어졌습니다마니페스트 전체 + 참조 파일 해시
4상태와 기재 범위 일치선언한 상태와 실제로 기재한 계층의 범위가 일치합니다. 범위가 넓어도 좁아도 실패상태 선언 ↔ 기재한 계층
5파생물의 버전 일치운용 파일의 기반 데이터 버전이 결과서의 데이터셋 버전과 일치합니다운용 파일 ↔ 결과서

검증을 통과해도 Quality-Ready로 바로 전이하지 않습니다. 전이는 확인 지점 G2 통과가 요건입니다. [제3부 9.3]

배포와 게시

  1. 데이터 파일은 원래 배포처(공공데이터포털 · 사내 저장소)에 둡니다. 팩은 주소와 해시로 데이터 파일을 가리킵니다.
  2. 마니페스트와 팩 파일은 이용자와 에이전트가 내려받을 수 있는 공개 주소에 둡니다. 공공데이터는 포털 상세 화면 주소를 dcat:landingPage에 적습니다.
  3. 데이터를 고치거나 다시 측정하면 마니페스트를 새 버전으로 발행합니다. 이전 버전의 파일은 바꾸지 않습니다.
  4. 팩의 묶음 형식과 파일 배치는 적용하는 운영 지침을 따릅니다.
  5. 카탈로그 · 레지스트리 게시, 탐색, 교환은 제5부후속 부가 다룹니다.

공공데이터 예제 4종은 측정 결과를 설명하는 자료입니다. 이 페이지의 팩 구조로 배포하지 않았습니다. 운영 지침을 적용하지 않았으므로 준비 상태는 Discoverable입니다. 마니페스트의 전체 예시는 마니페스트 예시에 있습니다.

완료 조건

  • 선언한 준비 상태에 필요한 파일을 모두 갖추었습니다.
  • 마니페스트가 가리키는 모든 파일에 SHA-256 해시를 기재했습니다.
  • 데이터 파일을 팩에 넣지 않았습니다.
  • 마니페스트의 요약 값이 결과서의 값과 같습니다.
최종 수정 · 2026-10-07오류 신고