创建数据实体

实体创建方式概述

系统提供多种方式生成数据实体，包括自定义实体参数、集成xDM-F模型、逆向建模或导入数据实体，新创建的实体状态处在“正在工作”中。

• 自定义实体参数：自定义实体相关参数生成实体模型。
• 同步xDM-F模型：集成xDM-F应用下的模型自动生成正在工作的LinkX-F实体，快速同步xDM-F模型定义与属性信息。
• 逆向建模：将用户已有数据库的数据转换为模型，快速复刻复杂实体及实体对应的多个属性。
• 导入数据实体：通过上传xlsx文件，一次性批量导入实体及其属性。

前提条件

已获取开发人员及以上权限用户的账号和密码。

通过自定义参数方式创建实体

1. 登录LinkX-F系统首页。
2. 选择“模型设计 > 数据模型管理”，默认进入“数据实体”页面。
3. 单击“创建”，弹出“创建数据实体”页面。
4. 填写基本信息和物理表信息，如表1和表2所示。
   图1 数据实体创建示例
   

   表1 基本信息

   参数	说明
   是否集成xDM-F	必填，默认为“否”，暂不支持修改。 表示用户自定义实体参数建立模型。
   英文名称	必填，需以大写字母开头，只能包含字母和数字和"_"，长度不能超过256个字符。
   中文名称	必填，必须以中文或者字母开头，且只能包含中文、字母、数字、下划线，长度不能超过128个字符。
   英文描述	填写实体的简单英文描述信息。 非必填，不能包含中文字符，长度不能超过1024个字符。
   中文描述	填写实体的简单中文描述信息。 必填，可包含中文、英文、数字、特殊字符和空格，长度不能超过1024个字符。
   责任人	必填，选择实体责任人。
   所属领域	必填，选择实体所属领域，下拉可选值来源于“基础数据管理 > 领域”的数据。
   源系统	非必填，来源于“基础数据管理 > 源系统”中的数据。
   是否主数据	必填，可选“是”或“否”。 选择“是”：即主数据节点，可选任意领域对应的数据源，且在“数据模型图谱”中显示为主数据节点。 选择“否”：即非主数据节点，只能选择数据实体所属领域对应的数据源。
   产品阶段	实体在产品全生命周期中所处的阶段。 必填，下拉可选值：“分析态”、“设计态”、“生产态”、“运行态”。

   表2 物理表信息

   参数	说明
   是否构建表	必填，可选“不构建表”、“构建物理表”或“关联物理表”，默认为“不构建表”。 不构建表：指先生成一个逻辑实体，在后续发布后需新增关系型数据库映射与数据库中的物理表进行映射。 构建物理表：基于定义的实体和属性在数据库中建立数据表，发布后自动生成关系型数据库映射。 关联物理表：根据关联的物理表生成数据实体、属性及映射信息。仅当“是否集成xDM-F”选择“否”时，才显示此项并可选。
   数据源	仅当“是否构建表”选“构建物理表”时才显示且必填。
   Schema	指关系型数据库中的表结构，定义了表中的列名、数据类型、约束条件等信息。一个关系型数据库可以包含多个Schema，每个Schema包含多个表。 仅当“是否构建表”选“构建物理表”时才显示且必填，根据已选“数据源”下拉选择Schema。
   表名称	数据库表名。仅当“是否构建表”选“构建物理表”时才显示且必填。 必须以字母开头，只能包含字母、数字和"_"，且不能与其他实体的表名称重复，长度限制为26个字符。
   物理表	仅当“是否构建表”选“关联物理表”时才显示且必填。单击输入框弹出“选择物理表”弹框。 数据库类型：选择数据库类型，包括Oracle、PostgreSQL、MySQL、SQL Server。 数据源名称：只可选择有权限的数据源。 Schema：下拉自定义选择。 物理表：输入物理表名称。

5. 单击“保存”。

通过同步xDM-F方式创建实体

通过xDM-F同步任务，将xDM-F数据实体模型及其属性信息同步至LinkX-F系统，快速自动生成对应xDM-F模型的LinkX-F数据实体，状态处在“正在工作”中。此类实体“是否集成xDM-F”值为“是”且存放在指定租户下。

集成xDM-F模型生成的LinkX-F数据实体，存在以下修改限制：

• 在“基本信息”中，不支持对“责任人”、“所属领域”、“源系统”、“是否主数据”、“产品阶段”和“标签”外的其他字段进行修改。
• 在“数据实体属性”中，仅支持上移、下移、置顶对应的自定义属性，其他操作均不支持（如新增、修改、删除、生效、失效等）。

关于如何同步xDM-F应用下模型数据，详细可参见数据同步功能使用指引。

通过逆向建模方式创建实体

逆向建模是指将用户已有关系型数据库的物理表转换为模型，通过逆向建模生成的数据实体默认关联物理表，保存后不可修改。

