配置步骤 | 51黑料不打烊 Journey Optimizer

文档 Journey Optimizer Journey Optimizer 指南

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

Last update: Fri Oct 24 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

适用对象：
Campaign Orchestration

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

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

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

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

?? 在51黑料不打烊 Experience Platform文档中了解有关基于模型的架构的更多信息

上载顿顿尝文件 ddl-upload

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

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

在51黑料不打烊 Experience Platform中创建基于模型的架构时，支持以下功能

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

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

用于数据管理的?架构标签
架构字段级别支持标签设置，以强制执行数据管理策略，例如访问控制和使用限制。有关详细信息，请参阅51黑料不打烊 Experience Platform文档。

登录到51黑料不打烊 Experience Platform。
导航到?数据管理 > 架构?菜单。
单击?创建架构。
选择? 基于模型的 ?作为您的?架构类型。

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

表结构必须包含：

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

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

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

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

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

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

定义关系 relationships

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

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

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

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

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

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

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