보건의료 데이터 포털을 위한 응용 프로파일 (HealthDCAT-KR)

HealthDCAT-KR은 대한민국 보건의료데이터 중개 포털(이하 중개포털)에서 제공하는 데이터세트를 의미적으로 일관되게 기술하기 위한 DCAT 응용 프로파일이다. RDF 기반 메타데이터 어휘를 이용하여 데이터 카탈로그와 데이터세트를 기술하기 위한 메타데이터 요소를 필수요소와 권장요소로 정의한다. 또한 DCAT-AP 기반 대한민국 메타데이터 표준과 HealthDCAT-AP를 기반으로 서로 다른 데이터 포털에서 사용되는 메타데이터를 공통 메타데이터 요소로 표현함으로써 데이터세트 간 상호운용성을 지원한다. 본 설명서의 각 속성 요구 수준은 중개포털 기준으로 표기한다.

HealthDCAT-KR defines the RDF vocabulary of a DCAT application profile for the Korean Healthcare Data Portal. It specifies mandatory and recommended metadata elements for data catalogs and datasets. Based on the Korean National Metadata Standard and HealthDCAT-AP, it establishes a common metadata model across heterogeneous data portals, thereby supporting dataset interoperability and enabling integrated discovery and reuse. This specification defines the requirement level of each property for the Korean Health Data Brokerage Portal.

Introduction

개요 (Overview)

대한민국의 보건의료 데이터 중개 포털을 위한 HealthDCAT 응용 프로파일(이하 HealthDCAT-KR)은 보건의료데이터 중개 포털에서 제공하는 보건의료 데이터셋을 기술하기 위한 메타데이터 명세(metadata specification)이다. HealthDCAT-KR은 「데이터 카탈로그 표준가이드」를 기반으로 HealthDCAT-AP의 보건의료 특화 속성을 반영하여 국가 데이터 통합플랫폼(One-윈도우) 및 유럽연합의 보건의료 데이터 2차 활용 플랫폼(가칭 HealthData@EU)과의 연계성을 고려해 확장한 응용 프로파일이다. 적용 대상은 공공기관, 의료기관, 연구기관 등이 생산 또는 관리하는 보건의료 데이터 중 연구 활용 가치가 있는 데이터셋으로, 이를 통합 검색하고 연계·활용할 수 있도록 기술하는 것을 목적으로 한다.

적용 범위 및 지원 도구 (Scope and supporting tools)

[[HealthDCAT-AP]]는 명세 문서와 함께 데이터 보유기관의 메타데이터 작성을 지원하는 별도의 도구를 제공하고 있다. HealthDCAT-KR 또한 명세 문서만으로는 실제 메타데이터 작성이 어렵다는 점을 고려하여, 국내 중개 포털 환경에 맞춘 작성 도구를 함께 제공한다.

HealthDCAT-KR Dataset Description Assistant (메타데이터 생성 도구)

HealthDCAT-KR Dataset Description Assistant는 데이터 보유기관이 본 명세에 부합하는 데이터세트 메타데이터를 작성하고 RDF로 내보낼 수 있도록 지원하는 웹 기반 도구이다. 별도의 설치나 계정 없이 브라우저에서 바로 사용하며, 입력값의 처리와 파일 생성이 모두 사용자의 브라우저 안에서 이루어지므로 작성 중인 메타데이터가 외부로 전송되지 않는다.

