사이트 소개

데이터 준비 › 절차

마니페스트 작성 (1단계)

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

목차목차
  1. 1단계 점검표 — 기재 항목 23개 (데모 프로파일)
  2. 단계 개요
  3. 확인 항목
  4. 컬럼 정의서 작성
  5. 파일 형식 결정
  6. 작성 예시와 빈번한 오류

1단계에서 발견 계층의 기재 항목 23개와 컬럼 정의서를 채워 데이터 설명서(마니페스트) manifest.json(JSON-LD)을 만듭니다. 마니페스트는 데이터가 Discoverable(찾을 수 있는 데이터) 상태에 이르는 근거입니다.

1단계 작업 흐름

1단계 점검표 — 기재 항목 23개 (데모 프로파일)

0 / 23 채움

데이터셋

배포 자원 (파일별)

체크 상태는 이 브라우저에만 저장됩니다. 원천: 어휘표 v0.10.5 데모 프로파일.

단계 개요

1단계의 목표는 데이터가 무엇이고 어디에 있는지를 기계가 읽을 수 있는 형식으로 기록하는 것입니다. 담당자는 현재 버전의 안내만으로 1단계를 마칠 수 있습니다. 고유 식별자는 고유 식별자 정하기의 잠정 규칙을 사용합니다.

작업결과물
전용 형식을 개방 형식으로 변환개방 형식 파일 (예: CSV · JSON)
기재 항목 작성마니페스트 manifest.json — JSON-LD, 발견 계층
컬럼별 의미 기재컬럼 정의서(csvw:tableSchema) — 마니페스트에 포함

마니페스트의 전체 예시는 마니페스트 예시에, 마니페스트가 들어가는 팩의 구조는 팩 구성과 배포에 있습니다. 마니페스트는 버전마다 새로 발행하고 이전 버전을 가리킵니다.

1단계는 데이터값을 바꾸지 않습니다. 담당자는 데이터의 내용을 유지하고 설명을 더합니다. [제1부 5.2]

작업 주체

담당자가 혼자진단 도구가조직이 결정
기재 항목 작성 · 컬럼 정의서 작성 · 개방 형식 변환 · 마니페스트 작성 · 체크섬 계산(sha256sum)체크섬 계산 · 마니페스트 초안 생성고유 식별자 발급 정책 · 라이선스와 이용 조건 · 개인정보 공개 범위

담당자는 체크섬을 직접 계산할 수 있습니다. Linux에서는 sha256sum <파일>, macOS에서는 shasum -a 256 <파일>을 실행합니다. 진단 도구도 파일에서 체크섬을 계산합니다. 담당자는 마니페스트를 직접 작성할 수 있고, 진단 도구가 만든 초안을 고쳐 쓸 수도 있습니다.

담당자와 진단 도구는 확인 지점 ①에서 필수 기재 항목의 충족 여부를 확인합니다. [제4부 6.4]후속 부 충족하지 못한 항목은 보완하고 다시 확인합니다.

1단계가 돕는 판단

1단계의 작업은 데이터 탐색 · 접근 · 이용 조건 확인을 돕습니다. 식별자는 다른 자료가 데이터를 참조하게 합니다. 컬럼 설명은 값의 의미를 전달합니다. 이용 조건은 사용 가능 여부를 판단하는 근거가 됩니다. 담당자는 FAIR 원칙을 몰라도 1단계를 수행할 수 있습니다.

확인 항목

기재 항목은 23개(데이터셋 19 + 배포 자원 4)입니다. 이 사이트는 어휘표 v0.10.5 데모 프로파일의 23개를 씁니다. 심의본 필수는 19개(데이터셋 15 + 배포 자원 4)입니다. 데모 프로파일은 데이터셋 구조 유형 · 주제 분류 · 랜딩 페이지 · 관리 부서 4개를 더합니다. 주제 분류 · 랜딩 페이지는 공공데이터에서 필수이고 그 밖에는 권장입니다. [제3부 부속서 A.1]

