创建关系实体

实体新增方式概述

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

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

前提条件

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

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

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

   表1 基本信息

   参数	说明
   英文名称	必填，需以大写字母开头，只能包含字母和数字和"_"，长度不能超过 256 个字符。
   中文名称	必填，必须以中文或者字母开头，且只能包含中文、字母、数字、下划线，长度不能超过 128 个字符。
   英文描述	非必填，不能包含中文字符，长度不能超过 1024 个字符。
   中文描述	非必填，可包含中文、英文、数字、特殊字符和空格，长度不能超过 1024 个字符。
   责任人	必填，选择实体责任人。
   是否实体	必填，可选“是”或“否”。 选择“是”：实体关系，有属性，对于两端的数据实体实例，多对多。 选择“否”：非实体关系，也称为普通关系，关系本身没有属性，对于两端的数据实体实例，多对一。 注意： 创建非实体关系时，需保证源端数据实体存在关联属性。当源端数据实体选择集成xDM-F模型生成的LinkX-F数据实体时，请提前将该数据实体自定义属性中的入图属性的“是否关联属性”值改为是。
   源端数据实体	来源于“数据模型管理 > 数据实体”中的数据实体。
   源端关联属性	根据“是否实体”选择不同，源端关联属性可选项不同。 当为实体关系时，表示多对多关系，源端关联属性只能设置为唯一键属性。 当为非实体关系时，源端关联属性只可选关联属性，关联属性表示多对一关系。
   关系名称	自动写入已填写的“英文名称”。
   目标端数据实体	来源于“数据模型管理 > 数据实体”中的数据实体。
   目标端关联属性	目标端关联属性必须为唯一键属性。
   源系统	非必填，来源于“基础数据管理 > 源系统”中的数据。

   表2 物理表信息

   参数	说明
   是否构建表	可选“不构建表”或“构建物理表”，默认为“不构建表”。 不构建表：不自动构建表。 构建物理表：首次发布关系实体后将自动在整合层构建物理表，并生成数据库映射。
   数据源	仅当“是否构建表”选“构建物理表”时显示且必填。
   Schema	仅当“是否构建表”选“构建物理表”时显示且必填，根据已选“数据源”下拉选择Schema。
   表名称	仅当“是否构建表”选“构建物理表”时显示且必填。数据库表名，必须以字母开头，且只能包含字母、数字和"_"，不能与其他实体的表名称重复，长度不能超过22个字符。

6. 填写完后单击“保存”。

通过同步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属性时，则会自动去除英文名称以及英文描述中的非法中文字符。

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

   表4 参数信息

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

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

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

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

   

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

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

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

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

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

   图2 逆向建模生成结果
   

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

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

在导入文件时，系统会根据关系实体编码是否为空，来决定对即将导入的关系实体执行新增还是更新操作。

• 如果关系实体编码为空，则进行新增操作。
• 如果关系实体编码不为空，则进行更新操作。在更新关系实体时，系统会自动校验实体是否属于当前租户，并检查实体状态是否为正在工作状态。

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

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

5. 填写模板文件。

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

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