JSON-LD @protected 검수, 상태 필드의 뜻이 바뀔 때

JSON-LD에서 @protected는 용어 정의를 지킵니다. 속성에 붙인 컨텍스트는 그 범위에서 정의를 바꿀 수 있습니다. 2026년 11월 11일 기준입니다.

주문과 배송 시스템이 모두 status라는 키를 쓴다고 해 보겠습니다. 주문의 confirmed와 배송의 packed는 각각 다른 속성에 속합니다. JSON 문법 검사를 통과해도 지식그래프에서 둘을 같은 속성으로 읽을 수 있습니다. JSON-LD를 확장해서 주문의 상태와 배송의 상태가 어느 IRI로 나오는지 확인합니다.

보호된 용어는 언제 오류가 나나요?#

JSON-LD 컨텍스트는 짧은 키를 지식그래프에서 쓰는 IRI와 값의 해석 방식에 연결합니다. 용어 정의에 @protected: true를 두면 이후 일반 컨텍스트에서 다른 정의로 재정의할 때 확장 오류가 납니다. IRI가 같더라도 값 해석을 일반 문자열에서 IRI로 바꾸는 정의는 다릅니다. 보호 플래그를 제외한 정의가 동일하면 반복해도 처리할 수 있고 기존 보호가 유지됩니다. W3C 보호된 용어 설명 · W3C 용어 정의 알고리즘

속성의 용어 정의에 붙인 컨텍스트는 해당 속성의 값에 적용됩니다. 표준은 이 속성 범위 컨텍스트에서 보호된 용어를 바꿀 수 있도록 합니다. 아래 예시에서는 문서 상위의 status가 주문 상태로, delivery 아래의 status가 배송 상태로 확장됩니다. 새 매핑을 어디에서 허용할지 정하고 해당 위치의 결과를 따로 검수합니다. W3C 확장 알고리즘

주문과 배송의 상태를 어떻게 검수하나요?#

가상 표본의 주문·배송 IRI는 아래 JSON에 나옵니다. 인수표에는 입력 위치, 적용 컨텍스트, 기대 IRI 또는 오류 코드, 적재 여부를 각각 적습니다.

아래는 마지막 행에 사용한 가상 입력입니다. delivery의 용어 정의 안에 컨텍스트가 있어 이 예시에서는 그 값인 배송 객체에 배송 상태 매핑을 적용합니다.

{
  "@context": {
    "@version": 1.1,
    "status": {
      "@id": "https://example.test/order/status",
      "@protected": true
    },
    "delivery": {
      "@id": "https://example.test/order/delivery",
      "@context": {
        "status": "https://example.test/shipping/status"
      }
    }
  },
  "status": "confirmed",
  "delivery": { "status": "packed" }
}

원본과 매핑을 함께 검수할 때는 확장된 속성 IRI를 비교합니다. 상위 주문의 상태가 배송 IRI로 펼쳐지거나 오류가 나야 할 입력이 통과하면 적재를 보류하고 적용 컨텍스트를 확인합니다. 파서, 컨텍스트 또는 원천 매핑이 바뀌면 같은 입력을 다시 시험합니다.

같은 키를 허용하는 편이 나은 때는 언제인가요?#

상위 주문과 하위 배송이 독립적으로 정의된 데이터라면 같은 짧은 키를 유지하면서 속성 범위를 둘 수 있습니다. 관리하는 쪽에서 필드 이름까지 바꿀 수 있다면 서로 다른 이름을 쓰는 방법도 있습니다. 표의 속성 범위처럼 합의한 예외가 있는지와 실제 확장 결과가 맞는지 먼저 확인합니다.

보호된 용어가 올바르게 확장되면 다음으로 상태값이 허용된 업무 값인지, 필수 속성이 있는지 확인합니다. 적용 대상과 검사 결과를 대조하는 방법은 SHACL 검증 대상 확인에서 다룹니다.

어떤 문서에서 기준을 확인했나요?#

• W3C JSON-LD 1.1과 처리 알고리즘은 보호 정의와 속성 범위에서의 적용을 설명합니다. 2020년 7월 16일 권고.
• W3C Linked Web Storage Protocol 작업 초안은 보호 컨텍스트를 사용하는 프로토콜을 제안합니다. 2026년 6월 5일 고정 작업 초안이며, 위 표의 판정에는 JSON-LD 1.1 권고를 적용했습니다.
• 알파카랩스 온톨로지 구축·컨설팅은 원천 매핑, 출처와 권한, 운영 인수 조건을 협의하는 서비스를 안내합니다.

공개 문서는 2026년 11월 11일 확인했습니다. 표는 외부 컨텍스트를 불러오지 않는 가상 입력의 확장 결과입니다.

자주 묻는 질문#

컨텍스트 매핑의 인수 범위를 정할 때#