# 配置数据源映射 实体型关系发布后，如果想让实体模型实例化，可通过配置并发布源端映射来实现。****请注意，**应用租户中来自平台租户** 的引用模型**不支持该**配置。**** - **源** **端** **映射** ：实例数据来源，可提供实例数据入图的源端数据来源。支持多种类型，包括CSV文件、关系型数据库映射、API映射或xDM-F映射（仅适用于xDM-F来源的模型），其中CSV文件可在创建入图任务后直接上传。LinkX-F来源的实体发布后，支持配置关系型数据库映射和API映射，包括新增、修改、删除、发布、修订、作废等操作。**请注意，** **针对某些敏感信息字段（如身份证号、手机号、银行卡号、企业机密信息等），不应对该类字段进行映射配置。如必须时，应进行原始数据脱敏后再配置字段映射，实现敏感隐私数据的可靠保护，从而增强产品在数据安全和隐私保护方面的能力。** - **目标端** **映射**：数据入图的终点，提供实例数据入图的目标端图数据库。通过将实体属性与图数据库中的图标签属性进行对应，进而对数据实例实现从多类型源端数据源到图数据库的转换。 #### 前提条件 已获取开发人员及以上权限用户的账号和密码。 #### 配置关系型数据库映射（源端映射） 1. 登录LinkX-F系统首页。 2. 选择"模型设计 \> 数据模型管理"，默认进入"数据实体"页面。 3. 在左侧导航栏选择"关系实体"，进入"关系实体"页面。 4. 单击目标实体的"编码"，在弹出的详情页单击"数据源映射"页签，默认进入"源端映射"页签。 5. 在关系型数据库映射处单击"新增"，弹出数据库映射新增页。 6. 填写映射信息，如[表1]所示： 表1新增数据库映射参数说明 | 参数 | 说明 | |:---|:---| | 映射名称 | 必填，只能包含中文、英文字母、数字、"_"、"-"，且全局唯一，长度不能超过128个字符。 | | 数据源类型 | 必填，配置"关系型数据库"，包括Oracle、PostgreSQL、MySQL、SQL Server。 | | 数据源名称 | 必填，来源于"基础数据管理 \> 数据源"中的关系型数据库类型的数据源。 | | 数据库类型 | 根据"数据源名称"选择不同自动写入。 | | 抽取方式 | 必填，物理表和自定义SQL。 | | Schema | 下拉自定义选择。仅当"抽取方式"选"物理表"时显示该参数。 | | 自定义SQL | 填写SQL语句。仅当"抽取方式"选"自定义SQL"时显示该参数。 | | 表名 | 数据库表名，下拉可选值随"Schema"参数选择而变化。 | | 增量字段 | 必填，用于数据库表中支持增量更新数据的时间戳字段，必须选择数据库表中的时间类型的属性。 | | 源系统 | 非必填，在下拉框中选择源系统，可选值来源于"基础数据管理 \> 源系统"。 | 7. 填写完后单击"保存"。 8. 发布关系型数据库映射。 单击目标映射操作列处的![](https://support.huaweicloud.com/instg-idme/figure/zh-cn_image_0000001893893318.png)或通过"映射编码"链接进入详情页后单击"发布"， ![](https://support.huaweicloud.com/instg-idme/public_sys-resources/note_3.0-zh-cn.png) 新创建的关系型数据库映射要发布后才可生效。 作为后续输出关系型数据库的首选映射，其使用场景和配置规则如下： - **首选映射的使用场景**：主要作用于在数据实例中查询全量数据，在聚合服务中将非索引属性设置为出参。 - **首选映射的配置规则**：仅"抽取方式"为物理表的关系型数据库才可被作为首选映射。当已发布的第一条关系型数据库映射满足条件时，会自动被设置为首选映射项。 创建关系型数据库映射后，您可以对其进行一些相关操作，具体如下。 表2关系型数据库映射相关操作 | 操作 | 说明 | |:---|:---| | 修改关系型数据库映射 | 1. 进入关系型数据库映射编辑状态。 在"正在工作"映射后单击![](https://support.huaweicloud.com/instg-idme/figure/zh-cn_image_0000001935853025.png)或单击"映射名称"链接，在弹出的映射详情页单击"编辑"。 2. 修改映射信息后，单击"保存"。 | | 删除关系型数据库映射 | 勾选一条或多条"正在工作"的映射，单击"删除"。 | | 测试关系型数据库映射 | 1. 单击映射"操作"列处的![](https://support.huaweicloud.com/instg-idme/figure/zh-cn_image_0000001893733448.png)，弹出数据映射测试窗口。 2. 在"增量集成"处设置"数据条目数"、"起止时间"和"超时设置"等参数。 3. 单击"测试"，验证返回数据。 | | 修订关系型数据库映射 | 单击已发布的目标映射操作列处的![](https://support.huaweicloud.com/instg-idme/figure/zh-cn_image_0000001893893322.png)。 修订成功后即可复制一个"正在工作"状态的映射，其中"数据源类型"、"数据源名称"不可修改。 | | 作废关系型数据库映射 | 单击已发布的目标映射操作列处的![](https://support.huaweicloud.com/instg-idme/figure/zh-cn_image_0000001935853029.png)。 | | 查看建表语句 | 单击映射"操作"列处的![](https://support.huaweicloud.com/instg-idme/figure/zh-cn_image_0000002238663665.png)，查看建表语句。 | | 查看变更语句 | 单击映射"操作"列处的![](https://support.huaweicloud.com/instg-idme/figure/zh-cn_image_0000002203583300.png)，查看变更语句。 | #### 配置API映射（源端映射） 1. 登录LinkX-F系统首页。 2. 选择"模型设计 \> 数据模型管理"，默认进入"数据实体"页面。 3. 在左侧导航栏选择"关系实体"，进入"关系实体"页面。 4. 单击目标实体的"编码"，在弹出的详情页单击"数据源映射"页签，默认进入"源端映射"页签。 5. 在API映射处单击"新增"，弹出映射新增页。 6. 填写映射基本信息，如[表3]所示： 表3映射基本信息 | 参数 | 说明 | |:---|:---| | 映射名称 | 必填，需以大写字母开头，只能包含字母、数字和"_"，且不能与当前实体内的其他源系统API映射名称重复，长度不能超过128个字符。 | | 源系统 | 必填，来源于"基础数据管理 \> 源系统"。 | | API名称 | 必填，来源于"基础数据管理 \> 源系统API"。 | | 请求方式 | 根据"API名称"选择不同自动写入。 | | API URL | 根据"API名称"选择不同自动写入。 | 7. 配置API出入参映射。 表4配置API出入参映射 | 参数配置类型 | 操作方法 | 是否必须配置 | |:---|:---|:---| | API入参配置 | 从"API入参"处拖动字段至"系统入参"对应字段后的填写框中。 | 否 | | API出参配置 | 按需选择"数据根字段"后，从"API出参"处拖动字段至"实体属性映射"对应字段后的填写框中。**请注意，源端关联属性和目标端关联属性必须配置映射。** | 是 | 8. 配置完后单击"保存"。 9. 发布API映射。 单击目标映射操作列处的![](https://support.huaweicloud.com/instg-idme/figure/zh-cn_image_0000001893889166.png)或通过"映射编码"链接进入详情页后单击"发布"。 ![](https://support.huaweicloud.com/instg-idme/public_sys-resources/note_3.0-zh-cn.png) 新创建的API映射要发布后才可生效。 创建API映射后，您可以对其进行一些相关操作，具体如下。 表5API映射相关操作 | 操作 | 说明 | |:---|:---| | 修改API映射 | 1. 进入API映射编辑状态。 在"正在工作"映射后单击![](https://support.huaweicloud.com/instg-idme/figure/zh-cn_image_0000001893729278.png)或单击"映射名称"链接，在弹出的映射详情页单击"编辑"。 2. 修改映射信息后，单击"保存"。 | | 删除API映射 | 勾选一条或多条"正在工作"的映射，单击"删除"。 | | 测试API映射 | 1. 单击映射"操作"列处的![](https://support.huaweicloud.com/instg-idme/figure/zh-cn_image_0000001935848889.png)，弹出数据映射测试窗口。 2. 如未配置系统入参映射，只需通过手动输入或引用环境变量传入相应的请求参数值，单击"发送请求"进行测试。如有配置，还需设置开始时间和结束时间，确定分页大小和页码等信息。 | | 修订API映射 | 单击已发布的目标映射操作列处的![](https://support.huaweicloud.com/instg-idme/figure/zh-cn_image_0000001893889170.png)。 修订成功后即可复制一个"正在工作"状态的映射，其中源系统、API名称、API URL和请求类型等信息不可修改。 | | 作废API映射 | 单击已发布的目标映射操作列处的![](https://support.huaweicloud.com/instg-idme/figure/zh-cn_image_0000001893729282.png)。可能出现以下情况： - 如果当前映射未被入图任务引用，则能成功作废。 - 如果当前映射被入图任务引用，请按界面提示操作后再作废。 | #### 查看xDM-F映射（源端映射） xDM-F映射可作为后续数据实例入图的源端映射。根据xDM-F模型是否存在扩展属性以及扩展属性的类型不同，实体发布后会同时生成一个非扩展表类型和多个扩展表类型的"已发布"状态的xDM-F映射。 1. 登录LinkX-F系统首页。 2. 选择"模型设计 \> 数据模型管理"，默认进入"数据实体"页面。 3. 在左侧导航栏选择"关系实体"，进入"关系实体"页面。 4. 单击目标实体的"编码"，在弹出的详情页单击"数据源映射"页签，默认进入"源端映射"页签。 5. 在xDM-F映射处展示目标实体所有的xDM-F映射。单击目标映射的"映射编码"，弹出映射详情，关键参数信息说明如[表6]所示： 表6关键参数信息说明 | 参数 | 说明 | |:---|:---| | 映射名称 | xDM-F映射名称。 | | 是否扩展表 | 表示是否存在扩展属性。 | | xDM-F扩展类型 | 基于实体扩展，显示对应xDM-F实体的英文名称。 | | xDM-F物理表 | 根据xDM-F模型类型是否扩展模型以及是否存在扩展属性，xDM-F物理表的组成显示格式有所不同： - 如果是非扩展模型，非扩展表类型的组成显示格式为***{xDM-F应用名称* }_{*关系实体英文名称*}** **_REL** ，扩展表类型的组成显示格式为***{xDM-F应用名称}_{关系实体英文名称}{扩展属性类型}*** **{** **exavalue** **}**。 - 如果是扩展模型，非扩展表类型的组成显示格式为***{xDM-F应用名称* }_{*父模型名称*}_REL** ，扩展表类型的组成显示格式为***{xDM-F应用名称}_{关系实体英文名称}{扩展属性类型}* **{** **exavalue** **}****。 | #### 更新图数据库映射（目标端映射） 实体型关系发布后，系统会为其自动生成一个"已发布"的默认图数据库映射。当LinkX-F实体修订版更新属性（如新增、修改）或xDM-F来源的模型属性变更且发布后，该图数据库映射会自动更新。如果更新不及时，可参考本章节手动更新。 1. 登录LinkX-F系统首页。 2. 选择"模型设计 \> 数据模型管理"，默认进入"数据实体"页面。 3. 在左侧导航栏选择"关系实体"，进入"关系实体"页面。 4. 单击目标实体的"编码"，在弹出的详情页单击"数据源映射"页签，默认进入"源端映射"页签。 5. 切换至"目标端映射"页签。 6. 单击图数据库映射操作列处的![](https://support.huaweicloud.com/instg-idme/figure/zh-cn_image_0000002203980412.png)，手动更新图数据库映射。