XDM 필드 유형 제약 조건

XDM(경험 데이터 모델) 스키마에서 필드 유형은 필드에 포함될 수 있는 데이터 종류를 제한합니다. 이 문서에서는 매핑할 수 있는 다른 일련화 형식과 다양한 제약 조건을 적용하기 위해 API에서 고유한 필드 유형을 정의하는 방법을 포함하여 각 코어 필드 유형에 대한 개요를 제공합니다.

시작하기

이 안내서를 사용하기 전에 다음을 검토하십시오. 스키마 컴포지션 기본 사항 XDM 스키마, 클래스 및 스키마 필드 그룹을 소개합니다.

API에서 고유한 필드 유형을 정의할 계획이라면 스키마 레지스트리 개발자 안내서 에 사용자 정의 필드를 포함하도록 필드 그룹 및 데이터 유형을 만드는 방법을 알아봅니다. Experience Platform UI를 사용하여 스키마를 만드는 경우 UI의 필드 정의 사용자 지정 필드 그룹 및 데이터 형식 내에서 정의하는 필드에 대한 제약 조건을 구현하는 방법을 알아봅니다.

기본 구조 및 예 basic-types

XDM은 JSON 스키마 위에 구축되므로 XDM 필드는 해당 유형을 정의할 때 유사한 구문을 상속합니다. JSON 스키마에서 다양한 필드 유형이 표현되는 방식을 이해하면 각 유형의 기본 제약 조건을 표시하는 데 도움이 될 수 있습니다.

NOTE
다음을 참조하십시오. API 기본 사항 안내서 플랫폼 API의 JSON 스키마 및 기타 기본 기술에 대한 자세한 내용.

다음 표에서는 해당 유형을 준수하는 예제 값과 함께 각 XDM 유형이 JSON 스키마에서 표시되는 방식을 간략하게 설명합니다.

XDM 유형
JSON 스키마
String
{"type": "string"}
"Platinum"
Number
{"type": "number"}
12925.49
Long
{ "type": "integer", "maximum": 9007199254740991, "minimum": -9007199254740991 }
1478108935
정수
{ "type": "integer", "maximum": 2147483648, "minimum": -2147483648 }
24906290
Short
{ "type": "integer", "maximum": 32768, "minimum": -32768 }
15781
Byte
{ "type": "integer", "maximum": 128, "minimum": -128 }
90
날짜*
{ "type": "string", "format": "date" }
"2019-05-15"
DateTime*
{ "type": "string", "format": "date-time" }
"2019-05-15T20:20:39+00:00"
부울
{"type": "string"}
true

*모든 날짜 형식 문자열은 ISO 8601 표준(RFC 3339, 섹션 5.6).

XDM 유형을 다른 형식으로 매핑

아래 섹션에서는 각 XDM 유형이 다른 일반적인 직렬화 형식에 매핑되는 방법을 설명합니다.

NOTE
아래 표에 나열된 표준 XDM 유형 중 맵 유형도 포함됩니다. 맵은 데이터가 특정 값에 매핑되는 키로 표시되는 경우 또는 키가 정적 스키마에 합리적으로 포함될 수 없고 데이터 값으로 처리되어야 하는 경우 표준 스키마에서 사용됩니다.
대부분의 표준 XDM 구성 요소는 맵 유형을 사용하며 사용자 정의 맵 필드 정의 원하는 경우. 아래 표에 맵 유형이 포함된 이유는 기존 데이터가 현재 아래에 나열된 형식으로 저장되어 있는 경우 XDM에 매핑하는 방법을 결정하는 데 도움이 되기 위한 것입니다.

Parquet, Spark SQL 및 Java parquet

XDM 유형
쪽모이 세공
Spark SQL
Java
문자열
유형: BYTE_ARRAY
주석: UTF8
StringType
java.lang.String
숫자
유형: DOUBLE
LongType
java.lang.Double
길게
유형: INT64
LongType
java.lang.Long
정수
유형: INT32
주석: INT_32
IntegerType
java.lang.Integer
짧음
유형: INT32
주석: INT_16
ShortType
java.lang.Short
바이트
유형: INT32
주석: INT_8
ByteType
java.lang.Short
날짜
유형: INT32
주석: DATE
DateType
java.util.Date
DateTime
유형: INT64
주석: TIMESTAMP_MILLIS
TimestampType
java.util.Date
부울
유형: BOOLEAN
BooleanType
java.lang.Boolean
MAP-주석이 있는 그룹

(<key-type> 은(는) 다음과 같아야 합니다. STRING)
MapType

(keyType 은(는) 다음과 같아야 합니다. StringType)
java.util.Map

Scala, .NET 및 CosmosDB scala

XDM 유형
스칼라
.NET
CosmosDB
문자열
String
System.String
String
숫자
Double
System.Double
Number
길게
Long
System.Int64
Number
정수
Int
System.Int32
Number
짧음
Short
System.Int16
Number
바이트
Byte
System.SByte
Number
날짜
java.util.Date
System.DateTime
String
DateTime
java.util.Date
System.DateTime
String
부울
Boolean
System.Boolean
Boolean
Map
(N/A)
object

MongoDB, Aerospike 및 Protobuf 2 mongo

XDM 유형
몽고DB
에어로스파이크
프로토콜 버퍼 2
문자열
string
String
string
숫자
double
Double
double
길게
long
Integer
int64
정수
int
Integer
int32
짧음
int
Integer
int32
바이트
int
Integer
int32
날짜
date
Integer
(Unix 밀리초)
int64
(Unix 밀리초)
DateTime
timestamp
Integer
(Unix 밀리초)
int64
(Unix 밀리초)
부울
bool
Integer
(0/1 바이너리)
bool
object
map
map<key_type, value_type>

API에서 XDM 필드 유형 정의 define-fields

스키마 레지스트리 API를 사용하면 형식 및 선택적 제약 조건을 사용하여 사용자 지정 필드를 정의할 수 있습니다. 다음 안내서를 참조하십시오 스키마 레지스트리 API에서 사용자 정의 필드 정의 추가 정보.

recommendation-more-help
62e9ffd9-1c74-4cef-8f47-0d00af32fc07