스키마 레지스트리 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 및 호환성 모드 모두에서 생일 관련 필드("description" 속성이 제거됨)를 보여주는 간단한 비교를 나란히 나타낸 것입니다. 호환성 모드 필드에는 "meta:xdmField" 및 "meta:xdmType" 속성에 XDM 필드 및 해당 데이터 유형에 대한 참조가 포함되어 있습니다.

        {
          "xdm:birthDate":{
              "title":"생년월일",
              "type":"string",
              "format":"date",
          },
          "xdm:birthDayAndMonth":{
              "title":"생년월일",
              "type":"string",
              "패턴":"[0-1][0-9]-[0-9][0-9]",
          },
          "xdm:birthYear":{
              "title":'탄생년'
              "type":"integer",
              "최소":1,
              "maximum":32767
        }
  

        {
          "생년월일":{
              "title":"생년월일",
              "type":"string",
              "format":"date",
              "meta:xdmField":"xdm:birthDate",
              "meta:xdmType":"date"
          },
          "birthDayAndMonth":{
              "title":"생년월일",
              "type":"string",
              "패턴":"[0-1][0-9]-[0-9][0-9]",
              "meta:xdmField":"xdm:birthDayAndMonth",
              "meta:xdmType":"string"
          },
          "탄생년":{
              "title":'탄생년'
              "type":"integer",
              "최소":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 예는 알고 따라야 하는 최상의 방법을 제공합니다.