배포 자원 항목 4개는 배포하는 파일마다 적용합니다. 파일이 3개면 기재값은 19 + 4 × 3 = 31개입니다. 전체 목록과 판단 기준은 기재 항목에 있습니다.

자주 누락되거나 잘못 기재되는 항목 6개는 다음과 같습니다.

항목구분판단 기준자주 나오는 문제
고유 식별자필수변경하지 않는 영구 식별값. 해석 가능한 URI가 원칙. 접근 주소와 구분조직 내부 번호를 그대로 사용
키워드필수3개 이상1~2개만 기재
갱신 주기필수표준 목록의 URI로 기재「분기」 · 「수시」 같은 자유 문자열
라이선스필수어휘표 kr-license 14값에서 선택 (예: KOGL-0~4 · KOGL-AI · CC). 목록에 없는 라이선스의 기재 방법은 확인 중「예 / 아니오」 또는 긴 문장
미디어 타입필수text/csv 형태의 IANA 표기「텍스트」 · 「이미지」
체크섬필수배포 자원마다 SHA-256 값기재 누락

고유 식별자와 접근 주소는 다릅니다. 고유 식별자는 데이터셋을 식별하는 값입니다. 접근 주소는 실제 데이터에 접근하는 위치입니다. 담당자는 두 항목을 같은 값으로 채우지 않습니다. 조직에 식별자 발급 정책이 없으면 고유 식별자 정하기의 잠정 규칙을 적용합니다.

파일이 여러 개면 배포 자원을 여러 개로 구성합니다. 표 · 이미지 · 영상을 함께 제공하면 배포 자원마다 접근 주소 · 미디어 타입 · 파일 형식 · 체크섬을 따로 적습니다.

표 형태 데이터는 컬럼 정의서가 필수입니다. 컬럼 정의서는 마니페스트에 직접 기재하거나, 별도 문서로 두고 마니페스트가 주소와 해시로 가리킵니다. 작성 방법은 「컬럼 정의서 작성」 절에, 판단 기준은 기재 항목에 있습니다.

컬럼 정의서 작성

컬럼 정의서(csvw:tableSchema)는 컬럼마다 이름 · 자료형 · 의미를 적은 표입니다. 컬럼 정의서가 없으면 데이터값의 의미를 확인하기 어렵습니다.

필요성

원본 데이터베이스의 컬럼 설명은 CSV로 내보낼 때 사라질 수 있습니다. 컬럼명만 남으면 mkt_nm 같은 명칭의 의미를 확인하기 어렵습니다. 2단계 품질 측정도 컬럼 정의서를 입력으로 씁니다.

컬럼별 기재 항목

컬럼별 기재 항목 — 표 11행 펼치기
항목구분예2단계에서 이 항목이 필요한 지표
이름(컬럼명)필수bizr_no—
자료형필수문자열—
설명필수국세청이 부여한 사업자 등록 번호. 하이픈 없음—
필수 여부필수필수 (값이 비면 안 됨)D1-01(필수 필드 충족도)
값 범위권고employeeCount 0 이상 100000 이하D5-02(수치 범위 유효성)
필드 간 관계권고예시 폐업 여부가 1이면 폐업일이 있음D2-01(필드 간 관계 일관성)
파생 규칙권고예시 합계 = 남성 수 + 여성 수D2-03(파생값 정확성)
코드표와 그 판권고한국표준산업분류(개정 차수 명시) · 코드값 의미 01=운영, 02=휴업, 03=폐업D2-02(참조 무결성)
표시 이름권고사업자등록번호—
단위권고원 · ㎡ · ℃—
빈 값 표기권고빈칸—

권고 항목은 2단계 측정의 입력입니다. 컬럼 정의서에 필수 여부 · 값 범위 · 필드 간 관계 · 파생 규칙 · 코드표와 그 판이 없으면 진단 도구는 2단계에서 D1-01 · D5-02 · D2-01 · D2-03 · D2-02를 측정할 수 없습니다. 측정하지 못한 지표는 결과서(표준 용어: 진단 리포트)에 미측정 사유와 함께 기록됩니다(결과서 읽기 (2단계)).

