사이트 소개

찾아보기

마니페스트 예시

유형 · 참조읽는 시간 · 약 2분모든 독자에이전트·AI 개발자 (데이터 이용자)

목차목차
  1. 판단별 판독 속성
  2. 발견 계층 — 1단계를 완료한 마니페스트
  3. 이해 계층 — 2단계에서 더해지는 것
  4. 검증된 사실 1건
  5. 팩 전체를 한 RDF 그래프로

예시 데이터(사업장 등록 정보 20건)의 데이터 설명서(마니페스트) 전체입니다. 발견 계층과 이해 계층의 속성이 JSON-LD에 어떻게 기재되는지 보여 줍니다.

발견 계층에는 예시 파일의 기재 예(meta.json)를 수록했습니다. 식별자만 이 사이트의 예시 식별자로 바꾸었습니다. 에이전트는 마니페스트 하나로 네 가지 판단(적합성 · 신뢰성 · 결합성 · 사용 가능성)을 시작합니다. 팩의 구성과 배포 방법은 팩 구성과 배포에 있습니다.

판단별 판독 속성

판단이 마니페스트의 판독 속성
적합성dct:description · csvw:tableSchema · dct:type
신뢰성aird:lifecycleStatus · dct:accrualPeriodicity · spdx:checksum
결합성dct:identifier · csvw:tableSchema
사용 가능성dct:license · dct:rights · dct:accessRights

발견 계층 — 1단계를 완료한 마니페스트

발견 계층 필수 기재 항목 23개와 컬럼 정의서(csvw:tableSchema)를 모두 채운 상태입니다. 체크섬은 example.csv의 실제 SHA-256입니다. 이 예시는 마니페스트와 데이터셋을 한 노드로 합친 간이 표기입니다. 표준은 데이터셋(실체)과 마니페스트(기술 문서)의 식별자를 나누며, 나눈 구조는 팩 구성과 배포 — 준비 상태별 필요한 파일의 마니페스트 발췌에 있습니다.

