创建关系实体

实体新增方式概述

系统提供多种方式生成关系实体，包括自定义实体参数、集成xDM-F模型信息、逆向建模、导入关系实体等。

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

前提条件

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

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

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

   表1 基本信息

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

   表2 物理表信息

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

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

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

通过xDM-F同步任务，可以将xDM-F数据实体模型及其属性信息同步至LinkX-F系统，从而快速生成与xDM-F模型相对应的LinkX-F关系实体。这些实体被存放在指定租户下，状态为“正在工作”，“模型来源”显示为“xDM-F”。有关如何同步xDM-F应用下模型数据，请参考xDM-F数据同步功能使用指引。

请注意，xDM-F来源的关系实体存在以下修改限制：

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

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

逆向建模是指将用户已有关系型数据库的物理表转换为模型，通过逆向建模生成的数据实体默认关联物理表，保存后不可修改。配置逆向建模生成数据实体时，既能根据已识别的物理表间的单列外键约束关系自动创建非实体类关系，也能手动添加确认物理表间的关联关系，生成关系实体。

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

• 数据实体名称显示为{物理表名}，非实体关系名称显示为{数据库中的外键约束名称}。
• 系统会自动校验名称中是否存在非法字符以及名称是否重复。如果存在非法字符，将按照中英文名称的规范要求去除名称中的非法字符；如果首字符非字母，则会在数据实体名称前添加“DM_”前缀；如果名称重复，则会在其后添加“_01”、“_02”等后缀。

逆向建模生成的数据模型属性将自动与LinkX-F中的系统基本属性及自定义属性进行适配，规则如下：

• 在适配LinkX-F属性时，如果数据库字段的英文名称（不区分大小写）及类型与LinkX-F中的系统基本属性一致时，则被视为系统基本属性；如果英文名称不相同，则被视为自定义属性；如果英文名称相同但类型不同，也会被视为自定义属性，并在属性英文名称后添加“_01”、“_02”等后缀，同时使属性的中文名称与英文名称显示相同 。
• 在适配LinkX-F属性时，如果数据库字段含中文字符，将自动移除英文名称以及英文描述中的非法中文字符；如果自定义属性的英文名称重复，则自动在其后添加“_01”、“_02”等后缀；如果自定义属性和系统基本属性的中文名称重复，则自动在其后添加“_01”、“_02”等后缀。

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

   表4 参数信息

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

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

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

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

   

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

8. 在物理表关系建模阶段，单击“添加”，输入关系实体信息。
   如果勾选了“自动识别主外键关系”，系统将自动识别已勾选物理表间的单列外键约束关系，并生成相应的非实体关系信息，且仅关系实体的英文名称和中文名称支持修改。

   

   单列外键约束建立表与表之间的关联关系时，通过单个字段来作为外键进行关联。例如，在一个订单表中，通过单列外键将“客户ID”与客户表中的“客户ID”相关联，以表示订单与客户间的关联关系。

9. 单击“确定”，弹出逆向建模生成结果窗口。

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

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

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

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

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

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

5. 填写模板文件。

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

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