스키마 레지스트리 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](https://github.com/adobe/xdm/)의 오픈 소스 프로젝트에 소스 코드와 공식 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