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",
  "maximum": 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、Aerospike、およびProtobuf 2 mongo

APIでのXDM フィールドタイプの定義 define-fields

Schema Registry APIでは、形式とオプションの制約を使用してカスタムフィールドを定義できます。 詳しくは、Schema Registry APIでのカスタムフィールドの定義に関するガイドを参照してください。