Configuración de un esquema relacional manual manual-schema

En esta página: Aprenda a crear manualmente un esquema relacional en la interfaz de usuario, agregar atributos, vincular esquemas y crear y habilitar un conjunto de datos para campañas orquestadas.

Los esquemas relacionales se pueden crear directamente a través de la interfaz de usuario, lo que permite una configuración detallada de atributos, claves principales, campos de versiones y relaciones.

El ejemplo siguiente define manualmente el esquema Pertenencias de fidelización para ilustrar la estructura necesaria para las campañas orquestadas.

  1. Cree un esquema relacional manualmente mediante la interfaz de Adobe Experience Platform.

  2. Agregar atributos como ID de cliente, nivel de pertenencia y campos de estado.

  3. Vincule su esquema a esquemas integrados como Destinatarios para la segmentación de campañas.

  4. Cree un conjunto de datos basado en su esquema y actívelo para usarlo en campañas orquestadas.

  5. Introducir datos en su conjunto de datos desde fuentes compatibles.

➡️ Obtenga más información acerca de esquemas relacionales manuales en la documentación de Adobe Experience Platform

Cree su esquema schema

NOTE
El diagrama de relaciones de vista de la ficha Relación es de solo lectura. Para crear o editar una relación, abre el esquema desde la pestaña Examinar.

Comience creando un nuevo esquema relacional manualmente en Adobe Experience Platform. Este proceso permite definir la estructura de esquema desde cero, incluido su nombre y comportamiento.

  1. Inicie sesión en Adobe Experience Platform.

  2. Vaya al menú Administración de datos > Esquema.

  3. Haga clic en Crear esquema.

  4. Seleccione Relacional como su Tipo de esquema.

    {modal="regular"}

  5. Elija Crear manualmente para generar el esquema agregando campos manualmente.

  6. Escriba su nombre para mostrar del esquema.

    {modal="regular"}

  7. Haga clic en Finalizar para continuar con la creación del esquema.

Ahora puede empezar a añadir atributos al esquema para definir su estructura.

Añadir atributos al esquema schema-attributes

A continuación, añada atributos para definir la estructura del esquema. Estos campos representan los puntos de datos clave utilizados en campañas organizadas, como identificadores de clientes, detalles de pertenencia y fechas de actividades. Definirlos con precisión garantiza una personalización, segmentación y seguimiento fiables.

Cualquier esquema utilizado para la segmentación debe incluir al menos un campo de identidad de tipo String con un área de nombres de identidad asociada. Esto garantiza la compatibilidad con las capacidades de segmentación y resolución de identidades de Adobe Journey Optimizer.

Se admiten las siguientes funciones al crear esquemas relacionales en Adobe Experience Platform
  • ENUM
    Los campos ENUM son compatibles con la creación de esquemas manual y basada en DDL, lo que permite definir atributos con un conjunto fijo de valores permitidos.

  • Etiqueta de esquema para el control de datos
    El etiquetado es compatible a nivel de campo de esquema para aplicar políticas de gobernanza de datos como el control de acceso y las restricciones de uso. Para obtener más información, consulte Documentación de Adobe Experience Platform.

  • Clave compuesta
    Las claves principales compuestas que abarcan varios campos son compatibles con las definiciones de esquema relacional, lo que permite el uso de varios campos juntos para identificar registros de forma exclusiva.

  1. En el lienzo, haga clic en junto a su nombre de esquema para empezar a agregar atributos.

    {modal="regular"}

  2. Escriba su atributo Nombre de campo, Nombre para mostrar y Tipo.

    En este ejemplo, agregamos los atributos detallados en la tabla siguiente al esquema Pertenencias de fidelización.

    accordion
    Ejemplos de atributos
    table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 7-row-3 8-row-3
    Nombre de atributo Tipo de datos Atributos adicionales
    cliente CADENA Clave principal
    member_level CADENA Requerido
    points_balance ENTERO Requerido
    enrollment_date FECHA Requerido
    last_status_change FECHA Requerido
    expiration_date FECHA -
    is_active BOOLEANO Requerido
    última modificación DATETIME Requerido
  3. Asigne los campos apropiados como Clave principal y Descriptor de versión.

    Al crear un esquema manual, asegúrese de que se incluyen los siguientes campos esenciales:

    • Al menos una clave principal
    • Un identificador de versión, como un campo de tipo lastmodified, datetime o number.
    • Para la ingesta de Change Data Capture (CDC), una columna especial denominada _change_request_type de tipo String, que indica el tipo de cambio de datos (por ejemplo, insertar, actualizar, eliminar) y habilita el procesamiento incremental. Tenga en cuenta que _change_request_type no debe formar parte del esquema de tabla, solo debe agregarse al archivo de datos durante la ingesta.

    {modal="regular"}

  4. Haga clic en Guardar.

