XDM フィールドタイプ制約

最終更新日： 2025年4月4日
  • トピック：

作成対象：

  • 開発者

エクスペリエンスデータモデル（XDM）スキーマでは、フィールドのタイプによって、フィールドに含めることができるデータの種類が制限されます。 このドキュメントでは、マッピング可能なその他のシリアル化形式や、様々な制約を適用するために API で独自のフィールドタイプを定義する方法など、各コアフィールドタイプの概要を説明します。

はじめに

このガイドを使用する前に、 スキーマ構成の基本を参照して、XDM スキーマ、クラス、スキーマフィールドグループの概要を確認してください。

API で独自のフィールドタイプを定義する予定がある場合は、 スキーマレジストリ開発者ガイドを参照して、フィールドグループとデータタイプを作成し、カスタムフィールドを含める方法を確認することを強くお勧めします。 Experience Platform UI を使用してスキーマを作成する場合は、UI でのフィールドの定義に関するガイドを参照して、カスタムフィールドグループおよびデータタイプ内で定義するフィールドに対する制約の実装方法を確認してください。

基本構造と例

XDM は JSON スキーマを基に構築されているので、XDM フィールドはタイプを定義する際に同様の構文を継承します。 JSON スキーマで様々なフィールドタイプがどのように表現されるかを理解することは、各タイプのベース制約を示すのに役立ちます。 カスタムフィールド名では、大文字と小文字が区別されず、スキーマの同じレベルで異なる名前を持つ必要があります。

NOTE
JSON スキーマおよびExperience Platform API のその他の基盤となるテクノロジーについて詳しくは、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
短 ​ 
{
  "type": "integer",
  「maximum」:32768、
  "minimum": -32768
}
15781
バイト ​ 
{
  "type": "integer",
  「maximum」:128,
  "minimum":-128
}
90
日付 ​* 
{
  "type": "string",
  "format": "date"
}
"2019-05-15"
日時 ​* 
{
  "type": "string",
  "format": "date-time"
}
"2019-05-15T20:20:39+00:00"
ブール値 ​ 
{"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
Long型：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
LongLongSystem.Int64Number
​ 整数 ​IntSystem.Int32Number
​ 短い ​ShortSystem.Int16Number
​ バイト ​ByteSystem.SByteNumber
日付java.util.DateSystem.DateTimeString
​ 日時 ​java.util.DateSystem.DateTimeString
​ ブール値 ​BooleanSystem.BooleanBoolean
マップMap（N/A）object