Documentación Experience Platform Guía del Modelo de datos de experiencia (XDM)

Restricciones de tipo de campo XDM

Last update: Mon May 05 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Temas:

Creado para:

Desarrollador

En esquemas XDM (Experience Data Model), el tipo de campo restringe el tipo de datos que puede contener el campo. Este documento proporciona información general de cada tipo de campo principal, incluidos los demás formatos de serialización a los que se pueden asignar y cómo definir sus propios tipos de campo en la API para aplicar diferentes restricciones.

Introducción

Antes de usar esta guía, revise los conceptos básicos de la composición de esquemas para obtener una introducción a los esquemas XDM, las clases y los grupos de campos de esquema.

Si planea definir sus propios tipos de campo en la API, se recomienda comenzar con la Guía para desarrolladores de Schema Registry para aprender a crear grupos de campos y tipos de datos para incluir sus campos personalizados en. Si está usando la interfaz de usuario de Experience Platform para crear los esquemas, consulte la guía sobre definición de campos en la interfaz de usuario para obtener información sobre cómo implementar restricciones en campos que defina dentro de grupos de campos personalizados y tipos de datos.

Estructura base y ejemplos basic-types

XDM se basa en el esquema JSON y, por lo tanto, los campos XDM heredan una sintaxis similar al definir su tipo. Comprender cómo se representan los distintos tipos de campo en el esquema JSON puede ayudar a indicar las restricciones base de cada tipo. Los nombres de los campos personalizados no distinguen entre mayúsculas y minúsculas y deben tener nombres diferentes en el mismo nivel del esquema.

NOTE

Consulte la guía de aspectos básicos de la API para obtener más información sobre el esquema JSON y otras tecnologías subyacentes en las API de Experience Platform.

En la siguiente tabla se describe cómo se representa cada tipo XDM en el esquema JSON, junto con un valor de ejemplo que se ajusta al tipo:

Tipo de XDM

Esquema JSON

Ejemplo

String

{"type": "string"}

"Platinum"

Número

{"type": "number"}

12925.49

Long

{
  "tipo": "entero",
  "maximum": 9007199254740991,
  "mínimo": -9007199254740991
}

1478108935

Entero

{
  "tipo": "entero",
  "maximum": 2147483648,
  "mínimo": -2147483648
}

24906290

Corto

{
  "tipo": "entero",
  "maximum": 32768,
  "mínimo": -32768
}

15781

Byte

{
  "tipo": "entero",
  "máximo": 128,
  mínimo: -128
}

90

Fecha*

{
  "type": "string",
  "format": "date"
}

"2019-05-15"

DateTime*

{
  "type": "string",
  "format": "date-time"
}

"2019-05-15T20:20:39+00:00"

Booleano

{"type": "boolean"}

true

*Todas las cadenas con formato de fecha deben cumplir con el estándar ISO 8601 (RFC 3339, sección 5.6).

Asignación de tipos XDM a otros formatos

Las secciones siguientes describen cómo cada tipo XDM se asigna a otros formatos de serialización comunes:

Parquet, Spark SQL y Java
Scala, .NET y CosmosDB
MongoDB, Aerospike y Protobuf 2

NOTE

Entre los tipos XDM estándar enumerados en las tablas siguientes, también se incluye el tipo Map. Los mapas se utilizan en esquemas estándar cuando los datos se representan como claves que se asignan a determinados valores o cuando las claves no se pueden incluir razonablemente en un esquema estático y deben tratarse como valores de datos.

Muchos componentes XDM estándar usan tipos de asignación, y también puede definir campos de asignación personalizados si lo desea. La inclusión del tipo de mapa en las tablas siguientes pretende ayudarle a determinar cómo asignar los datos existentes a XDM si actualmente están almacenados en cualquiera de los formatos enumerados a continuación.

Parquet, Spark SQL y Java parquet

Tipo de XDM

Parquet

Spark SQL

Java

Cadena

Tipo: BYTE_ARRAY
Anotación: UTF8

StringType

java.lang.String

Número

Tipo: DOUBLE

LongType

java.lang.Double

Largo

Tipo: INT64

LongType

java.lang.Long

Entero

Tipo: INT32
Anotación: INT_32

IntegerType

java.lang.Integer

Corto

Tipo: INT32
Anotación: INT_16

ShortType

java.lang.Short

Byte

Tipo: INT32
Anotación: INT_8

ByteType

java.lang.Short

Fecha

Tipo: INT32
Anotación: DATE

DateType

java.util.Date

DateTime

Tipo: INT64
Anotación: TIMESTAMP_MILLIS

TimestampType

java.util.Date

Booleano

Tipo: BOOLEAN

BooleanType

java.lang.Boolean

Mapa

MAP: el grupo

anotado (<key-type> debe ser STRING)

MapType

(keyType debe ser StringType)

java.util.Map

Scala, .NET y CosmosDB scala

Tipo de XDM

Scala

.NET

CosmosDB

Cadena

String

System.String

String

Número

Double

System.Double

Number

Largo

Long

System.Int64

Number

Entero

Int

System.Int32

Number

Corto

Short

System.Int16

Number

Byte

Byte

System.SByte

Number

Fecha

java.util.Date

System.DateTime

String

DateTime

java.util.Date

System.DateTime

String

Booleano

Boolean

System.Boolean

Boolean

Mapa

Map

(N/D)

object

MongoDB, Aerospike y Protobuf 2 mongo

Tipo de XDM

MongoDB

Aerospike

Protobuf 2

Cadena

string

String

string

Número

double

Double

double

Largo

long

Integer

int64

Entero

int

Integer

int32

Corto

int

Integer

int32

Byte

int

Integer

int32

Fecha

date

Integer
(milisegundos de Unix)

int64
(milisegundos de Unix)

DateTime

timestamp

Integer
(milisegundos de Unix)

int64
(milisegundos de Unix)

Booleano

bool

Integer
(binario 0/1)

bool

Mapa

object

map

map<key_type, value_type>

Definición de tipos de campo XDM en la API define-fields

La API de Registro de esquemas permite definir campos personalizados mediante el uso de formatos y restricciones opcionales. Consulte la guía definición de campos personalizados en la API del Registro de esquemas para obtener más información.

recommendation-more-help

62e9ffd9-1c74-4cef-8f47-0d00af32fc07