{
  "@context": [
    "https://datahub.kr/ns/aird-context-3.0.jsonld",
    {
      "dct": "http://purl.org/dc/terms/",
      "dcat": "http://www.w3.org/ns/dcat#",
      "aird": "http://vocab.datahub.kr/def/aird/",
      "aird-ml": "http://vocab.datahub.kr/def/aird-ml/",
      "aird-kg": "http://vocab.datahub.kr/def/aird-kg/",
      "csvw": "http://www.w3.org/ns/csvw#",
      "dqv": "http://www.w3.org/ns/dqv#",
      "prov": "http://www.w3.org/ns/prov#",
      "spdx": "http://spdx.org/rdf/terms#",
      "adms": "http://www.w3.org/ns/adms#",
      "vcard": "http://www.w3.org/2006/vcard/ns#",
      "rai": "http://mlcommons.org/croissant/RAI/",
      "dpv": "https://w3id.org/dpv#",
      "cr": "http://mlcommons.org/croissant/",
      "sc": "https://schema.org/",
      "void": "http://rdfs.org/ns/void#",
      "dcatkr": "http://vocab.datahub.kr/def/dcat-ap-kr/",
      "foaf": "http://xmlns.com/foaf/0.1/"
    }
  ],
  "@id": "https://data.example.go.kr/id/dataset/biz-registry/manifest/1.0.0",
  "@type": "dcat:Dataset",
  "aird:lifecycleStatus": "http://vocab.datahub.kr/def/aird/lifecycle-status/Discoverable",
  "dct:identifier": "https://data.example.go.kr/id/dataset/biz-registry",
  "dct:title": "예시 사업장 등록 정보",
  "dct:description": "지역별 사업장의 등록 정보와 영업 상태를 수록한 예시 데이터셋이다. 이 표준의 적용 절차를 보이기 위하여 작성하였다.",
  "dcat:keyword": [
    "사업장",
    "산업분류",
    "지역",
    "영업상태"
  ],
  "dct:type": [
    "http://vocab.datahub.kr/def/dcat-ap-kr/service-type/FILE",
    "http://vocab.datahub.kr/def/aird/dataset-type/Structured"
  ],
  "dct:language": [
    "http://publications.europa.eu/resource/authority/language/KOR"
  ],
  "csvw:tableSchema": {
    "columns": [
      {
        "name": "bizId",
        "datatype": "string",
        "dc:description": "사업장 고유 등록번호. B-YYYY-NNNN 형식",
        "required": true
      },
      {
        "name": "bizName",
        "datatype": "string",
        "dc:description": "사업장 명칭"
      },
      {
        "name": "industryCode",
        "datatype": "string",
        "dc:description": "한국표준산업분류 세세분류 코드"
      },
      {
        "name": "regionCode",
        "datatype": "string",
        "dc:description": "행정표준코드 법정동 시군구 코드"
      },
      {
        "name": "employeeCount",
        "datatype": "integer",
        "dc:description": "상시 종업원 수. 0 이상 100000 이하"
      },
      {
        "name": "revenueBand",
        "datatype": "string",
        "dc:description": "매출 구간 코드. B1부터 B4까지"
      },
      {
        "name": "registeredOn",
        "datatype": "date",
        "dc:description": "최초 등록일. ISO 8601-1 날짜"
      },
      {
        "name": "closedFlag",
        "datatype": "integer",
        "dc:description": "폐업 여부. 0은 영업, 1은 폐업"
      }
    ],
    "primaryKey": "bizId"
  },
  "dct:creator": [
    "https://data.example.go.kr/org/example-agency"
  ],
  "dct:publisher": "https://data.example.go.kr/org/example-agency",
  "dcat:contactPoint": {
    "@type": "vcard:Contact",
    "vcard:fn": "예시기관 데이터관리팀",
    "vcard:hasEmail": "mailto:data@example.go.kr"
  },
  "aird:creationMethod": "http://vocab.datahub.kr/def/aird/creation-method/collected",
  "dct:accrualPeriodicity": "http://publications.europa.eu/resource/authority/frequency/ANNUAL",
  "dct:license": "http://vocab.datahub.kr/def/dcat-ap-kr/license/KOGL-1",
  "dct:rights": "공공누리 제1유형. 출처를 표시하면 상업적 이용과 변형을 허용한다.",
  "dct:accessRights": "http://publications.europa.eu/resource/authority/access-right/PUBLIC",
  "dcat:distribution": [
    {
      "@type": "dcat:Distribution",
      "dcat:accessURL": "https://data.example.go.kr/aird/example-registry/data/example.csv",
      "dcat:mediaType": "text/csv",
      "dct:format": "http://publications.europa.eu/resource/authority/file-type/CSV",
      "spdx:checksum": {
        "spdx:algorithm": "SHA-256",
        "spdx:checksumValue": "7ad8add25d7a638322dd869f08b2fc7d64a4b12a3755c58ca9a10ee8646d78ea"
      }
    }
  ],
  "dcat:theme": [
    "http://vocab.datahub.kr/def/dcat-ap-kr/data-theme/INDUSTRY_EMPLOYMENT"
  ],
  "dcat:landingPage": "https://data.example.go.kr/dataset/biz-registry",
  "dcatkr:maintainer": {
    "@type": "foaf:Agent",
    "foaf:name": "예시기관 데이터관리팀"
  }
}

컬럼 설명의 dc:description은 외부 컨텍스트에서 dc 접두어를 선언한다는 전제에 따릅니다. 이 문서의 로컬 컨텍스트에는 해당 선언이 없습니다. 확인 중

이해 계층 — 2단계에서 더해지는 것 예시

같은 데이터를 측정한 결과를 이해 계층 속성으로 기록한 예시입니다. 이 예시는 운영 지침을 적용하지 않았습니다. 그래서 품질 등급(aird:qualityTier)과 임계 프로파일(판정 기준값, aird:thresholdProfile)이 비어 있습니다. 빈 값은 정상 결과입니다. 에이전트는 빈 값을 0점이 아니라 「판정하지 않음: 운영 지침 미적용」으로 해석합니다.

