实体类型与关系类型

更新时间:
复制 MD 格式

实体类型定义图谱节点对象,关系类型定义节点间语义边,二者均支持属性与约束配置,共同构成知识本体结构,是模型的核心组成单元,决定模型的语义表达能力与数据结构形态。本文为您介绍实体类型和关系类型的相关操作。

权限说明

空间管理员和建模师支持创建及管理实体类型和关系类型。

使用限制

  • 每个空间最多支持创建200个实体类型和500个关系类型。

  • 每个实体/关系类型下,最多支持创建100个属性。

创建实体类型

  1. Dataphin首页的顶部菜单栏,选择知识图谱 > 模型设计

  2. 在顶部菜单栏中选择空间,下方展示所选空间的模型,您可在此基础上修改。

  3. 在左侧模型配置库中,单击实体类型后的image图标,在实体类型配置:新建面板中配置以下参数。

    参数

    描述

    实体类型名称

    实体类型的展示名称,同一空间内唯一,支持所有字符,长度为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向量,用于查询时语义相似度检索。索引开启后,用于精确查询、模糊匹配、属性过滤。二者独立配置、互不影响,若一个属性同时开启了索引和语义检测,则发布时,将分别创建普通索引和向量索引。

  4. 单击确定,完成当前实体类型的创建。

    若当前实体类型中不存在主键属性,则无法创建。

创建关系类型

  1. 在左侧模型配置库中,单击关系类型后的image图标,在添加关系类型面板中配置以下参数。

    参数

    描述

    关系类型名称

    关系类型的展示名称,同一空间内唯一,支持所有字符,长度为2~50个字符。

    编码

    关系类型唯一标识,同一空间内唯一,支持英文字母大写、数字和下划线(_),需以大写字母开头,长度为2~64个字符。

    源实体

    为当前关系选择源实体和目标实体,源实体和目标实体可为同一实体同一对实体类型可拥有多种关系类型

    目标实体

    有方向

    当前关系是否存在方向,开启后,画布中的关系将使用箭头从源实体指向目标实体。

    基数约束

    源实体与目标实体间是1:11:NN:M的关系。

    关系类型描述(非必填)

    当前关系类型的简单描述,支持所有字符。

    关系属性(非必填)

    当前关系类型下的属性,属性名称/编码数据类型/默认值属性描述约束条件(不支持展示名称)的配置说明均与实体类型属性相同,详情请参见实体类型属性。可单击新增属性,添加一行空属性;单击删除图标,可删除对应行属性。

  2. 单击确定,完成当前关系类型的创建。

    若当前关系类型中,未正常引用源/目标实体,则无法创建。

变更操作说明

编辑已创建的实体类型时,实体类型编码和属性编码不可修改;编辑已创建的关系类型时,关系类型编码、源实体和目标实体、属性编码不可修改,其余信息可变更,不同操作可能产生不同程度的影响。当模型发布包含破坏性变更时,系统将自动完成默认值回填、属性值丢弃和数据类型转换

变更类型

操作

影响

非破坏性

新增可选属性

新属性在对应节点上为默认值(无默认值则为空)。

修改属性显示名称

仅元数据变更。

新增索引

发布后异步构建索引,不影响现有数据。

移除语义检索

向量索引将被清理,语义检索能力失效。

兼容性

属性类型放宽(例如Integer改为Float)

现有数据将自动转换,需确认精度变化带来的影响。

新增必填属性(有默认值)

系统将自动为所有空节点回填该默认值。

删除可选属性

所有与该实体/变更类型相关的节点,此属性值都将丢失,但不阻塞发布。

移除索引

查询性能可能下降。

新增语义检索

发布后将异步构建向量索引,已有数据需执行一次Embedding回填任务。

破坏性

属性类型缩窄(例如String改为Integer)

可能造成数据不兼容,需转换或清除。

删除必填属性

所有与该实体/变更类型相关的节点,此属性值都将丢失。

新增必填属性(无默认值)

发布时需输入回填值,发布后所有与该实体/变更类型相关的节点,均需回填此属性。

修改主键属性(包含已有实体类型的主键模式切换)

可能引发节点唯一性冲突。

删除实体/关系类型

删除实体关系时,将同时删除与此实体关系相关的关系类型。