SHACL 목록 겹침 검수, 같은 배치에 포함과 제외가 충돌할 때
SHACL sh:disjoint로 같은 배치의 검토 포함·제외 목록 겹침을 확인합니다. 빈 목록, 동일 표시명, 다른 배치의 같은 품목을 가상 표본으로 검수합니다.
이 글을 쓴 알파카랩스카카오·네이버·쿠팡 출신, 재하청 0%, 대기업·공공기관 등 18개사+ 레퍼런스
같은 배치의 포함·제외 목록에서 같은 RDF 항을 찾으려면 sh:disjoint를 씁니다. 겹친 값마다 위반이 기록됩니다.
2026년 11월 16일 확인 기준입니다. ERP에서 가져온 품목을 검토 명단에 넣고 현장 목록에서 제외 대상을 가져왔다고 가정합니다. 목록별 개수만 보면 같은 품목이 양쪽에 들어간 충돌을 놓칠 수 있습니다.
sh:disjoint는 어떤 두 값을 비교하나요?#
배치를 검증 대상으로 지정하고, 포함 속성의 값 집합을 같은 배치의 제외 속성 값과 비교합니다. 두 집합에 모두 들어 있는 RDF 항마다 검증 결과가 생기며, 겹친 값은 sh:value에 기록됩니다. W3C SHACL 권고의 sh:disjoint
가상 셰이프는 BatchA와 BatchB를 각각 검사합니다. BatchA의 포함과 BatchB의 제외에 같은 품목이 있어도, 각 배치 안에서 값이 겹치지 않으면 이 제약을 통과합니다.
@prefix ex: <https://example.org/> .
@prefix sh: <http://www.w3.org/ns/shacl#> .
ex:BatchShape a sh:NodeShape ;
sh:targetNode ex:BatchA, ex:BatchB ;
sh:property [
sh:path ex:includeItem ;
sh:disjoint ex:excludeItem
] .
검증 보고서를 어떤 표본으로 대조하나요?#
보고서의 sh:focusNode는 어느 배치인지, sh:value는 어느 값이 겹쳤는지 보여줍니다. 아래 표는 왼쪽에서 포함을, 오른쪽에서 제외를 읽습니다. A와 B는 품목 IRI의 약칭입니다.
| 가상 입력 | 포함·제외에서 보는 값 | 검증 결과 |
|---|---|---|
| 목록이 겹치지 않음 | A / B | 적합 |
| 한 품목이 겹침 | A / A | 위반 A |
| 두 품목이 겹침 | A와 B / A와 B | 위반 A와 B |
| 포함만 있음 | A / 비어 있음 | 적합 |
| 제외만 있음 | 비어 있음 / A | 적합 |
| 두 목록이 비어 있음 | 비어 있음 / 비어 있음 | 적합 |
| 같은 표시명, 다른 IRI | 표시명이 같은 A / B | 적합 |
| 같은 품목, 다른 배치 | BatchA에 포함 A, BatchB에 제외 A | 적합 |
두 목록이 비어도 적합이면 어떻게 하나요?#
sh:disjoint는 두 목록의 겹침을 검사합니다. 포함 목록에 품목이 반드시 있어야 한다면 해당 속성에 sh:minCount를 함께 둡니다. 배치가 검증 대상에 잡혔는지는 SHACL 검증 대상 누락 검수 기준으로도 확인합니다.
출처마다 같은 물건에 다른 IRI를 쓰면 겹침이 없다고 나올 수 있습니다. 현업이 같은 품목으로 확인한 경우에는 공통 식별자 매핑을 적용한 그래프를 다시 검증합니다. 두 목록이 서로 일치해야 하는 경우에는 SHACL 집합 일치 검수의 기준을 씁니다.
어떤 표준과 서비스 범위를 확인했나요?#
2017년 7월 20일 W3C 권고에서는 비교 대상을 직접 속성 IRI로 지정합니다. 2026년 11월 10일 SHACL 1.2 Core 작업 초안은 비교 측을 SHACL 속성 경로로 설명합니다. 2026년 11월 16일 두 문서를 확인했고, 예제는 권고의 직접 속성으로 실행했습니다. 이용 중인 검증기의 버전이나 경로 설정이 바뀌면 같은 표본을 다시 확인합니다. SHACL 1.2 Core 작업 초안
알파카랩스는 공개 온톨로지 구축 서비스에서 원천 필드 변환, 공통 식별자, 충돌의 검수·보류 기준을 협의한다고 안내합니다. 표의 배치와 품목은 설계 예시입니다. 온톨로지 구축·컨설팅·개발
자주 묻는 질문#
한 품목이 양쪽에 있으면 보고서에 무엇이 나오나요?
같은 배치에서 겹친 품목은 검증 결과의 sh:value로 확인합니다. 배치 정보는 sh:focusNode로 확인합니다.
두 목록에 같은 표시명이 있으면 위반인가요?
예제의 값은 품목 IRI입니다. 표시명이 같아도 IRI가 다르면 겹친 값으로 보고하지 않습니다.
같은 품목이 다른 배치에 있어도 위반인가요?
이 제약은 배치별로 비교합니다. 여러 배치를 통틀어 배제할 조건이 필요하면 별도의 검사 범위를 정의합니다.
포함 목록이나 제외 목록이 비면 통과하나요?
두 목록이 공유하는 값이 없으면 이 제약을 통과합니다. 목록이 꼭 있어야 한다면 그 속성에 최소 개수 제약을 둡니다.
sh:equals와 sh:disjoint를 언제 사용하나요?
두 목록이 같은 값으로 구성돼야 하면 sh:equals를 사용합니다. 공통 값이 없어야 하면 sh:disjoint를 사용합니다.
목록 인수표는 어떻게 준비하나요?#
배치 식별자, 포함·제외 품목 IRI, 겹칠 때 기대하는 보고서 값을 비식별 표본에 적습니다. 한쪽이 비거나 같은 표시명을 가진 다른 품목이 들어오는 경우까지 포함하면 변환 규칙과 검증 결과를 함께 확인할 수 있습니다.
목록 겹침의 인수 기준을 정리합니다
첫 범위 협의에서 비식별 목록과 기대 판정으로 목록 겹침 검수표 초안을 정리합니다. 소요 시간은 데이터 원천과 배치 범위를 확인한 뒤 협의합니다.
목록 겹침 검수표 초안 협의