SHACL 코드 형식 검수SHACL sh:pattern 전체 문자열SHACL 패턴 필수값 검수SHACL sh:flags 대소문자

SHACL 코드 형식 검수, 일부만 맞는 코드가 통과하는 이유

품목 코드에 SHACL sh:pattern을 적용할 때 부분 일치와 전체 형식을 구분합니다. 가상 입력 비교표와 Turtle 예제로 값 누락, 자료형, 끝의 단일 줄바꿈까지 확인합니다.

이 글을 쓴 알파카랩스카카오·네이버·쿠팡 출신, 재하청 0%, 대기업·공공기관 등 18개사+ 레퍼런스

발행 ·알파카랩스

2026년 11월, SHACL로 코드 전체를 검사하려면 패턴의 시작과 끝을 지정합니다. 필수 코드의 누락과 자료형에는 별도 제약을 둡니다.

입고 파일에서 코드 형식을 확인했는데 폐기 표기가 붙은 값이 품목 코드로 들어올 수 있습니다. 그래프에서 코드가 아예 빠진 품목까지 잡으려면 두 오류가 같은 검사에서 드러나는지 가상 표본으로 비교해 보세요.

왜 코드 일부만 일치해도 통과하나요?#

W3C SHACL 권고안의 sh:pattern은 각 값 노드의 문자열 표현을 SPARQL의 정규식으로 검사합니다. PK-[0-9]{4}는 문자열 중간에서도 일치합니다. ^PK-[0-9]{4}$는 기본 모드에서 전체 문자열의 시작과 끝을 기준으로 삼습니다. SPARQL REGEX와 XPath의 문자열 경계 규칙에서 확인할 수 있습니다.

  • 품목 코드가 있어야 하면 sh:minCount 1을 둡니다. 코드 속성이 빠지면 검사할 값 노드가 없으므로 패턴 제약만으로는 누락을 잡지 못합니다.
  • 문자열 리터럴을 계약으로 삼으면 sh:datatype xsd:string을 함께 둡니다. SHACL 패턴은 리터럴의 문자 표현 또는 IRI의 문자열 표현을 검사할 수 있습니다. 빈 노드는 패턴 위반입니다.
  • 대소문자를 구분할 때는 sh:flags "i"를 넣지 않습니다. 두 표기를 허용하기로 했다면 i가 붙은 셰이프로 소문자도 시험합니다. m을 켜면 시작과 끝이 각 줄에도 적용되므로 본문 안의 한 줄만 맞는 경우를 따로 확인합니다.

어떤 입력을 비교하면 차이가 드러나나요?#

가상 품목 A의 코드를 대문자 PK, 붙임표, ASCII 숫자 네 자리로 정했습니다. 이 셰이프는 코드가 하나 이상 존재하고 각 값이 문자열이며, 전체 패턴을 만족하고 최대 7글자인지 검사합니다. 표의 왼쪽 판정은 시작·끝 조건과 다른 제약을 뺀 PK-[0-9]{4}만 적용한 결과입니다. 별도의 데이터 그래프에서 ex:ItemA ex:itemCode "PK-0042" .의 값을 행별로 바꿉니다. 누락 행에서는 그 트리플을 넣지 않습니다.

가상 입력부분 일치 패턴만전체 코드 셰이프
정상 PK-0042적합적합
뒤에 -OLD가 붙은 값적합부적합 · 패턴·길이
앞에 OLD-가 붙은 값적합부적합 · 패턴·길이
소문자 pk-0042부적합부적합 · 패턴
같은 표기의 xsd:token적합부적합 · 자료형
빈 노드부적합부적합 · 패턴·자료형·길이
품목 코드 속성 누락적합부적합 · 최소 개수
끝에 LF 하나가 붙은 값적합부적합 · 길이
가상 RDF 입력 8건을 pySHACL 0.40.2와 RDFLib 7.6.0에서 2026년 11월 17일 비교했습니다.
@prefix ex: <https://example.org/demo/> .
@prefix sh: <http://www.w3.org/ns/shacl#> .
@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .

ex:ItemCodeShape a sh:NodeShape ;
  sh:targetNode ex:ItemA ;
  sh:property [
    sh:path ex:itemCode ;
    sh:minCount 1 ;
    sh:datatype xsd:string ;
    sh:pattern "^PK-[0-9]{4}$" ;
    sh:maxLength 7
  ] .

시작과 끝을 지정했는데 왜 길이까지 확인하나요?#

공식 경계 규칙에서 m을 지정하지 않은 $는 전체 문자열 끝을 뜻합니다. pySHACL 0.40.2에서 시작과 끝을 지정한 패턴만 적용했을 때 맨 끝에 LF(U+000A) 하나를 붙인 값이 적합으로 관측됐습니다. 7글자를 넘는 값은 최대 길이 제약으로 부적합이 됐습니다. 실제 적재에 쓰는 검증기와 버전으로 줄바꿈·공백 표본을 시험해야 하는 이유입니다.

빈 문자열은 그래프에 값이 하나 있으므로 위 예에서는 최소 개수를 만족하고 패턴에서 부적합입니다. 코드가 없는 품목과 오류 값이 들어온 품목은 조치가 다릅니다. 원천에서 앞뒤 공백을 정리하기로 했다면 정리 전후의 값을 함께 남기고 중복이 생기는지 확인합니다. 형식이 적합해도 그 코드가 원장에 등록됐는지는 별도 대사로 확인합니다.

어떤 문서와 서비스 범위를 확인했나요?#

위 코드는 2017년 7월 20일 공개된 SHACL 권고안의 제약을 씁니다. 2026년 11월 16일 공개된 SHACL 1.2 Core 작업 초안에서도 패턴과 플래그의 설명을 대조했습니다. 두 문서의 확인일은 2026년 11월 17일입니다.

알파카랩스의 온톨로지 구축 서비스는 원천 매핑·식별 기준과 샘플 검수를 협의한다고 안내합니다. 그래프 관계의 유형은 참조 타입 검수, 정규화 뒤 서로 다른 코드가 합쳐지는지는 SCM 품목 코드 정규화 검수에서 확인할 수 있습니다.

자주 묻는 질문#

SHACL sh:pattern에 시작과 끝을 꼭 넣어야 하나요?

코드 전체를 맞추려면 시작과 끝을 지정합니다. 문자열 안에 특정 문구가 있기만 하면 되는 검사에서는 부분 일치 패턴을 사용할 수 있습니다.

품목 코드가 없는데 sh:pattern은 왜 통과하나요?

패턴 제약은 존재하는 값에 적용됩니다. 필수 속성은 sh:minCount 1을 함께 두어 값이 없는 경우를 잡습니다.

코드가 소문자여도 적합하도록 할 수 있나요?

sh:flags에 i를 넣으면 대소문자를 무시합니다. 입력 계약에서 두 표기를 허용할 때 사용하고, 저장 전 대문자 변환이나 원장 매칭은 별도로 검수합니다.

자료형이 달라도 패턴은 맞을 수 있나요?

패턴은 값의 문자열 표현을 검사합니다. xsd:string만 받으려면 sh:datatype으로 자료형을 따로 점검합니다.

형식에 맞는 코드는 바로 원장과 연결해도 되나요?

형식 검사는 코드 표기를 확인합니다. 원장 연결 전에는 코드가 등록돼 있는지, 같은 코드가 여러 품목을 가리키는지 확인합니다.

인수 검수표에 무엇을 남기나요?#

코드 형식의 인수 기준을 정리합니다

첫 범위 협의에서 비식별 코드 표본을 대조해 정상·누락·형식 위반의 기대 판정표 초안을 정리합니다. 소요 시간은 원천과 표본 범위를 확인한 뒤 협의합니다.

코드 형식 검수표 초안 협의