文档 Journey Optimizer Journey Optimizer 指南

使用DDL文件创建基于模型的架构 file-upload-schema

Last update: Tue Sep 30 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

适用对象：
Campaign Orchestration

通过创建架构（如 忠诚度会员资格、忠诚度交易 和 忠诚度奖励），定义编排营销活动所需的基于模型的数据模型。每个架构必须包含一个主键、一个版本控制属性和适当的关系以引用实体，如 收件人 或品牌。

可以通过界面手动创建架构，或使用DDL文件批量导入架构。

本节提供了有关如何通过上传DDL（数据定义语言）文件在Adobe Experience Platform中创建基于模型的架构的分步指南。可使用 DDL 文件预先定义数据模型的结构，包括表、属性、键和关系。

上传DDL文件以创建基于模型的架构并定义其结构。
定义数据模型中表之间的关系。
链接架构以将基于模型的数据与现有配置文件实体（如收件人或品牌）连接。
从支持的数据源将数据摄取至数据集中。

➡️ 在Adobe Experience Platform文档中了解有关基于模型的架构的更多信息

上载DDL文件 ddl-upload

通过上传DDL文件，您可以预先定义数据模型的结构，包括表、属性、键和关系。

支持基于Excel的架构文件上传。下载提供的模板以轻松准备架构定义。

在Adobe Experience Platform中创建基于模型的架构时，支持以下功能

枚举
基于DDL的架构和手动架构创建均支持ENUM字段，从而允许您定义具有一组固定的允许值的属性。
示例如下：

code language-none

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) );`

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)
);

用于数据管理的 架构标签
架构字段级别支持标签设置，以强制执行数据管理策略，例如访问控制和使用限制。有关详细信息，请参阅Adobe Experience Platform文档。
复合键
基于模型的架构定义支持复合主键，允许同时使用多个字段来唯一标识记录。

登录到Adobe Experience Platform。
导航到 数据管理 > 架构菜单。
单击 创建架构。
选择 基于模型的 作为您的 架构类型。

选择 上传 DDL 文件 以定义实体关系图并创建架构。

表结构必须包含：

至少一个主键。
版本标识符，如 datetime 或 number 类型的 lastmodified 字段。
对于变更数据捕获(CDC)摄取，为名为_change_request_type且类型为String的特殊列，它指示数据变更的类型（例如，插入、更新、删除）并启用增量处理。
DDL文件不能定义超过200个表。

note important
IMPORTANT
用于定位的任何架构必须至少包含一个类型为`String`且具有关联标识命名空间的标识字段。这可确保与Adobe Journey Optimizer的定位和身份解析功能兼容。

拖放您的 DDL 文件并单击 下一步。

请注意，支持DDL文件的最大大小为10MB。
键入您的 架构名称。
设置每个架构及其列，确保指定了主键和版本描述符。

必须指定一个属性（如lastmodified）作为版本描述符（类型datetime、long或int），以确保使用最新数据更新数据集。用户可以更改版本描述符，一旦设置，版本描述符将变为必需。属性不能同时是主键(PK)和版本描述符。
将属性标记为identity并将其映射到定义的身份命名空间。
重命名、删除每个表或向每个表添加说明。
完成后，单击完成。

您现在可以在画布中验证表和字段定义。在下面的部分中了解更多信息

定义关系 relationships

创建架构时，可以直接在DDL文件中指定关系。如果您希望定义文件外部的关系，可以在界面中按照以下步骤定义关系。

访问数据模型的画布视图，然后选择要关联的两个表

单击“源联接”旁边的按钮，然后拖动箭头指向“目标联接”连接以建立关联。

note note
NOTE
如果在DDL文件中定义，则支持复合键。

填写给定表单以定义链接，配置完毕后单击应用。

基数：
- 1-N：源表的一个项可以对应目标表的多个项，但目标表的一个项最多对应源表的一个项。
- N-1：目标表的一个项可以对应源表的多个项，但源表的一个项最多对应目标表的一个项。
- 1-1：源表的一个项最多对应目标表的一个项。
数据模型中定义的所有链接在画布视图中均表示为箭头。单击两个表之间的箭头可查看详细信息、进行编辑或根据需要移除链接。
使用工具栏自定义和调整画布。
- 放大：放大画布，更清楚地查看数据模型的详细信息。
- 缩小：缩小画布大小，以便更全面地查看数据模型。
- 适应视图：调整缩放，适应可见区域内的所有架构。
- 筛选：选择要在画布中显示的架构。
- 强制自动布局：自动排列架构以便更好地进行组织。
- 显示映射：切换小映射叠加，有助于更轻松地浏览大型或复杂的架构布局。
完成后，单击保存。此操作将创建架构和关联的数据集，并启用数据集以用于精心策划的营销活动。
单击 打开作业，监控创建作业的进度。此过程可能需要几分钟时间，具体取决于 DDL 文件中的表数量。

您还可以通过打开 上传DDL文件 窗口并选择 查看所有DDL导入作业 来访问DDL导入作业。