작성 방식	데이터세트 1건을 항목별로 채우는 직접 입력과, 배포된 양식(.xlsx)에 여러 건을 채워 한 번에 올리는 엑셀 일괄 등록의 두 가지를 지원한다. 두 방식의 산출물은 동일하다.
산출물	데이터세트(`dcat:Dataset`)와 배포 형식(`dcat:Distribution`)은 서로 다른 클래스이므로 데이터세트 1건당 두 개의 파일로 생성되며, 배포 파일은 `dct:isPartOf`로 데이터세트와 연결된다. 엑셀 일괄 등록 시에는 데이터세트 식별자를 기준으로 여러 건의 배포가 하나의 데이터세트에 묶인다.
직렬화 형식	JSON-LD(`.jsonld`), Turtle(`.ttl`), RDF/XML(`.rdf`)의 세 가지 형식으로 내보낼 수 있으며, 내려받기 전에 화면에서 결과를 미리 확인할 수 있다.
항목 구성	데이터세트 26개 항목(필수 6 / 권장 20)과 배포 형식 5개 항목(필수 1 / 권장 4)으로 구성된다. 각 항목에는 요구 수준 배지가 표시되며, 필수 항목만 골라서 먼저 작성할 수 있다.
검증	비어 있는 필수 항목과 형식이 어긋난 값(URL, 이메일)을 표시한다. 직접 입력에서는 항목 단위로, 엑셀 일괄 등록에서는 행 단위로 오류를 확인할 수 있다.
언어 태그	제목·설명 등 문자열 항목에는 선택한 기본 언어에 따라 `@ko` 또는 `@en` 언어 태그가 자동으로 부여된다.

도구가 적용하는 필수·권장 구분은 본 명세의 모델링 원칙에 따라 HealthDCAT-AP의 제한(Restricted) 권한 기준을 준용하며, 각 속성의 정의와 요구 수준은 Vocabulary specification을 따른다.

접두사	네임스페이스 IRI
`dcat`	http://www.w3.org/ns/dcat#
`dct`	http://purl.org/dc/terms/
`dcatap`	http://data.europa.eu/r5r/
`healthdcatap`	http://healthdataportal.eu/ns/health#
`adms`	http://www.w3.org/ns/adms#
`dpv`	https://w3id.org/dpv#
`dqv`	http://www.w3.org/ns/dqv#
`foaf`	http://xmlns.com/foaf/0.1/
`ndi`	http://ndi.example/ns#

Vocabulary specification

HealthDCAT-KR은 HealthDCAT-AP에 정의되지 않은 속성을 추가하고, 중개 포털의 메타데이터에 맞는 통제 어휘를 정의한다.

Class: Catalog (카탈로그)

Property: title

RDF 속성명	`dct:title`
라벨	제목
설명	카탈로그에 지정된 이름
요구 수준	필수 (중개포털)

Property: description

RDF 속성명	`dct:description`
라벨	설명
설명	카탈로그에 대한 설명
요구 수준	필수 (중개포털)

Property: publisher

RDF 속성명	`dct:publisher`
라벨	발행기관
설명	데이터를 게재하여 제공하는 기관/단체(플랫폼 사업자번호)의 정보
요구 수준	필수 (중개포털)

Property: dataset

RDF 속성명	`dcat:dataset`
라벨	데이터셋
설명	카탈로그에 나열된 데이터 집합
요구 수준	권장 (중개포털)

Property: homepage

RDF 속성명	`foaf:homepage`
라벨	홈페이지
설명	카탈로그의 기본 페이지 역할을 하는 웹 페이지를 참조
요구 수준	권장 (중개포털)

Property: language

RDF 속성명	`dct:language`
라벨	언어
설명	카탈로그에 있는 데이터셋의 메타데이터에 사용되는 언어(ISO 639-1 참조)
요구 수준	권장 (중개포털)

Property: license

RDF 속성명	`dct:license`
라벨	라이선스
설명	카탈로그를 사용하거나 재사용할 수 있는 라이선스 표시
요구 수준	권장 (중개포털)

Property: issued

RDF 속성명	`dct:issued`
라벨	최초 발행일
설명	카탈로그를 플랫폼에 등록한 일자 (초기 등록 후 변경 금지)
요구 수준	권장 (중개포털)

Property: modified

RDF 속성명	`dct:modified`
라벨	최근 수정일
설명	카탈로그가 수정된 가장 최근 날짜 기입
요구 수준	권장 (중개포털)

