- 最新动态
- 功能总览
- 产品介绍
- 计费说明
- 快速入门
- 控制台操作指南
-
数据建模引擎用户指南
- 设计态使用指南
- 运行态使用指南
- 流程引擎使用指南
- 数字主线引擎用户指南
- 最佳实践
- 开发指南
-
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个字符。
责任人
选择数据实体的责任人。
必填,下拉可选值来源于“用户权限管理”中已添加的用户。
关联领域
选择数据实体的关联领域。
非必填,下拉可选值来源于“基础数据管理 > 领域”的数据。
源系统
选择数据实体的源系统。
非必填,来源于“基础数据管理 > 源系统”中的数据。
是否主数据
在“数据模型图谱”中,此数据实体是否作为主数据节点显示。
必填,可选“是”或“否”。
产品阶段
数据实体在产品全生命周期中所处的阶段。
必填,下拉可选值:“分析态”、“设计态”、“生产态”、“运行态”。
表2 物理表信息 参数
说明
是否构建表
必填,可选“不构建表”、“构建物理表”或“关联物理表”,默认为“不构建表”。
- 不构建表:指先生成一个逻辑实体,在后续发布后需新增关系型数据库映射与数据库中的物理表进行映射。
- 构建物理表:基于定义的实体和属性在数据库中建立数据表,发布后自动生成对应的关系型数据库映射。
- 关联物理表:根据关联的物理表生成数据实体、属性及映射信息。
数据源
仅当“是否构建表”选“构建物理表”时才显示且必填。
Schema
指关系型数据库中的表结构,定义了表中的列名、数据类型、约束条件等信息。一个关系型数据库可以包含多个Schema,每个Schema包含多个表。
仅当“是否构建表”选“构建物理表”时才显示且必填,根据已选“数据源”下拉选择Schema。
表名称
数据库表名。必须以字母开头,只能包含字母、数字和"_",且不能与其他实体的表名称重复,长度限制为26个字符。
仅当“是否构建表”选“构建物理表”时才显示且必填。
物理表
仅当“是否构建表”选“关联物理表”时才显示且必填。单击输入框弹出“选择物理表”弹框。
- 数据库类型:选择数据库类型,包括Oracle、PostgreSQL、MySQL、SQL Server。
- 数据源名称:只可选择有权限的数据源。
- Schema:下拉自定义选择。
- 物理表:输入物理表名称。
- 单击“保存”。
通过同步xDM-F方式创建实体
通过xDM-F同步任务,可以将xDM-F数据实体模型及其属性信息同步至LinkX-F系统。这样可以快速生成与xDM-F模型相对应的LinkX-F数据实体,这些实体的状态处在“正在工作”中。这些实体被存放在指定租户下,且“模型来源”值显示为“xDM-F”。
集成xDM-F模型生成的LinkX-F数据实体,存在以下修改限制:
- 在“基本信息”中,不支持对“责任人”、“关联领域”、“源系统”、“是否主数据”、“产品阶段”和“标签”外的其他字段进行修改。
- 在“数据实体属性”中,仅支持上移、下移、置顶对应的自定义属性,其他操作均不支持(如新增、修改、删除、生效、失效等)。
关于如何同步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系统首页。
- 选择“模型设计 > 数据模型管理”,默认进入“数据实体”页面。
- 单击列表上方“逆向建模”,弹出“逆向建模”窗口。
- 填写参数信息,如表3所示:
图2 逆向建模配置示例
- (可选)单击“采集元数据”,系统自动获取所选数据源下的所有物理表。
当关系型数据库下的物理表较上一次采集有更新时,您可通过“采集元数据”获取最新的物理表。
- 在物理表列表中,勾选所需物理表,单击“下一步”。
您也可单击字段旁的
,执行条件筛选,并基于筛选结果勾选物理表。
说明:
支持选择已创建过实体的物理表来重复创建实体,且选中物理表的数量单次不能超过20个。
- 在物理表关系建模阶段,选择是否“识别主外键关系并建模”。
- 选“是”时,物理表关系列表中展示已勾选物理表范围内识别到的主外键关系,后续会根据已勾选物理表创建相应的数据实体,并根据已识别出的物理表间的单列外键约束关系,基于已创建的数据实体自动创建非实体类关系实体。
说明:
单列外键约束是指外键关联的字段只有一个,通常用于建立单一字段的关联关系。例如,在一个订单表中,可以使用单列外键将订单表中的“客户ID”列与客户表中的“客户ID”列建立关联,以表示订单与客户之间的关联关系。
- 选“否”时,不会去识别已勾选物理表间的单列外键约束关系,后续仅会根据已勾选物理表创建相应的数据实体。
- 选“是”时,物理表关系列表中展示已勾选物理表范围内识别到的主外键关系,后续会根据已勾选物理表创建相应的数据实体,并根据已识别出的物理表间的单列外键约束关系,基于已创建的数据实体自动创建非实体类关系实体。
- 单击“确定”,弹出逆向建模生成结果窗口。
如果逆向建模生成结果弹窗显示,数据实体生成成功,而关系实体生成异常时,建议您通过自定义参数方式手动创建异常的非实体关系,详细操作步骤可参考通过自定义参数方式创建实体。图3 逆向建模生成结果
通过导入文件方式创建实体
您可通过导入文件方式来批量新增实体,导入实体之前需先获取模板。还可进入“我的工作空间 > 导入任务”查看已创建的导入任务进行状态(详细请参见我的导入任务)。
在导入文件时,系统会根据数据实体编码是否为空,来决定对即将导入的数据实体执行新增还是更新操作。
- 如果数据实体编码为空,则进行新增操作。
- 如果数据实体编码不为空,则进行更新操作。在更新数据实体时,系统会自动校验实体是否属于当前租户,并检查实体状态是否为正在工作状态。