XDM欄位型別限制

在Experience Data Model (XDM)結構描述中，欄位的型別會限制欄位可包含哪種資料。 本檔案提供每種核心欄位型別的概觀，包括可對應的其他序列化格式，以及如何在API中定義自己的欄位型別，以強制實施不同的限制。

快速入門

使用本指南之前，請先檢閱結構描述組合的基本知識，以瞭解XDM結構描述、類別和結構描述欄位群組的簡介。

如果您打算在API中定義自己的欄位型別，強烈建議您從Schema Registry開發人員指南開始，瞭解如何建立欄位群組和資料型別，以包含您的自訂欄位。 如果您使用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"，
  "maximum"：128，
  "minimum"： -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、Surospike和Protobuf 2 mongo

在API中定義XDM欄位型別 define-fields

Schema Registry API可讓您透過使用格式和選用限制來定義自訂欄位。 如需詳細資訊，請參閱在結構描述登入API中定義自訂欄位的指南。