- 最新动态
- 功能总览
- 产品介绍
- 计费说明
- 快速入门
- 控制台操作指南
-
数据建模引擎用户指南
- 设计态使用指南
- 运行态使用指南
- 流程引擎使用指南
- 数字主线引擎用户指南
- 最佳实践
- 开发指南
-
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相关问题
- 文档下载
- 通用参考
链接复制成功!
配置数据源映射
实体型关系发布后,如果想让实体模型实例化,可通过配置并发布源端映射来实现。如果后续想将实例数据入图,还需配置并发布目标端映射。
- 源端映射:实例数据来源,可提供实例数据入图的源端数据来源。支持多种类型,包括CSV文件、关系型数据库映射、API映射或xDM-F映射,其中CSV文件可在创建入图任务后直接上传。通过自定义参数、导入方式创建的实体发布后,支持配置关系型数据库映射和API映射,包括新增、修改、删除、发布、修订、作废等操作。集成xDM-F模型生成的LinkX-F实体发布后仅支持查看xDM-F映射。
须知:
针对某些敏感信息字段(如身份证号、手机号、银行卡号、企业机密信息等),不应对该类字段进行映射配置。如必须时,应进行原始数据脱敏后再配置字段映射,实现敏感隐私数据的可靠保护,从而增强产品在数据安全和隐私保护方面的能力。
- 目标端映射:数据入图的终点,提供实例数据入图的目标端图数据库。通过将实体属性与图数据库中的图标签属性进行对应,进而对数据实例实现从多类型源端数据源到图数据库的转换。
前提条件
已获取开发人员及以上权限用户的账号和密码。
配置关系型数据库映射(源端映射)
- 登录LinkX-F系统首页。
- 选择“模型设计 > 数据模型管理”,默认进入“数据实体”页面。
- 在左侧导航栏选择“关系实体”,进入“关系实体”页面。
- 单击目标实体的“编码”链接,在弹出的详情页单击“数据源映射”页签,默认进入“源端映射”页签。
- 在关系型数据库映射处单击“新增”,弹出数据库映射新增页。
- 填写映射信息,如表1所示:
表1 新增数据库映射参数说明 参数
说明
映射名称
必填,不能与其他数据库映射名称重复,长度不能超过128个字符。
数据源类型
必填,配置“关系型数据库”,包括Oracle、PostgreSQL、MySQL、SQL Server。
数据源名称
必填,来源于“基础数据管理 > 数据源”中的关系型数据库类型的数据源。
数据库类型
根据“数据源名称”选择不同自动写入。
抽取方式
必填,物理表和自定义SQL。
Schema
下拉自定义选择。仅当“抽取方式”选“物理表”时显示该参数。
自定义SQL
填写SQL语句。仅当“抽取方式”选“自定义SQL”时显示该参数。
表名
数据库表名,下拉可选值随“Schema”参数选择而变化。
增量字段
非必填,用于数据库表中支持增量更新数据的时间戳字段;只能选择数据库表中的时间型属性,无数据接入时无影响。
源系统
非必填,在下拉框中选择源系统,可选值来源于“基础数据管理 > 源系统”。
- 填写完后单击“保存”。
- 发布关系型数据库映射。
单击目标映射操作列处的
或通过“映射编码”链接进入详情页后单击“发布”,
说明:
新创建的关系型数据库映射要发布后才可生效。
作为后续输出关系型数据库的首选映射,其使用场景和配置规则如下:
- 首选映射的使用场景:主要作用于在数据实例中查询全量数据,在聚合服务中将非索引属性设置为出参,在数据入图对账中统计整合层数据量。
- 首选映射的配置规则:仅“抽取方式”为物理表的关系型数据库才可被作为首选映射。当已发布的第一条关系型数据库映射满足条件时,会自动被设置为首选映射项。
创建关系型数据库映射后,您可以对其进行一些相关操作,具体如下。表2 关系型数据库映射相关操作 操作
说明
修改关系型数据库映射
删除关系型数据库映射
勾选一条或多条“正在工作”的映射,单击“删除”。
测试关系型数据库映射
- 单击映射“操作”列处的
,弹出数据映射测试窗口。
- 在“增量集成”处设置“数据条目数”、“起止时间”和“超时设置”等参数。
- 单击“测试”,验证返回数据。
修订关系型数据库映射
单击已发布的目标映射操作列处的
。
修订成功后即可复制一个“正在工作”状态的映射,其中“数据源类型”、“数据源名称”不可修改。
作废关系型数据库映射
单击已发布的目标映射操作列处的
。
配置API映射(源端映射)
- 登录LinkX-F系统首页。
- 选择“模型设计 > 数据模型管理”,默认进入“数据实体”页面。
- 在左侧导航栏选择“关系实体”,进入“关系实体”页面。
- 单击目标实体的“编码”链接,在弹出的详情页单击“数据源映射”页签,默认进入“源端映射”页签。
- 在API映射处单击“新增”,弹出映射新增页。
- 填写映射信息,如表3所示:
表3 映射信息 参数
说明
基本信息
映射名称
必填,必须以大写字母开头,且只能包含字母、数字、下划线,
不能与当前实体内其他源系统API映射名称重复,长度不能超过128个字符。
源系统
必填,来源于“基础数据管理 > 源系统”。
API名称
必填,来源于“基础数据管理 > 源系统API”,根据“源系统”选择不同可选的下拉值不同,只可选API类型为“纯关系API”的源系统API。
API类型
根据“API名称”选择不同自动写入。
API URL
根据“API名称”选择不同自动写入。
映射类型
根据“API名称”选择不同自动写入。
映射配置
API出参
根据“API名称”选择显示对应API的出参。
数据实体属性映射
配置API出参和当前数据实体的属性映射。
从“API出参”处拖动字段至“实体属性映射”对应字段后的填写框中。
说明:
源端关联属性和目标端关联属性必须配置映射。
- 配置完后单击“保存”。
- 发布API映射。
单击目标映射操作列处的
或通过“映射编码”链接进入详情页后单击“发布”。
说明:
新创建的API映射要发布后才可生效。
创建API映射后,您可以对其进行一些相关操作,具体如下。表4 API映射相关操作 操作
说明
修改API映射
删除API映射
勾选一条或多条“正在工作”的映射,单击“删除”。
测试API映射
- 单击映射“操作”列处的
,弹出数据映射测试窗口。
- 在“增量集成”处设置“数据条目数”、“起止时间”、“超时设置”和“业务参数”等参数。
说明:
其中业务参数区分非Body参数和Body参数。
- 如果业务参数选择非Body参数,则支持添加多个且最多不能超过5个,下拉可选值来源于源系统API接入时Swagger里解析出的入参参数。
- 如果业务参数选择Body参数,则需在“Body”框中输入Json格式的Body请求体参数。
- 单击“测试”,验证返回数据。
修订API映射
单击已发布的目标映射操作列处的
。
修订成功后即可复制一个“正在工作”状态的映射,其中“源系统”、“API名称”不可修改。
作废API映射
单击已发布的目标映射操作列处的
。可能出现以下情况:
- 如果当前映射未被入图任务引用且非唯一的已发布映射,则能成功作废。
- 如果当前映射被入图任务引用,请按界面提示操作后再作废。
- 如果仅有一条已发布的映射,则不支持作废。
- 单击映射“操作”列处的
查看xDM-F映射(源端映射)
xDM-F映射可作为后续数据实例入图的源端映射。根据集成方xDM-F模型是否存在扩展属性以及扩展属性的类型不同,实体发布后会同时生成一个非扩展表类型和多个扩展表类型的“已发布”状态的xDM-F映射。
- 登录LinkX-F系统首页。
- 选择“模型设计 > 数据模型管理”,默认进入“数据实体”页面。
- 在左侧导航栏选择“关系实体”,进入“关系实体”页面。
- 单击目标实体的“编码”链接,在弹出的详情页单击“数据源映射”页签,默认进入“源端映射”页签。
- 在xDM-F映射处展示目标实体所有的xDM-F映射。单击具体映射的“映射编码”链接,弹出映射详情,关键参数信息说明如表5所示:
表5 关键参数信息说明 参数
说明
映射名称
xDM-F映射名称。
是否扩展表
表示是否存在扩展属性。
xDM-F扩展类型
基于实体扩展,显示对应xDM-F实体的英文名称。
xDM-F物理表
根据xDM-F模型类型是否扩展模型以及是否存在扩展属性,xDM-F物理表的组成显示格式有所不同:
- 如果是非扩展模型,非扩展表类型的组成显示格式为{xDM-F应用名称}_{关系实体英文名称},扩展表类型的组成显示格式为{xDM-F应用名称}_{关系实体英文名称}{扩展属性类型}。
- 如果是扩展模型,非扩展表类型的组成显示格式为{xDM-F应用名称}_{父模型名称},扩展表类型的组成显示格式为{xDM-F应用名称}_{关系实体英文名称}{扩展属性类型}。
配置图数据库映射(目标端映射)
实体型关系发布后系统会为其自动生成一个“已发布”的默认图数据库映射。如有需要,您可继续对“已发布”实体的图数据库映射进行管理,如新增、修改、删除、发布、修订、作废等。
- 如果实体属性入图,则图数据库映射中的“数据库字段”会显示匹配字段。
- 集成xDM-F模型生成的LinkX-F实体仅支持更新图数据库映射操作,该类映射管理的其他操作均不支持。
- 登录LinkX-F系统首页。
- 选择“模型设计 > 数据模型管理”,默认进入“数据实体”页面。
- 在左侧导航栏选择“关系实体”,进入“关系实体”页面。
- 单击目标实体的“编码”链接,在弹出的详情页单击“数据源映射”页签,默认进入“源端映射”页签。
- 切换至“目标端映射”页签,对图数据库映射进行管理。
- 单击“新增”,弹出数据库映射新增页。
- 填写映射基本信息,如表6所示:
- 填写完后单击“保存”。
- 发布图数据库映射。
单击目标映射操作列处的
或通过“映射编码”链接进入映射详情页单击“发布”。
说明:
新创建的图数据库映射要发布后才可生效。
创建图数据库映射后,您可以对其进行一些相关操作,具体如下。
后续操作
完成源端映射和目标端映射的创建及发布后,可通过数据入图任务将实体模型对应的实例数据入到图数据库,以便构建模型知识图谱,后续进行数据探索。数据入图任务相关操作请参考数据入图任务。