XDM字段类型约束

最近更新： 2025年5月5日
  • 主题：

创建对象：

  • 开发人员

在Experience Data Model (XDM)架构中，字段的类型会限制字段可以包含的数据类型。 本文档概述了每种核心字段类型，包括它们可以映射到的其他序列化格式，以及如何在API中定义自己的字段类型以强制实施不同的限制。

快速入门

在使用本指南之前，请查看架构组合的基础知识，以了解XDM架构、类和架构字段组的简介。

如果您计划在API中定义自己的字段类型，强烈建议您从架构注册表开发人员指南开始，了解如何创建字段组和数据类型以包含您的自定义字段。 如果您使用Experience Platform UI创建架构，请参阅在UI中定义字段指南，以了解如何对您在自定义字段组和数据类型中定义的字段实施约束。

基本结构和示例

XDM基于JSON架构构建，因此XDM字段在定义其类型时继承类似的语法。 了解不同字段类型在JSON架构中的表示方式有助于指示每种类型的基本约束。 自定义字段名称不区分大小写，并且在架构中的同一级别必须具有不同的名称。

NOTE
有关Experience Platform API中JSON架构和其他基础技术的更多信息，请参阅API基础指南。

下表概述了每个XDM类型在JSON架构中的表示方式，以及符合该类型的示例值：

XDM类型JSON架构示例
字符串 
{"type"： "string"}
"Platinum"
编号 
{"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
字节 
{
  "type"： "integer"，
  “最大值”：128，
  “最小值”：-128
}
90
日期* 
{
  "type"： "string"，
  "format"： "date"
}
"2019-05-15"
日期时间* 
{
  "type"： "string"，
  "format"： "date-time"
}
"2019-05-15T20:20:39+00:00"
Boolean 
{"type"： "boolean"}
true

*所有日期格式字符串必须符合ISO 8601标准（RFC 3339，第5.6节）。

将XDM类型映射到其他格式

以下各节将介绍每个XDM类型如何映射到其他常见的序列化格式：

NOTE
在下表列出的标准XDM类型中，Map类型也包括在内。 当数据表示为映射到特定值的键时，或者在静态架构中无法合理地包含键且必须视为数据值时，在标准架构中使用映射。
许多标准XDM组件使用映射类型，如果需要，您还可以定义自定义映射字段。 下表包含映射类型，其目的是为了帮助您确定如何将现有数据映射到XDM（如果当前以下面列出的任何格式存储）。

Parquet、Spark SQL和Java

XDM类型ParquetSpark SQLJava
字符串类型： BYTE_ARRAY
批注： UTF8		StringTypejava.lang.String
数字类型：DOUBLELongTypejava.lang.Double
长类型：INT64LongTypejava.lang.Long
整数类型： INT32
批注： INT_32		IntegerTypejava.lang.Integer
短类型： INT32
批注： INT_16		ShortTypejava.lang.Short
字节类型： INT32
批注： INT_8		ByteTypejava.lang.Short
日期类型： INT32
批注： DATE		DateTypejava.util.Date
日期时间类型： INT64
批注： TIMESTAMP_MILLIS		TimestampTypejava.util.Date
布尔值类型：BOOLEANBooleanTypejava.lang.Boolean
地图MAP — 注释的组

（<key-type>必须为STRING）		MapType

（keyType必须为StringType）		java.util.Map

Scala、.NET和CosmosDB

XDM类型Scala.NETCosmosDB
字符串StringSystem.StringString
数字DoubleSystem.DoubleNumber
长LongSystem.Int64Number
整数IntSystem.Int32Number
短ShortSystem.Int16Number
字节ByteSystem.SByteNumber
日期java.util.DateSystem.DateTimeString
日期时间java.util.DateSystem.DateTimeString
布尔值BooleanSystem.BooleanBoolean
地图Map（不适用）object

MongoDB、Arospike和Protobuf 2

XDM类型MongoDB塞式火箭Protobuf 2
字符串stringStringstring
数字doubleDoubledouble
长longIntegerint64
整数intIntegerint32
短intIntegerint32
字节intIntegerint32
日期dateInteger
（Unix毫秒）		int64
（Unix毫秒）
日期时间timestampInteger
（Unix毫秒）		int64
（Unix毫秒）
布尔值boolInteger
（0/1二进制文件）		bool
地图objectmapmap<key_type, value_type>