- 最新动态
- 功能总览
- 产品介绍
- 计费说明
- 快速入门
- 控制台操作指南
-
数据建模引擎用户指南
- 设计态使用指南
- 运行态使用指南
- 流程引擎使用指南
- 数字主线引擎用户指南
- 最佳实践
- 开发指南
-
API参考
- 使用前必读
- API概览
- 如何调用API
-
API
- 应用管理
- 运行服务管理
-
数据建模引擎
- 基础数据服务
-
版本服务
- 管理员更新M-V模型数据实例
- 管理员批量更新M-V模型数据实例
- 管理员撤销检出M-V模型数据实例
- 管理员批量撤销检出M-V模型数据实例
- 获取指定M-V模型实例的版本列表
- 获取指定版本的M-V模型实例数据
- 检出M-V模型数据实例
- 批量检出M-V模型数据实例
- 检出并更新M-V模型
- 批量检出并更新M-V模型
- 撤销检出M-V模型数据实例
- 批量撤销检出M-V模型数据实例
- 检入M-V模型数据实例
- 批量检入M-V模型数据实例
- 更新并检入M-V模型数据实例
- 批量更新并检入M-V模型数据实例
- 修订M-V模型数据实例
- 批量修订M-V模型数据实例
- 修订并更新M-V模型数据实例
- 批量修订并更新M-V模型数据实例
- 批量升级M-V模型实例的版本号
- 删除版本对象下最新分支的最新版本实例数据
- 软删除版本对象下最新分支的最新版本实例数据
- 删除最新大版本下的所有小版本
- 批量删除最新大版本下的所有小版本
- 软删除M-V模型实例下最新分支的所有小版本数据
- 批量软删除最新大版本下的所有小版本
- 对比M-V模型实例
- 失效管理
- 业务编码生成器
- 标签管理
- 生命周期管理
- 系统版本
- 多维视图和多维分支
- 关系实体服务
- 树形结构
- 流程引擎
- 应用示例
- 权限和授权项
- 附录
- SDK参考
-
常见问题
- 一般性相关问题
- 计量计费相关问题
-
数据建模引擎相关问题
- 设计态与运行态有什么区别?
- 为什么无法登录应用运行态?
- 为什么用户管理中会有“用户不存在”的用户?
- 为什么登录应用运行态时提示“缺少参数或参数错误”?
- 为什么设置输入型参数时提示安全校验失败?
- 应用发布后,在运行态为什么看不到构建的模型数据?
- 如何验证已设置的用户权限已生效?
- 什么是XDM应用?
- 什么是M-V模型?
- 数据建模引擎支持哪些属性类型?
- 枚举、合法值和参考对象的区别是什么?
- 入图和不入图有什么不同?
- 数据建模引擎支持哪些层级的缓存?
- 如何进行应用同步?
- 可以通过API方式使用应用设计态吗?
- 体验版数据建模引擎和基础版数据建模引擎提供的API有什么不同?
- 如何查看数据建模引擎的版本号?
- 如何避免数据模型互相引用形成环?
- 使用JDK 17版本应用运行态时,服务编排存在哪些约束与限制?
-
数字主线引擎相关问题
- 什么是企业租户和应用租户?
- 创建实体时选择构建表的作用是什么?
- 复杂实体属性太多,创建麻烦怎么办?
- 什么是源端映射和目标端映射?
- 什么是增量字段?
- 关系型数据库映射配置中DelFlag字段的作用是什么?
- 创建数据质量任务时,怎么选不出数据实体?
- 为什么LinkX-F中xDM-F来源的实例数据的最后更新时间显示与xDM-F中不一致
- 什么是入图调度的数据起止时间和数据分片间隔?
- 聚合服务编排中非纯脚本服务选择入参时,提示错误“初始数据实体必填入参为空,请选择必填入参”?
- 发布聚合服务后生成的API如何调用?
- 调用聚合服务时提示“查找不到该企业用户”
- 为什么操作时提示WSF参数校验失败?
- 描述类信息中输入英文双引号导致系统错误提示
- 全量数据服务API相关问题
- 文档下载
- 通用参考
链接复制成功!
创建关系实体
实体新增方式概述
系统提供多种方式生成关系实体,包括自定义实体参数、集成xDM-F模型、逆向建模和导入关系实体。新创建的实体状态处在“正在工作”中。
- 自定义实体参数:自定义实体相关参数生成实体模型。
- 集成xDM-F模型:集成xDM-F应用下的模型自动生成正在工作的LinkX-F实体,快速同步xDM-F模型定义与属性信息。
- 逆向建模:将用户已有数据库的数据转换为模型,快速复刻复杂实体及实体对应的多个属性。
- 导入关系实体:通过上传xlsx文件,一次性批量导入实体及其属性。
前提条件
已获取开发人员及以上权限用户的账号和密码。
通过自定义参数方式创建实体
- 登录LinkX-F系统首页。
- 选择“模型设计 > 数据模型管理”,默认进入“数据实体”页面。
- 在左侧导航栏选择“关系实体”,进入“关系实体”页面。
- 单击“创建”,弹出“创建关系实体”页面。
- 填写基本信息和物理表信息,如表1和表2所示:
图1 关系实体配置示例
表1 基本信息 参数
说明
英文名称
必填,需以大写字母开头,只能包含字母和数字和"_",长度不能超过 256 个字符。
中文名称
必填,必须以中文或者字母开头,且只能包含中文、字母、数字、下划线,长度不能超过 128 个字符。
英文描述
非必填,不能包含中文字符,长度不能超过 1024 个字符。
中文描述
非必填,可包含中文、英文、数字、特殊字符和空格,长度不能超过 1024 个字符。
责任人
必填,选择实体责任人。
是否实体
必填,可选“是”或“否”。
- 选择“是”:实体关系,有属性,对于两端的数据实体实例,多对多。
- 选择“否”:非实体关系,也称为普通关系,关系本身没有属性,对于两端的数据实体实例,多对一。
注意:
创建非实体关系时,需保证源端数据实体存在关联属性。当源端数据实体选择集成xDM-F模型生成的LinkX-F数据实体时,请提前将该数据实体自定义属性中的入图属性的“是否关联属性”值改为是。
源端数据实体
来源于“数据模型管理 > 数据实体”中的数据实体。
源端关联属性
根据“是否实体”选择不同,源端关联属性可选项不同。
- 当为实体关系时,表示多对多关系,源端关联属性只能设置为唯一键属性。
- 当为非实体关系时,源端关联属性只可选关联属性,关联属性表示多对一关系。
关系名称
自动写入已填写的“英文名称”。
目标端数据实体
来源于“数据模型管理 > 数据实体”中的数据实体。
目标端关联属性
目标端关联属性必须为唯一键属性。
源系统
非必填,来源于“基础数据管理 > 源系统”中的数据。
- 填写完后单击“保存”。
通过同步xDM-F方式创建实体
通过xDM-F同步任务,可以将xDM-F关系实体模型及其属性信息同步至LinkX-F系统。这样可以快速生成与xDM-F模型相对应的LinkX-F关系实体,这些实体的状态处在“正在工作”中。这些实体被存放在指定租户下,且“模型来源”值显示为“xDM-F”。
集成xDM-F模型生成的LinkX-F实体,存在以下修改限制:
- 在“基本信息”中,不支持对“责任人”、“源系统”、“是否主数据”、“产品阶段”和“标签”外的其他字段进行修改。
- 在“关系实体属性”中,仅支持上移、下移、置顶对应的自定义属性,其他操作均不支持(如新增、修改、删除、生效、失效等)。
关系类型 |
同步规则说明 |
---|---|
实体关系 |
仅同步xDM-F模型对应“基本信息”中“同步至LinkX-F”为“是”、“模型分类”为“业务数据模型”的关系实体。同时,实体属性会被全部同步,并根据xDM-F实体属性是否“入图”自动映射写入对应LinkX-F实体属性的“是否入图”值。但如果属性是唯一键或关联属性,不论xDM-F实体属性是否“入图”,LinkX-F实体发布后都会自动为对应属性配置图数据库映射字段,后续自动入图。 |
非实体关系 |
仅当同步过来的源端和目标端数据实体存在关联,且其中有类型为“参考对象”的扩展属性或基本属性时,LinkX-F系统会自动生成相关的非实体关系。非实体关系命名规则为{源端数据实体英文名称}_ForeignKey_{目标端数据实体英文名称}_{源端数据实体属性的英文名称}。 |
关于如何同步xDM-F应用下模型数据,详细可参见xDM-F数据同步功能使用指引。
通过逆向建模方式创建实体
逆向建模是指将用户已有关系型数据库的物理表转换为模型,通过逆向建模生成的数据实体默认关联物理表,保存后不可修改。
在配置逆向建模生成实体时,您也可选择根据已识别出的物理表间的单列外键约束关系自动创建非实体类的关系实体。
通过逆向建模方式生成的数据实体和非实体关系模型,其模型名称根据规则自动生成,说明如下:
- 数据实体名称同{物理表名},非实体关系名称组合显示规则为{源端物理表名}_{源端外键}_{目标端物理表名}_{目标端主键}。
- 系统会自动校验名称中是否存在非法字符以及名称是否重复。
如果存在非法字符,则按照中英文名称的规范要求,去除名称中的非法字符;如果首个字符非字母,则自动在数据实体名称前添加“DM_”前缀,非实体关系名称前添加“RM_”前缀。如果存在重名,则自动在名称后添加“_01”、“_02”等数字后缀。
通过逆向建模方式生成的数据模型的属性会自动适配LinkX-F中的系统基本属性和自定义属性,规则如下:
- 如果数据库字段与LinkX-F中系统基本属性的英文名称(不区分大小写)及类型相同,则与系统基本属性匹配。
- 如果数据库字段与LinkX-F中系统基本属性的英文名称不相同,则自动匹配为自定义属性。
- 如果数据库字段与LinkX-F中系统基本属性的英文名称相同(不区分大小写),但类型不同,则自动匹配为自定义属性,并在属性英文名称后添加“_01”、“_02”等数字后缀,且为属性中文名称写入和英文名称相同的值 。
- 如果自定义属性中属性的英文名称有重复,则自动在英文名称后添加“_01”、“_02”等数字后缀。如果自定义属性中属性的中文名称和系统基本属性的中文名称重复,则自动在自定义属性中文名称后添加“_01”、“_02”等数字后缀。
- 如果数据库字段有中文字符,那么在适配LinkX-F属性时,则会自动去除英文名称以及英文描述中的非法中文字符。
- 登录LinkX-F系统首页。
- 选择“模型设计 > 数据模型管理”,默认进入“数据实体”页面。
- 在左侧导航栏选择“关系实体”,进入“关系实体”页面。
- 单击列表上方“逆向建模”,弹出“逆向建模”窗口。
- 填写参数信息,如表4所示:
- (可选)单击“采集元数据”,系统自动获取所选数据源下的所有物理表。
当关系型数据库下的物理表较上一次采集有更新时,您可通过“采集元数据”获取最新的物理表。
- 在物理表列表中,勾选所需物理表,单击“下一步”。
您也可单击字段旁的
,执行条件筛选,并基于筛选结果勾选物理表。
说明:
支持选择已创建过实体的物理表来重复创建实体,且选中物理表的数量单次不能超过20个。
- 在物理表关系建模阶段,选择是否“识别主外键关系并建模”。
- 选“是”时,物理表关系列表中展示已勾选物理表范围内识别到的主外键关系,后续会根据已勾选物理表创建相应的数据实体,并根据已识别出的物理表间的单列外键约束关系,基于已创建的数据实体自动创建非实体类关系实体。
说明:
单列外键约束是指外键关联的字段只有一个,通常用于建立单一字段的关联关系。例如,在一个订单表中,可以使用单列外键将订单表中的“客户ID”列与客户表中的“客户ID”列建立关联,以表示订单与客户之间的关联关系。
- 选“否”时,不会去识别已勾选物理表间的单列外键约束关系,后续仅会根据已勾选物理表创建相应的数据实体。
- 选“是”时,物理表关系列表中展示已勾选物理表范围内识别到的主外键关系,后续会根据已勾选物理表创建相应的数据实体,并根据已识别出的物理表间的单列外键约束关系,基于已创建的数据实体自动创建非实体类关系实体。
- 单击“确定”,弹出逆向建模生成结果窗口。
如果逆向建模生成结果弹窗显示,数据实体生成成功,而关系实体生成异常时,建议您通过自定义参数方式手动创建异常的非实体关系,详细操作步骤可参考通过自定义参数方式创建实体。图2 逆向建模生成结果
通过导入文件方式创建实体
您可通过导入文件方式来批量新增实体,导入实体之前需先获取模板。还可进入“我的工作空间 > 导入任务”查看已创建的导入任务进行状态(详细请参见我的导入任务)。
在导入文件时,系统会根据关系实体编码是否为空,来决定对即将导入的关系实体执行新增还是更新操作。
- 如果关系实体编码为空,则进行新增操作。
- 如果关系实体编码不为空,则进行更新操作。在更新关系实体时,系统会自动校验实体是否属于当前租户,并检查实体状态是否为正在工作状态。