Después de crear y guardar atributos, puede vincular el esquema con otros esquemas relacionales definiendo relaciones.

➡️ Obtenga más información acerca de esquemas relacionales en la documentación de Adobe Experience Platform

La creación de una relación entre dos esquemas permite mejorar las campañas orquestadas con datos que superan el esquema de perfil principal.

  1. En el esquema recién creado, seleccione el atributo que desee usar como vínculo y haga clic en Agregar relación.

    {modal="regular"}

  2. Elija Esquema de referencia y Campo de referencia con los que establecer la relación.

    En este ejemplo, el atributo customer está vinculado al esquema recipients.

    {modal="regular"}

  3. Introduzca un Nombre de relación del esquema actual y del esquema de referencia.

  4. Haga clic en Aplicar una vez configurado.

Crear un conjunto de datos para el esquema dataset

Después de definir el esquema, ahora puede crear un conjunto de datos basado en él. El conjunto de datos almacena los datos ingeridos y debe estar habilitado para que las campañas orquestadas sean accesibles.

  1. Vaya al menú Administración de datos > Conjuntos de datos y haga clic en Crear conjunto de datos.

    {modal="regular"}

  2. Seleccione Crear conjunto de datos a partir del esquema.

  3. Elija el esquema creado anteriormente, aquí Pertenencias de fidelización, y haga clic en Siguiente.

    {modal="regular"}

  4. Escriba un Nombre para su Conjunto de datos y haga clic en Finalizar.

Ahora debe habilitar el conjunto de datos para campañas organizadas.

Habilitar el conjunto de datos para campañas orquestadas enable

Después de crear el conjunto de datos, debe habilitarlo explícitamente para las campañas orquestadas. Este paso garantiza que el conjunto de datos esté disponible para la orquestación y personalización en tiempo real dentro de Adobe Journey Optimizer.

Consulte Documentación de Adobe Developer para validar o habilitar la extensión de Campaign orquestada en el conjunto de datos.

  1. Busque su conjunto de datos en la lista Conjuntos de datos.

  2. En la configuración de Conjuntos de datos, habilite la opción Campañas orquestadas para marcar el conjunto de datos disponible para usar en sus campañas orquestadas.

    {modal="regular"}

  3. Espere unos minutos para que se complete el proceso de habilitación. Tenga en cuenta que la ingesta de datos y el uso de la campaña solo serán posibles una vez que esta configuración esté completamente activada.

Ahora puede empezar a introducir datos en el esquema utilizando el origen de su elección.

➡️ Aprenda a ingerir datos

Si un esquema o conjunto de datos devuelve un código de error, consulte Errores relacionales de esquema y conjunto de datos.

AI Knowledge Reference

This section contains structured knowledge intended to support interpretation, retrieval, and question answering related to this topic.

For complete understanding, this information should be combined with the documentation on this page. Neither source is intended to stand alone; the page describes the feature, while this section provides additional context that helps disambiguate terminology, intent, applicability, and constraints.

  • TL;DR: This page explains how to manually create a relational schema in Adobe Experience Platform, add attributes, link schemas, and create and enable a dataset for use in Orchestrated campaigns.

