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

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

쿼리 매개 변수 사용

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

페이징

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

필터링

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

호환성 모드

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

공용 리포지토리에서 공식 XDM 정의를 보면 표준 XDM이 Adobe Experience Platform에 표시되는 정의와 다르다는 것을 알 수 있습니다. Experience Platform에 표시되는 것을 호환성 모드라고 하며, 표준 XDM과 Platform 내에서 사용하는 방법 간의 간단한 매핑을 제공합니다.

호환성 모드 작동 방식

호환성 모드 를 사용하면 XDM JSON-LD 모델이 표준 XDM 내에서 값을 변경하여 기존 데이터 인프라와 함께 작업할 수 있고 동시에 의미 체계를 유지할 수 있습니다. 이 템플릿은 중첩된 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][0-9]"
  },
  "xdm:birthYear": {
    "title": "출생 연도"
    "type": "integer",
    "minimum": 1,
    "maximum": 32767
  }
}
  

{
  "firstDate": {
    "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": "출생 연도"
    "type": "integer",
    "minimum": 1,
    "maximum": 32767,
    "meta:xdmField": "xdm:birthYear",
    "meta:xdmType": "short"
  }
}
      

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

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

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 예는 알고 따라야 하는 모범 사례를 제공합니다.