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

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

쿼리 매개 변수 사용

Schema Registry은 리소스를 나열할 때 쿼리 매개 변수를 페이지에 사용하고 결과를 필터링하는 기능을 지원합니다.

노트

여러 쿼리 매개 변수를 결합할 때는 앰퍼샌드(&)로 구분해야 합니다.

호출

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

매개 변수 설명
start 나열된 결과를 시작할 위치를 지정합니다. 이 값은 목록 응답의 _page.next 속성에서 얻을 수 있으며, 다음 결과 페이지에 액세스하는 데 사용할 수 있습니다. _page.next 값이 null이면 사용할 수 있는 추가 페이지가 없습니다.
limit 반환된 리소스 수를 제한합니다. 예:limit=5은 5개의 리소스 목록을 반환합니다.
orderby 특정 속성별로 결과를 정렬합니다. 예:orderby=title은(는) 결과를 오름차순으로 정렬합니다(A-Z). 매개 변수 값(orderby=-title) 앞에 -을 추가하면 제목이 내림차순(Z-A)으로 항목을 정렬합니다.

필터링

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

연산자 설명
== 속성이 제공된 값과 같은지 여부를 기준으로 필터링합니다. property=title==test
!= 속성이 제공된 값과 동일하지 않은지 여부를 기준으로 필터링합니다. property=title!=test
< 속성이 제공된 값보다 작은지 여부를 기준으로 필터링합니다. property=version<5
> 속성이 제공된 값보다 큰지 여부를 기준으로 필터링합니다. property=version>5
<= 속성이 제공된 값보다 작거나 같은지의 여부에 따라 필터링합니다. property=version<=5
>= 속성이 제공된 값보다 크거나 같은지의 여부를 필터링합니다. property=version>=5
~ 속성이 제공된 정규 표현식과 일치하는지 여부를 기준으로 필터링합니다. property=title~test$
(None) 속성 이름만 입력하면 속성이 있는 항목만 반환됩니다. property=title

property 매개 변수를 사용하여 호환되는 클래스로 믹스를 필터링할 수 있습니다. 예를 들어 property=meta:intendedToExtend==https://ns.adobe.com/xdm/context/profile은 XDM Individual Profile 클래스와 호환되는 혼합만 반환합니다.

호환성 모드

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 호환성 모드
        {
          "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 예는 알고 따라야 하는 최상의 방법을 제공합니다.

이 페이지에서는

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now