Creación de esquemas relacionales mediante un archivo DDL file-upload-schema

En esta página: Aprenda a crear esquemas relacionales en Adobe Experience Platform cargando un archivo DDL, definiendo relaciones entre tablas y vinculando esquemas a entidades existentes para usarlos en campañas orquestadas.

Defina el modelo de datos relacionales necesario para las campañas orquestadas creando esquemas como Suscripciones de fidelización, Transacciones de fidelización y Recompensas de fidelización. Cada esquema debe incluir una clave principal, un atributo de versiones y las relaciones adecuadas para hacer referencia a entidades como Destinatarios o Marcas.

Los esquemas se pueden crear manualmente a través de la interfaz o importar de forma masiva mediante un archivo DDL.

En esta sección se proporciona una guía paso a paso sobre cómo crear un esquema relacional en Adobe Experience Platform cargando un archivo DDL (lenguaje de definición de datos). El uso de un archivo DDL permite definir la estructura de su modelo de datos por adelantado, incluidas las tablas, los atributos, las claves y las relaciones.

  1. Cargar un archivo DDL para crear esquemas relacionales y definir su estructura.

  2. Defina relaciones entre tablas en su modelo de datos.

  3. Vincular esquemas para conectar los datos relacionales con entidades de perfil existentes como Destinatarios o Marcas.

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

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

Cargar un archivo DDL ddl-upload

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.

Al cargar un archivo DDL, puede definir la estructura del modelo de datos por adelantado, incluidas tablas, atributos, claves y relaciones.

Se admiten las cargas de archivos de esquema basados en Excel. Descargue la plantilla proporcionada para preparar fácilmente sus definiciones de esquema.

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. Al cargar un esquema desde un archivo DDL, las enumeraciones definidas en el archivo se importan automáticamente, lo que permite definir atributos con un conjunto fijo de valores permitidos.

    Vea el siguiente ejemplo:

    code language-none
    CREATE TABLE orders (
    order_id     INT NOT NULL,
    product_id   INT NOT NULL,
    order_date   DATE NOT NULL,
    customer_id  INT NOT NULL,
    quantity     INT NOT NULL,
    order_status enum ('PENDING', 'SHIPPED', 'DELIVERED', 'CANCELLED'),
    PRIMARY KEY (order_id, product_id)
    );
    
  • Clave compuesta y Relaciones compuestas

    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.

    Al cargar un esquema desde un archivo DDL o Excel, las relaciones compuestas entre tablas se crean automáticamente. En la vista de relación de entidades, cada vínculo compuesto muestra el conjunto completo de emparejamientos de campos entre las tablas vinculadas.

  • 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.

  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.

  5. Seleccione Cargar archivo DDL para definir un diagrama de relación de entidades y crear esquemas.

    La estructura de la tabla debe contener:

    • 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.
    • El archivo DDL no debe definir más de 200 tablas.
    • Una tabla no puede hacer referencia a sí misma: no se permiten relaciones de autorreferencia en el archivo DDL.
    note important
    IMPORTANT
    Cualquier esquema usado para la segmentación debe incluir al menos un campo de identidad de tipo String con un área de nombres de identidad asociado.
    Esto garantiza la compatibilidad con las capacidades de segmentación y resolución de identidades de Adobe Journey Optimizer.
  6. Arrastre y suelte su archivo DDL y haga clic en Siguiente.

    Tenga en cuenta que el tamaño máximo admitido para un archivo DDL es de 10 MB. El nombre del archivo solo debe contener letras, números, guiones bajos (_), guiones (-) o espacios, e incluir una sola extensión.

  7. Escriba su Nombre de esquema.

  8. Configure cada esquema y sus columnas, asegurándose de que se especifican una clave principal y un descriptor de versión.

    Un atributo, como lastmodified, debe designarse como descriptor de versión (tipo datetime, long o int) para garantizar que los conjuntos de datos se actualicen con los datos más recientes. Los usuarios pueden cambiar el descriptor de versión, que se vuelve obligatorio una vez configurado. Un atributo no puede ser a la vez una clave principal (PK) y un descriptor de versión.

  9. Marque un atributo como identity y asígnelo a un área de nombres de identidad definida.

  10. Cambie el nombre, elimine o agregue una descripción a cada tabla.

  11. Haga clic en Listo cuando haya finalizado.

Ahora puede comprobar las definiciones de tabla y campo dentro del lienzo. Más información en la siguiente sección

Definición de relaciones relationships