Property: spatial

RDF 속성명	`dct:spatial`
라벨	지리적 범위
설명	카탈로그에 포함된 지리적 범위 표시
요구 수준	권장 (중개포털)

Property: themeTaxonomy

RDF 속성명	`dcat:themeTaxonomy`
라벨	분류체계
설명	카탈로그의 데이터셋이 카탈로그 분류체계의 어떤 항목에 속해있는지 표시 (부록: 분류체계 참고)
요구 수준	권장 (중개포털)

Property: service

RDF 속성명	`dcat:service`
라벨	서비스
설명	데이터 카탈로그가 제공하는 서비스를 나타내는 속성
요구 수준	권장 (중개포털)

Class: Dataset (데이터셋)

Property: title

RDF 속성명	`dct:title`
라벨	제목
설명	데이터셋의 이름을 기입
요구 수준	필수 (중개포털)

Property: description

RDF 속성명	`dct:description`
라벨	설명
설명	데이터셋의 설명 기입
요구 수준	필수 (중개포털)

Property: theme

RDF 속성명	`dcat:theme`
라벨	주제
설명	데이터셋의 카테고리를 참조. 데이터셋은 여러 테마와 연결 가능
요구 수준	필수 (중개포털)

Property: accessRights

RDF 속성명	`dct:accessRights`
라벨	접근 권한
설명	데이터에 대한 접근권한 기입
요구 수준	필수 (중개포털)

Property: identifier

RDF 속성명	`dct:identifier`
라벨	식별자
설명	플랫폼에서 관리하는 데이터셋의 중복되지 않는 고유 식별자 기입
요구 수준	필수 (중개포털)

Property: identifier

RDF 속성명	`adms:identifier`
라벨	보조식별자
설명	MAST/ADS, DataCite, DOI, EZID 또는 W3ID와 같은 데이터셋의 보조 식별자 기입
요구 수준	필수 (중개포털)

Property: contactPoint

RDF 속성명	`dcat:contactPoint`
라벨	담당자 연락처
설명	데이터셋 담당자에 대한 연락처 정보를 기입
요구 수준	권장 (중개포털)

Property: keyword

RDF 속성명	`dcat:keyword`
라벨	키워드
설명	상품을 설명할 수 있는 대표 키워드 기입
요구 수준	권장 (중개포털)

Property: publisher

RDF 속성명	`dct:publisher`
라벨	발행기관
설명	데이터를 게재하여 제공하는 기관(플랫폼 사업자번호)의 정보 기입
요구 수준	권장 (중개포털)

Property: distribution

RDF 속성명	`dcat:distribution`
라벨	배포방식
설명	데이터셋의 배포 방식을 기입
요구 수준	필수 (중개포털)

Property: spatial

RDF 속성명	`dct:spatial`
라벨	지리적 범위
설명	데이터셋에서 다루는 지리적 지역
요구 수준	권장 (중개포털)

Property: temporal

RDF 속성명	`dct:temporal`
라벨	기간
설명	데이터셋에서 다루는 기간
요구 수준	권장 (중개포털)

Property: hasPurpose

RDF 속성명	`dpv:hasPurpose`
라벨	목적
설명	데이터 수집 또는 생성의 목적 및 활용 의도
요구 수준	권장 (중개포털)

Property: populationCoverage

RDF 속성명	`healthdcatap:populationCoverage`
라벨	인구범위
설명	데이터가 포함하는 대상 인구 집단 범위
요구 수준	권장 (중개포털)

Property: numberOfUniqueIndividuals

RDF 속성명	`healthdcatap:numberOfUniqueIndividuals`
라벨	고유 개인 수
설명	데이터에 포함된 고유 환자(개인) 수
요구 수준	권장 (중개포털)

Property: numberOfRecords

RDF 속성명	`healthdcatap:numberOfRecords`
라벨	전체 데이터 행 개수
설명	전체 데이터 레코드(행) 개수
요구 수준	권장 (중개포털)

