스키마 레지스트리 API 안내서 부록

이 문서에서는 Schema Registry API 작업과 관련된 추가 정보를 제공합니다.

쿼리 매개 변수 사용 query

Schema Registry은(는) 리소스를 나열할 때 페이지 및 필터 결과를 쿼리 매개 변수로 사용할 수 있도록 지원합니다.

페이징 paging

페이징에 가장 일반적인 쿼리 매개 변수는 다음과 같습니다.

필터링 filtering

검색된 리소스 내의 특정 JSON 속성에 대해 특정 연산자를 적용하는 데 사용되는 property 매개 변수를 사용하여 결과를 필터링할 수 있습니다. 지원되는 연산자는 다음과 같습니다.

호환성 모드 compatibility

Experience Data Model (XDM)은 디지털 경험의 상호 운용성, 표현력 및 기능을 개선하기 위해 Adobe을 기반으로 하는, 공개적으로 문서화된 사양입니다. Adobe은 GitHub의 오픈 소스 프로젝트에서 소스 코드 및 공식 XDM 정의를 유지 관리합니다. 이러한 정의는 XDM 스키마를 정의하기 위한 문법으로 JSON-LD(연결된 데이터에 대한 JavaScript 개체 표기법) 및 JSON 스키마를 사용하여 XDM 표준 표기법으로 작성됩니다.

공개 저장소의 공식 XDM 정의를 보면 표준 XDM이 Adobe Experience Platform에 표시되는 것과 다르다는 것을 알 수 있습니다. Experience Platform에서 표시되는 항목을 호환 모드라고 하며 표준 XDM과 Platform 내에서 사용하는 방식 간에 간단한 매핑을 제공합니다.

호환성 모드 작동 방식

호환성 모드를 사용하면 의미 체계를 동일하게 유지하면서 표준 XDM 내에서 값을 변경하여 XDM JSON-LD 모델을 기존 데이터 인프라에서 작업할 수 있습니다. 중첩된 JSON 구조를 사용하여 스키마를 트리와 유사한 형식으로 표시합니다.

표준 XDM과 호환성 모드 간의 주요 차이점은 필드 이름에 대한 "xdm:" 접두사의 제거입니다.

다음은 표준 XDM과 호환성 모드 모두에서 생일 관련 필드("설명" 속성이 제거된)를 보여 주는 나란히 비교입니다. 호환성 모드 필드에는 "meta:xdmField" 및 "meta:xdmType" 속성의 XDM 필드 및 해당 데이터 유형에 대한 참조가 포함됩니다.

{
  "xdm:birthDate": {
    "title": "생일",
    "type": "string",
    "format": "date"
  },
  "xdm:birthDayAndMonth": {
    "title": "생일",
    "type": "string",
    "pattern": "[0-1][0-9]-[0-9][0-9]"
  },
  "xdm:birthYear": {
    "title": "Birth year",
    "type": "integer",
    "minimum": 1,
    "maximum": 32767
  }
}

{
  "birthDate": {
    "title": "생일",
    "type": "string",
    "format": "date",
    "meta:xdmField": "xdm:birthDate",
    "meta:xdmType": "date"
  },
  "birthDayAndMonth": {
    "title": "생일",
    "type": "string",
    "pattern": "[0-1][0-9]-[0-9][0-9]",
    "meta:xdmField": "xdm:birthDayAndMonth",
    "meta:xdmType": "string"
  },
  "birthYear": {
    "title": "Birth year",
    "type": "integer",
    "minimum": 1,
    "maximum": 32767,
    "meta:xdmField": "xdm:birthyear",
    "meta:xdmType": "short"
  }
}

호환성 모드가 필요한 이유는 무엇입니까?

Adobe Experience Platform은 여러 솔루션 및 서비스와 함께 작동하도록 설계되었으며, 각 솔루션에는 고유한 기술적 과제와 제한 사항(예: 특정 기술이 특수 문자를 처리하는 방법)이 있습니다. 이러한 한계를 극복하기 위하여 호환성 모드(Compatibility Mode)를 개발하였다.

Catalog, Data Lake 및 Real-Time Customer Profile을(를) 포함한 대부분의 Experience Platform 서비스는 표준 XDM 대신 Compatibility Mode을(를) 사용합니다. Schema Registry API도 Compatibility Mode을(를) 사용하며 이 문서의 예제는 모두 Compatibility Mode을(를) 사용하여 표시됩니다.

매핑은 표준 XDM과 Experience Platform에서 작동하는 방식 간에 수행되지만 Platform 서비스 사용에 영향을 주지 않아야 합니다.

공개 소스 프로젝트를 사용할 수 있지만 Schema Registry을(를) 통해 리소스와 상호 작용하는 경우 이 문서의 API 예는 알고 따라야 할 모범 사례를 제공합니다.