D5-03(통계적 타당성)은 제2부 부록 Ⅰ의 예시 패턴으로 잠정 측정했습니다. 그래서 측정 완성도(표준 용어: 진단 성숙도, DM)는 DM-0(잠정)입니다. 측정 완성도를 결정하는 절차는 판정 절차에 있습니다. 속성 표기는 표준에서 발행할 스키마가 확정되면 이에 맞춥니다.

{
  "@id": "https://data.example.go.kr/id/dataset/biz-registry/manifest/1.1.0",
  "dcat:previousVersion": "https://data.example.go.kr/id/dataset/biz-registry/manifest/1.0.0",
  "aird:lifecycleStatus": "http://vocab.datahub.kr/def/aird/lifecycle-status/Discoverable",
  "aird:dataType": "STRUCT",
  "dqv:computedOn": "https://data.example.go.kr/id/dataset/biz-registry",
  "prov:generatedAtTime": "2026-09-03",
  "aird:completenessScore": 1.0,
  "aird:validityScore": 1.0,
  "aird:uniquenessScore": 1.0,
  "aird:machineReadabilityScore": 1.0,
  "aird:diagnosticMaturity": "DM-0",
  "aird:qualityTier": null,
  "aird:thresholdProfile": null,
  "aird:diagnosticReport": {
    "@id": "https://data.example.go.kr/id/dataset/biz-registry/report/2026-09-03",
    "spdx:checksum": {
      "spdx:algorithm": "SHA-256",
      "spdx:checksumValue": "(결과서 파일의 SHA-256)"
    }
  },
  "rai:dataLimitations": [
    "폐업 신고 지연으로 closedFlag의 반영 시점이 실제 폐업 시점보다 늦을 수 있다"
  ]
}

차원 점수(aird:completenessScore 등)는 읽기 쉽게 줄여 쓴 표기입니다. 어휘표 v0.10.5는 차원 점수를 품질 측정(dqv:QualityMeasurement, 2.3.1 — D1~D7 각 1건)으로 기록합니다. 확인 중

검증된 사실 1건 예시 제안

진단으로 확인한 사실 1건을 측정값 1건으로 기재한 예입니다. 표준에서 이미 사용하는 DQV 어휘를 따릅니다. aird:targetColumn · aird:referenceStandard · aird:validUntil은 제안된 속성입니다.

{
  "@type": "dqv:QualityMeasurement",
  "dqv:isMeasurementOf": "aird:D2-02",
  "dqv:computedOn": "https://data.example.go.kr/id/dataset/biz-registry",
  "prov:generatedAtTime": "2026-09-03",
  "dqv:value": 0.997,
  "aird:targetColumn": "regionCode",
  "aird:referenceStandard": "행정표준코드 법정동 (버전 명시)",
  "aird:validUntil": "2026-12-03"
}

판독 방법은 판단별 필드와 처리, 속성 목록은 기재 항목에 있습니다. 스키마와 컨텍스트의 공개 현황은 개발 현황과 향후 공개에 있습니다.

팩 전체를 한 RDF 그래프로

팩의 JSON-LD 파일(마니페스트 · 컬럼 정의서 · 운용 파일 · 확인 지점 판정)을 하나의 RDF 그래프로 합치면 파일 경계를 넘는 참조가 드러납니다. 파일별 구성은 팩 구성과 배포 — 준비 상태별 필요한 파일에 있습니다.

팩 전체를 한 RDF 그래프로 — 파일 경계를 넘는 참조
팩 전체를 한 RDF 그래프로 — 파일 경계를 넘는 참조 팩의 JSON-LD 파일을 한 RDF 그래프로 합친 모습입니다. 상자 하나가 그 트리플을 기재한 파일이고, 점선이 파일 경계를 넘는 참조입니다. 에이전트는 이 그래프를 따라 데이터셋에서 판정 근거까지 이동합니다.출처: AIRD 정보 모델 v0.10.5 15페이지 · 누르면 원본 크기
최종 수정 · 2026-10-07오류 신고