Property: maxTypicalAge

RDF 속성명	`healthdcatap:maxTypicalAge`
라벨	최대 연령
설명	데이터 대상자의 일반적인 최대 연령
요구 수준	권장 (중개포털)

Property: minTypicalAge

RDF 속성명	`healthdcatap:minTypicalAge`
라벨	최소 연령
설명	데이터 대상자의 일반적인 최소 연령
요구 수준	권장 (중개포털)

Property: hasPersonalData

RDF 속성명	`dpv:hasPersonalData`
라벨	개인정보 포함 여부
설명	개인정보 포함 여부 또는 개인정보 수준
요구 수준	권장 (중개포털)

Property: hasLegalBasis

RDF 속성명	`dpv:hasLegalBasis`
라벨	법적 근거
설명	데이터 수집·처리의 법적 근거
요구 수준	권장 (중개포털)

Property: retentionPeriod

RDF 속성명	`healthdcatap:retentionPeriod`
라벨	데이터 보관 기간
설명	데이터 보관 기간
요구 수준	권장 (중개포털)

Property: publisher

RDF 속성명	`dct:publisher`
라벨	데이터 관리기관
설명	데이터를 보유·관리하는 기관
요구 수준	권장 (중개포털)

Property: hasCodingSystem

RDF 속성명	`healthdcatap:hasCodingSystem`
라벨	코딩 체계
설명	사용된 의료 코드 체계 (예: ICD, SNOMED 등)
요구 수준	권장 (중개포털)

Property: healthTheme

RDF 속성명	`healthdcatap:healthTheme`
라벨	보건의료 주제
설명	보건의료 주제 분류
요구 수준	권장 (중개포털)

Property: hasCodeValues

RDF 속성명	`healthdcatap:hasCodeValues`
라벨	코드 값
설명	코딩시스템의 코드 값 목록 또는 코드 정의 정보
요구 수준	권장 (중개포털)

Property: hasQualityAnnotation

RDF 속성명	`dqv:hasQualityAnnotation`
라벨	품질 정보
설명	데이터 품질에 대한 설명 또는 평가 정보
요구 수준	권장 (중개포털)

Class: Data Service (데이터서비스)

Property: title

RDF 속성명	`dct:title`
라벨	제목
설명	데이터 서비스에 지정된 상품명을 기입
요구 수준	필수 (중개포털)

Property: endpointURL

RDF 속성명	`dcat:endpointURL`
라벨	API 접근 URL
설명	서비스(IRI)의 루트 위치 또는 기본 엔드포인트
요구 수준	필수 (중개포털)

Property: endpointDescription

RDF 속성명	`dcat:endpointDescription`
라벨	API 사용 설명
설명	작업, 매개 변수 등을 포함하여 엔드포인트를 통해 사용할 수 있는 서비스 설명란으로 실제 엔드포인트 인스턴스에 대한 특정 세부 정보 제공
요구 수준	권장 (중개포털)

Property: servesDataset

RDF 속성명	`dcat:servesDataset`
라벨	서비스 데이터셋
설명	데이터 서비스가 배포할 수 있는 데이터셋을 기입
요구 수준	권장 (중개포털)

Class: Distribution (배포)

Property: description

RDF 속성명	`dct:description`
라벨	설명
설명	배포의 설명을 기입
요구 수준	권장 (중개포털)

Property: accessURL

RDF 속성명	`dcat:accessURL`
라벨	접근 URL
설명	데이터셋의 배포에 대한 액세스 권한을 제공하는 URL 포함되며, 액세스 URL 리소스에는 데이터셋을 가져오는 방법에 대한 정보 포함
요구 수준	필수 (중개포털)

Property: availability

RDF 속성명	`dcatap:availability`
라벨	가용성
설명	데이터셋이나 자원의 사용 가능성에 대한 상태 표현(available/unavailable)
요구 수준	권장 (중개포털)