Puede especificar relaciones directamente dentro del archivo DDL al crear el esquema. Si prefiere definir relaciones fuera del archivo, puede hacerlo en la interfaz siguiendo los pasos a continuación.

  1. Acceda a la vista de lienzo del modelo de datos y elija las dos tablas que desea vincular

  2. Haga clic en el botón junto a Unión de origen, y a continuación, arrastre y guíe la flecha hacia Unión de destino para establecer la conexión.

    note
    NOTE
    Las claves compuestas que abarcan varios campos son compatibles cuando se definen en el archivo DDL. Al cargar desde un archivo DDL o Excel, las relaciones compuestas entre tablas se crean automáticamente. En la vista de relación de entidades, los vínculos compuestos muestran el conjunto completo de emparejamientos de campos entre las tablas vinculadas.

  3. Complete el formulario proporcionado para definir el vínculo y haga clic en Aplicar una vez configurado.

    Cardinalidad:

    • 1-N: una ocurrencia de la tabla de origen puede tener varias ocurrencias correspondientes de la tabla de destino, pero una ocurrencia de la tabla de destino puede tener como máximo una ocurrencia correspondiente de la tabla de origen.

    • N-1: una ocurrencia de la tabla de destino puede tener varias ocurrencias correspondientes de la tabla de origen, pero una ocurrencia de la tabla de origen puede tener como máximo una ocurrencia correspondiente de la tabla de destino.

    • 1-1: una ocurrencia de la tabla de origen puede tener como máximo una ocurrencia correspondiente de la tabla de destino.

  4. Todos los vínculos definidos en el modelo de datos se representan como flechas en la vista de lienzo. Haga clic en la flecha entre dos tablas para ver los detalles, realizar ediciones o quitar el vínculo según sea necesario.

  5. Utilice la barra de herramientas para personalizar y ajustar el lienzo.

    • Aumentar: amplíe el lienzo para ver los detalles del modelo de datos con mayor claridad.

    • Reducir: reduzca el tamaño del lienzo para obtener una vista más amplia del modelo de datos.

    • Ajustar vista: ajuste el zoom para ajustar todos los esquemas dentro del área visible.

    • Filtro: elija qué esquema desea mostrar en el lienzo.

    • Forzar diseño automático: organiza automáticamente los esquemas para mejorar la organización.

    • Mostrar mapa: active una superposición del minimapa para que sea más fácil navegar por diseños de esquema grandes o complejos.

    • Expandir todo/contraer todo: expanda o contraiga rápidamente todos los nodos de esquema para mostrar u ocultar sus atributos.

    • Descargar: Descargue el diagrama de ER como archivo .png.

  6. Haga clic en Guardar cuando haya terminado. Esta acción crea los esquemas y los conjuntos de datos asociados y habilita el conjunto de datos para su uso en campañas orquestadas.

  7. Haga clic en Abrir trabajos para monitorizar el progreso del trabajo de creación. Este proceso puede tardar un par de minutos, según el número de tablas definidas en el archivo DDL.

    También puede acceder a sus trabajos de importación de DDL abriendo la ventana Cargar archivo DDL y seleccionando Ver todos los trabajos de importación de DDL.

IMPORTANT
El sistema solo reconoce las relaciones definidas explícitamente dentro del archivo DDL. Las relaciones de entidad que existan fuera del archivo DDL se ignorarán y no se procesarán.

Establezca una relación entre el esquema Transacciones de lealtad y el esquema Destinatarios para asociar cada transacción con el registro de cliente correcto.

  1. Vaya a Esquemas y abra las Transacciones de lealtad que creó anteriormente.

  2. Haga clic en Añadir relación desde las Propiedades de campo del cliente.

  3. Seleccione Varios a uno como la relación Tipo.

  4. Vincúlese al esquema Destinatarios existente.

  5. Escriba un Nombre de relación del esquema actual y un Nombre de relación del esquema de referencia.

  6. Haga clic en Aplicar para guardar los cambios.

Continúe creando una relación entre el esquema recompensas por lealtad y el esquema Marcas para asociar cada entrada de recompensa con la marca adecuada.

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 create relational schemas in Adobe Experience Platform by uploading a DDL file, defining relationships between tables, and linking schemas to existing entities for use in Orchestrated campaigns.

Intents:

  • Upload a DDL file to create relational schemas and define their structure.
  • Define relationships between tables in the data model, either within the DDL file or in the interface.
  • Link a relational schema to existing profile entities such as Recipients or Brands.
  • Identify the required table structure elements: primary key, version identifier, and identity field for targeting.
  • Monitor the progress of a DDL import job.
  • Resolve schema or dataset errors returned during this process.

