XDM字段类型约束

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

快速入门

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

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

基本结构和示例 basic-types

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

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

{"type"： "string"}

{"type"： "number"}

{
  "type"： "integer"，
  "maximum"：9007199254740991，
  "minimum"： -9007199254740991
}

{
  "type"： "integer"，
  "maximum"：2147483648，
  "minimum"： -2147483648
}

{
  "type"： "integer"，
  "maximum"：32767，
  "minimum"： -32768
}

{
  "type"： "integer"，
  “最大值”：128，
  “最小值”：-128
}

{
  "type"： "string"，
  "format"： "date"
}

{
  "type"： "string"，
  "format"： "date-time"
}

{"type"： "boolean"}

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

将XDM类型映射到其他格式

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

Parquet、Spark SQL和Java parquet

Scala、.NET和CosmosDB scala

MongoDB、Arospike和Protobuf 2 mongo

在API中定义XDM字段类型 define-fields

架构注册表API允许您通过使用格式和可选约束来定义自定义字段。 有关详细信息，请参阅在架构注册表API中定义自定义字段指南。