빈 값 표기는 표준의 요건이 아니지만 실무에서 자주 문제가 됩니다. 빈칸 · - · N/A · 0을 섞어 쓰면 0이 실제 값인지 빈 값인지 구별할 수 없습니다.

파일 형식 결정 권고

상황권장근거
표 형태CSV (UTF-8)범용 도구에서 판독 가능
표 형태 · 대용량Parquet 병행내려받기 · 처리 속도 향상
계층 구조가 있는 데이터JSON표로 평탄화하면 계층 관계 손실
지리 정보GeoJSON좌표계 포함
문서원문 형식 + 텍스트 추출본원문만으로는 기계 판독 불가
이미지표준 이미지 형식전용 형식은 범용 도구에서 판독 불가

기준 인코딩은 UTF-8입니다. 인코딩 확인 방법은 데이터 확인에 있습니다.

피해야 할 형식

  • 특정 프로그램에서만 열리는 형식만 제공
  • 셀 병합 · 소계 행 · 여러 줄 머리글이 들어간 표
  • 설명 없이 여러 표를 시트로 나눠 담은 파일

이미지 라벨(정답지), 학습 · 검증 분할, 지시문 · 응답 쌍의 대응 관계, 문서 분할 단위는 1단계의 요건이 아닙니다. 라벨이 없는 사진도 「찾을 수 있는 데이터」가 될 수 있습니다.

작성 예시와 빈번한 오류

작성 예시

수정 전

제목: 데이터
설명: 관련 데이터이다.
갱신 주기: 수시
라이선스: 제3자 권리 포함 여부 - N
미디어 타입: 텍스트
컬럼 정의서: (없음)

수정 후

제목: 2025년 ○○시 사업장 등록 현황
설명: ○○시에 등록된 사업장의 업종 · 소재지 · 영업상태.
      2025-12-31 기준, 12,480건.
키워드: 사업장, 인허가, 업종, ○○시
데이터 유형: STRUCT
갱신 주기: http://publications.europa.eu/resource/authority/frequency/IRREG
라이선스: KOGL-1  (어휘표 kr-license 값)
이용 조건: 공공누리 제1유형. 출처를 표시하면 자유롭게 이용할 수 있음. (고지문)
미디어 타입: text/csv
접근 권한: PUBLIC
컬럼 정의서: 14개 컬럼 전체에 이름 · 자료형 · 설명 · 필수 여부 · 코드값 기재

빈번한 오류

1단계에서 자주 나오는 오류 3가지는 다음과 같습니다.

잘못된 예수정한 예문제 원인
갱신 주기에 「분기」 또는 「수시」라는 자유 문자열 기재표준 목록의 URI로 기재 — 「분기」는 …/frequency/QUARTERLY, 「수시」는 …/frequency/IRREG갱신 주기는 표준 목록에서 고르는 항목. 기계는 자유 문자열을 해석할 수 없음
이용 조건에 「제3자 권리 포함 여부: N」 기재라이선스 값 목록(어휘표 kr-license)에서 선택 (예: KOGL-1). 이용 조건에는 이용 범위 고지문 기재무엇을 허용하는지 알 수 없음
다른 데이터의 마니페스트를 복사하고 접근 주소를 고치지 않음복사한 마니페스트의 접근 주소를 이 데이터의 주소로 수정형식은 유효해도 잘못된 위치를 가리킴. 형식 검사로 검출되지 않는 결함

완료 조건

  • 「1단계 점검표」에서 기재 항목 23개를 모두 채웠습니다.
  • 컬럼 정의서에 컬럼마다 이름 · 자료형 · 설명 · 필수 여부를 적었습니다.
  • 고유 식별자를 결정했습니다(고유 식별자 정하기).

고유 식별자 정하기

최종 수정 · 2026-10-07오류 신고