Property: format

RDF 속성명	`dct:format`
라벨	형식
설명	메타데이터에서 리소스의 물리적 또는 매체유형(MIME Type)을 식별
요구 수준	권장 (중개포털)

Property: license

RDF 속성명	`dct:license`
라벨	라이선스
설명	데이터셋 배포를 할 수 있는 라이센스를 기입
요구 수준	권장 (중개포털)

Class: Catalog Record (카탈로그 레코드)

Property: modified

RDF 속성명	`dct:modified`
라벨	최근 수정일
설명	카탈로그 항목이 변경되거나 수정된 가장 최근 날짜가 포함
요구 수준	필수 (중개포털)

Property: issued

RDF 속성명	`dct:issued`
라벨	최초 발행일
설명	카탈로그에 포함된 데이터셋의 생성일자를 기입
요구 수준	권장 (중개포털)

Property: conformsTo

RDF 속성명	`dct:conformsTo`
라벨	준수 표준
설명	데이터셋의 메타데이터가 준수하는 응용 프로그램 프로필을 참조
요구 수준	권장 (중개포털)

Property: status

RDF 속성명	`adms:status`
라벨	상태
설명	데이터셋 및 데이터 서비스 설명이 편집·관리되는 과정에서 해당 카탈로그 레코드의 상태를 의미
요구 수준	권장 (중개포털)

Class: Data Product (데이터상품)

Property: viewCnt

RDF 속성명	`ndi:viewCnt`
라벨	조회수
설명	조회수
요구 수준	필수 (중개포털)

Property: downloadCnt

RDF 속성명	`ndi:downloadCnt`
라벨	다운로드 횟수
설명	다운로드 횟수
요구 수준	필수 (중개포털)

Property: pltfrmAccessToken

RDF 속성명	`ndi:pltfrmAccessToken`
라벨	연계 인증키
설명	기관간 연계를 위한 식별키를 기입(NDI 가입 이후 TOKEN값)
요구 수준	필수 (중개포털)

Property: srvcType

RDF 속성명	`ndi:srvcType`
라벨	서비스 유형
설명	데이터를 제공하거나 처리하는 서비스 유형을 기입(dataset, dataservice)
요구 수준	필수 (중개포털)

Introduction

개요 (Overview)

적용 범위 및 지원 도구 (Scope and supporting tools)

HealthDCAT-KR Dataset Description Assistant (메타데이터 생성 도구)

모델링 원칙

HealthDCAT-KR의 온톨로지 모델

Namespace

Terminology

Vocabulary specification

Class: Catalog (카탈로그)

Property: title

Property: description

Property: publisher

Property: dataset

Property: homepage

Property: language

Property: license

Property: issued

Property: modified

Property: spatial

Property: themeTaxonomy

Property: service

Class: Dataset (데이터셋)

Property: title

Property: description

Property: theme

Property: accessRights

Property: identifier

Property: identifier

Property: contactPoint

Property: keyword

Property: publisher

Property: distribution

Property: spatial

Property: temporal

Property: hasPurpose

Property: populationCoverage

Property: numberOfUniqueIndividuals

Property: numberOfRecords

Property: maxTypicalAge

Property: minTypicalAge

Property: hasPersonalData

Property: hasLegalBasis

Property: retentionPeriod

Property: publisher

Property: hasCodingSystem

Property: healthTheme

Property: hasCodeValues

Property: hasQualityAnnotation

Class: Data Service (데이터서비스)

Property: title

Property: endpointURL

Property: endpointDescription

Property: servesDataset

Class: Distribution (배포)

Property: description

Property: accessURL

Property: availability

Property: format

Property: license

Class: Catalog Record (카탈로그 레코드)

Property: modified

Property: issued

Property: conformsTo

Property: status

Class: Data Product (데이터상품)

Property: viewCnt

Property: downloadCnt

Property: pltfrmAccessToken

Property: srvcType

References

Informative references