在配置逆向建模生成实体时，您也可选择根据已识别出的物理表间的单列外键约束关系自动创建非实体类的关系实体。

通过逆向建模方式生成的数据实体和非实体关系模型，其模型名称根据规则自动生成，说明如下：

• 数据实体名称同{物理表名}，非实体关系名称组合显示规则为{源端物理表名}_{源端外键}_{目标端物理表名}_{目标端主键}。
• 系统会自动校验名称中是否存在非法字符以及名称是否重复。

  如果存在非法字符，则按照中英文名称的规范要求，去除名称中的非法字符；如果首个字符非字母，则自动在数据实体名称前添加“DM_”前缀，非实体关系名称前添加“RM_”前缀。如果存在重名，则自动在名称后添加“_01”、“_02”等数字后缀。

通过逆向建模方式生成的数据模型的属性会自动适配LinkX-F中的系统基本属性和自定义属性，规则如下：

• 如果数据库字段与LinkX-F中系统基本属性的英文名称（不区分大小写）及类型相同，则与系统基本属性匹配。
• 如果数据库字段与LinkX-F中系统基本属性的英文名称不相同，则自动匹配为自定义属性。
• 如果数据库字段与LinkX-F中系统基本属性的英文名称相同（不区分大小写），但类型不同，则自动匹配为自定义属性，并在属性英文名称后添加“_01”、“_02”等数字后缀，且为属性中文名称写入和英文名称相同的值 。
• 如果自定义属性中属性的英文名称有重复，则自动在英文名称后添加“_01”、“_02”等数字后缀。如果自定义属性中属性的中文名称和系统基本属性的中文名称重复，则自动在自定义属性中文名称后添加“_01”、“_02”等数字后缀。
• 如果数据库字段有中文字符，那么在适配LinkX-F属性时，则会自动去除英文名称以及英文描述中的非法中文字符。

1. 登录LinkX-F系统首页。
2. 选择“模型设计 > 数据模型管理”，默认进入“数据实体”页面。
3. 单击列表上方“逆向建模”，弹出“逆向建模”窗口。
4. 填写参数信息，如表3所示：
   图2 逆向建模配置示例
   

   表3 参数信息

   参数	说明
   所属领域	必填，选择所属领域，下拉可选值来源于“基础数据管理 > 领域”的数据。
   数据库类型	必填，选择关系型数据库类型，可选Oracle、PostgreSQL、MySQL、SQL Server。
   数据源名称	必填，只可选择当前租户下的数据源。 下拉可选值来源于“基础数据管理 > 数据源”中的数据。
   Schema	必填，Schema类似于分区。

5. （可选）单击“采集元数据”，系统自动获取所选数据源下的所有物理表。

   当关系型数据库下的物理表较上一次采集有更新时，您可通过“采集元数据”获取最新的物理表。

6. 在物理表列表中，勾选所需物理表，单击“下一步”。
   您也可单击字段旁的，执行条件筛选，并基于筛选结果勾选物理表。

   

   支持选择已创建过实体的物理表来重复创建实体，且选中物理表的数量单次不能超过20个。

7. 在物理表关系建模阶段，选择是否“识别主外键关系并建模”。
   • 选“是”时，物理表关系列表中展示已勾选物理表范围内识别到的主外键关系，后续会根据已勾选物理表创建相应的数据实体，并根据已识别出的物理表间的单列外键约束关系，基于已创建的数据实体自动创建非实体类关系实体。
     

     单列外键约束是指外键关联的字段只有一个，通常用于建立单一字段的关联关系。例如，在一个订单表中，可以使用单列外键将订单表中的“客户ID”列与客户表中的“客户ID”列建立关联，以表示订单与客户之间的关联关系。

   • 选“否”时，不会去识别已勾选物理表间的单列外键约束关系，后续仅会根据已勾选物理表创建相应的数据实体。

8. 单击“确定”，弹出逆向建模生成结果窗口。
   如果逆向建模生成结果弹窗显示，数据实体生成成功，而关系实体生成异常时，建议您通过自定义参数方式手动创建异常的非实体关系，详细操作步骤可参考通过自定义参数方式创建实体。

   图3 逆向建模生成结果
   

通过导入文件方式创建实体

您可通过导入文件方式来批量新增实体，导入实体之前需先获取模板。还可进入“我的工作空间 > 导入任务”查看已创建的导入任务进行状态（详细请参见我的导入任务）。

1. 登录LinkX-F系统首页。
2. 选择“模型设计 > 数据模型管理”，默认进入“数据实体”页面。
3. 获取模板。

   在列表上方选择“数据实体批量操作 > 下载空模板”。

4. 填写模板文件。

   根据3获取模板文件，填写信息后保存。

5. 导入数据实体。
   1. 在列表上方选择“数据实体批量操作 > 批量导入”，弹出批量导入页面。
   2. 选取4中提前准备好的文件，单击“确认上传”。