Intents:

  • Create a relational schema manually through the Adobe Experience Platform interface.
  • Add attributes to a relational schema, including primary key, version descriptor, and required fields.
  • Link a relational schema to another schema, such as Recipients, to extend Orchestrated campaigns with additional data.
  • Create a dataset from a relational schema and enable it for Orchestrated campaigns.
  • Ingest data into the enabled dataset.

Glossary:

  • Relational schema: a schema type created directly through the Adobe Experience Platform interface, enabling detailed configuration of attributes, primary keys, versioning fields, and relationships (product-specific)
  • Version Descriptor: a field, such as lastmodified of type datetime or number, used as a version identifier in a manual schema (product-specific)
  • _change_request_type: a special column of type String used for Change Data Capture (CDC) ingestion, indicating the type of data change (insert, update, delete) and enabling incremental processing (product-specific)
  • Composite Key: a primary key spanning multiple fields, supported in relational schema definitions (product-specific)
  • Schema Label: a data governance label supported at the schema field level to enforce policies such as access control and usage restrictions (product-specific)

Guardrails:

  • Any schema used for targeting must include at least one identity field of type String with an associated identity namespace, to ensure compatibility with Adobe Journey Optimizer’s targeting and identity resolution capabilities.
  • A manual schema must include at least one primary key and a version identifier, such as a lastmodified field of type datetime or number.
  • For Change Data Capture (CDC) ingestion, the _change_request_type column must not be part of the table schema; it must only be added to the data file during ingestion.
  • ENUM fields are supported in both DDL-based and manual schema creation.
  • Composite primary keys spanning multiple fields are supported in relational schema definitions.
  • The View relationships diagram on the Relationship tab is read-only; to create or edit a relationship, the schema must be opened from the Browse tab instead.
  • After enabling a dataset for Orchestrated campaigns, data ingestion and campaign use are only possible once the enablement setting is fully activated.

Terminology:

  • Canonical name: Adobe Experience Platform — Acronym: AEP

FAQ:

  • Q: What fields must a manual relational schema include? — At least one primary key and a version identifier, such as a lastmodified field of type datetime or number.
  • Q: What is required for a schema used for targeting? — At least one identity field of type String with an associated identity namespace.
  • Q: Where does the _change_request_type column belong? — It is used for Change Data Capture (CDC) ingestion and must only be added to the data file during ingestion, not to the table schema.
  • Q: Can I edit a relationship from the View relationships diagram? — No, that view on the Relationship tab is read-only; open the schema from the Browse tab to create or edit a relationship.
  • Q: What must be done after creating a dataset from a relational schema? — The dataset must be explicitly enabled for Orchestrated campaigns before data ingestion and campaign use are possible.

Related pages:

  • To ingest data into the created dataset: Configuration steps (orchestrated/ingest-data.md)
  • If a schema or dataset returns an error code: Relational schema and dataset errors (orchestrated/relational-schema-errors.md)

Personas:

  • developer: Can add attributes such as customer, membership_level, points_balance, enrollment_date, and lastmodified when defining a relational schema. Can use a special column named _change_request_type of type String to indicate insert, update, or delete for Change Data Capture ingestion. The page states that _change_request_type must only be added to the data file during ingestion, not to the table schema. Where: “Add attributes to your schema”.
  • admin: Can create a dataset from a relational schema and enable the Orchestrated campaigns option from the Datasets settings. Can locate the dataset in the Datasets list before enabling it. The page states that data ingestion and campaign use are only possible once this setting is fully activated. Where: “Enable dataset for orchestrated campaigns”.

Onboarding:

  • Level: Experienced
  • First minimal step: Create a relational schema manually using the Adobe Experience Platform interface.
  • Success check: You can now start ingesting data into your schema using the source of your choice.
  • Next: Ingest data into the enabled dataset: Configuration steps (orchestrated/ingest-data.md); If a schema or dataset returns an error code: Relational schema and dataset errors (orchestrated/relational-schema-errors.md)
recommendation-more-help
journey-optimizer-help