实体类型定义图谱节点对象,关系类型定义节点间语义边,二者均支持属性与约束配置,共同构成知识本体结构,是模型的核心组成单元,决定模型的语义表达能力与数据结构形态。本文为您介绍实体类型和关系类型的相关操作。
权限说明
空间管理员和建模师支持创建及管理实体类型和关系类型。
使用限制
每个空间最多支持创建200个实体类型和500个关系类型。
每个实体/关系类型下,最多支持创建100个属性。
创建实体类型
在Dataphin首页的顶部菜单栏,选择知识图谱 > 模型设计。
在顶部菜单栏中选择空间,下方展示所选空间的模型,您可在此基础上修改。
在左侧模型配置库中,单击实体类型后的
图标,在实体类型配置:新建面板中配置以下参数。参数
描述
实体类型名称
实体类型的展示名称,同一空间内唯一,支持所有字符,长度为2~50个字符。
实体类型编码
实体类型唯一标识,同一空间内唯一,支持英文字母大小写和数字,需以大写字母开头,长度为2~64个字符。
实体类型描述(非必填)
对当前实体类型的简单描述,支持所有字符。
图标
选择当前实体类型的图标,系统提供部分常用类型图标以供选用。
主键模式
业务主键:业务主键用于精确标识实体。选中后,您需选择符合其中一个属性作为实体主键。
系统自动生成主键:系统将为每个实体自动生成唯一标识(UUID)。选中后,系统将自动生成一个只读的系统主键
_sys_id。
实体类型属性
当前实体类型下的属性。可单击新增属性,添加一行空属性;单击删除图标,可删除对应行属性。
属性名称:属性的展示名称,同一实体类型内唯一,支持所有字符,长度为2~50个字符。
属性编码:属性编码,同一实体类型内唯一,仅支持小写字母、数字和下划线(_),需以小写字母开头,长度为1~64个字符。
数据类型:选择当前属性的类型,当前支持以下类型。
基础数据类型:String、Integer、Float、Boolean、Date、Timestamp、List
高级数据类型:Decimal、BigInteger、RegexString、Enum、Duration、DateTimeRang、Email、URL
空间与复杂类型:GeoPoint、GeoPolygon、GeoLineString、JSON、BLOB、Embedded
特殊类型:Unkonw、Array、Map<K,V>
默认值(非必填):当前属性的默认值,支持所有字符。
属性描述(非必填):当前属性的简单描述。
约束条件(是否必填、是否为主键、是否索引、展示名称、语义检索):为当前属性选中所需约束条件,至少需要一个属性作为主键。
其中,语义检测仅String类型可开启。开启后,该属性在发布时将创建向量索引,数据写入时将自动生成Embedding向量,用于查询时语义相似度检索。索引开启后,用于精确查询、模糊匹配、属性过滤。二者独立配置、互不影响,若一个属性同时开启了索引和语义检测,则发布时,将分别创建普通索引和向量索引。
单击确定,完成当前实体类型的创建。
若当前实体类型中不存在主键属性,则无法创建。
创建关系类型
在左侧模型配置库中,单击关系类型后的
图标,在添加关系类型面板中配置以下参数。参数
描述
关系类型名称
关系类型的展示名称,同一空间内唯一,支持所有字符,长度为2~50个字符。
编码
关系类型唯一标识,同一空间内唯一,支持英文字母大写、数字和下划线(_),需以大写字母开头,长度为2~64个字符。
源实体
为当前关系选择源实体和目标实体,源实体和目标实体可为同一实体,同一对实体类型可拥有多种关系类型。
目标实体
有方向
当前关系是否存在方向,开启后,画布中的关系将使用箭头从源实体指向目标实体。
基数约束
源实体与目标实体间是1:1、1:N或N:M的关系。
关系类型描述(非必填)
当前关系类型的简单描述,支持所有字符。
关系属性(非必填)
当前关系类型下的属性,属性名称/编码、数据类型/默认值、属性描述、约束条件(不支持展示名称)的配置说明均与实体类型属性相同,详情请参见实体类型属性。可单击新增属性,添加一行空属性;单击删除图标,可删除对应行属性。
单击确定,完成当前关系类型的创建。
若当前关系类型中,未正常引用源/目标实体,则无法创建。
变更操作说明
编辑已创建的实体类型时,实体类型编码和属性编码不可修改;编辑已创建的关系类型时,关系类型编码、源实体和目标实体、属性编码不可修改,其余信息可变更,不同操作可能产生不同程度的影响。当模型发布包含破坏性变更时,系统将自动完成默认值回填、属性值丢弃和数据类型转换。
变更类型 | 操作 | 影响 |
非破坏性 | 新增可选属性 | 新属性在对应节点上为默认值(无默认值则为空)。 |
修改属性显示名称 | 仅元数据变更。 | |
新增索引 | 发布后异步构建索引,不影响现有数据。 | |
移除语义检索 | 向量索引将被清理,语义检索能力失效。 | |
兼容性 | 属性类型放宽(例如Integer改为Float) | 现有数据将自动转换,需确认精度变化带来的影响。 |
新增必填属性(有默认值) | 系统将自动为所有空节点回填该默认值。 | |
删除可选属性 | 所有与该实体/变更类型相关的节点,此属性值都将丢失,但不阻塞发布。 | |
移除索引 | 查询性能可能下降。 | |
新增语义检索 | 发布后将异步构建向量索引,已有数据需执行一次Embedding回填任务。 | |
破坏性 | 属性类型缩窄(例如String改为Integer) | 可能造成数据不兼容,需转换或清除。 |
删除必填属性 | 所有与该实体/变更类型相关的节点,此属性值都将丢失。 | |
新增必填属性(无默认值) | 发布时需输入回填值,发布后所有与该实体/变更类型相关的节点,均需回填此属性。 | |
修改主键属性(包含已有实体类型的主键模式切换) | 可能引发节点唯一性冲突。 | |
删除实体/关系类型 | 删除实体关系时,将同时删除与此实体关系相关的关系类型。 |