Glossary:

  • Relational schema: a schema created to define the data model required for Orchestrated campaigns, such as Loyalty Memberships, Loyalty Transactions, or Loyalty Rewards (product-specific)
  • DDL file: a Data Definition Language file used to define tables, attributes, keys, and relationships of a data model in advance (product-specific)
  • ENUM: a field type supporting a fixed set of allowed values, supported in both DDL-based and manual schema creation (product-specific)
  • Composite key / Composite relationships: primary keys or relationships spanning multiple fields, supported in relational schema definitions and created automatically when loading from a DDL or Excel file (product-specific)
  • Schema label: a labeling mechanism at the schema field level used to enforce data governance policies such as access control and usage restrictions (product-specific)
  • Version descriptor: an attribute (for example lastmodified) designated to ensure datasets are updated with the latest data; type datetime, long, or int (product-specific)
  • Identity field: a field of type String with an associated identity namespace, required on any schema used for targeting (product-specific)
  • Cardinality: the type of relationship between two tables — 1-N, N-1, or 1-1 (product-specific)

Guardrails:

  • A DDL file must not define more than 200 tables (hard limit).
  • A table cannot reference itself: self-referential relationships are not allowed in the DDL file (hard limit).
  • The maximum supported size for a DDL file is 10MB (hard limit).
  • The DDL file name must contain only letters, numbers, underscores (_), hyphens (-), or spaces, and include a single extension (hard limit).
  • The table structure must contain 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 table structure must contain a special column named _change_request_type of type String.
  • 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.
  • An attribute cannot be both a primary key (PK) and a version descriptor.
  • The version descriptor becomes mandatory once set, though users can change it.
  • Only relationships explicitly defined within the DDL file are recognized by the system; any entity relationships that exist outside of the DDL file are ignored and not processed.
  • The View relationships diagram from the Relationship tab is read-only; to create or edit a relationship, the schema must be opened from the Browse tab instead.
  • Saving the data model creates the schemas and associated data sets and enables the data set for use in Orchestrated campaigns.

Terminology:

  • Canonical name: relational schema — variants: schema
  • Do not confuse: “1-N” cardinality (one source occurrence can have several target occurrences, but one target occurrence has at most one corresponding source occurrence) ≠ “N-1” cardinality (one target occurrence can have several source occurrences, but one source occurrence has at most one corresponding target occurrence) ≠ “1-1” cardinality (one source occurrence can have at most one corresponding target occurrence)
  • Do not confuse: “primary key” (uniquely identifies records) ≠ “version descriptor” (ensures datasets are updated with the latest data) — an attribute cannot be both

FAQ:

  • Q: What must a table structure contain to create a relational schema from a DDL file? — At least one primary key, a version identifier such as a lastmodified field of type datetime or number, and for CDC ingestion a _change_request_type column of type String.
  • Q: Is there a limit on the number of tables in a DDL file? — Yes, a DDL file must not define more than 200 tables.
  • Q: Can a table reference itself in the DDL file? — No, self-referential relationships are not allowed in the DDL file.
  • Q: What is the maximum DDL file size? — 10MB.
  • Q: What is required for a schema used for targeting? — At least one identity field of type String with an associated identity namespace.
  • Q: Are relationships defined outside the DDL file recognized? — No, only relationships explicitly defined within the DDL file are recognized; entity relationships that exist outside of the DDL file are ignored and not processed.
  • Q: Where can a relationship be created or edited? — From the Browse tab; the View relationships diagram from the Relationship tab is read-only.

Related pages:

  • For ingesting data into a dataset after creating relational schemas: Ingest data (orchestrated/ingest-data.md)
  • For resolving a schema or dataset error code: Relational schema and dataset errors (orchestrated/relational-schema-errors.md)

Personas:

  • developer: Can create relational schemas by uploading a DDL file that defines tables, attributes, keys, and relationships. Can use ENUM fields with a fixed set of allowed values, and composite primary keys and composite relationships spanning multiple fields. The page states that any schema used for targeting must include at least one identity field of type String with an associated identity namespace. Where: “Upload a DDL file”.
  • admin: Can select Relational as the Schema type and select Upload DDL file to define an entity relationship diagram. Can navigate the Data Management > Schema menu to create a schema, then select Open Jobs to monitor the DDL import job. The page states that a DDL file must not define more than 200 tables and must not exceed 10MB in size. Where: “Guardrails”.

Onboarding:

  • Level: Experienced
  • First minimal step: Select Relational as your Schema type.
  • Success check: You can now verify the table and field definitions within the canvas.
  • Next: After creating relational schemas, ingest data into your 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