Skip to main content
Version: 5.1.0

创建 Link Type

Link Type 描述两个 Object Type 之间的关联关系。在 TIS 中，创建 Link Type 分为两个步骤完成。

步骤一：选择关系类型​

在 Link Type 创建向导的第一步，需要选择关系类型（relationshipType）。TIS 支持以下三种关系类型：

关系类型说明
ObjectTypeForeignKeys通过外键直接关联两个 Object Type
JoinTableDataset通过中间关联表（Join Table）连接两个 Object Type
BackingObjectType通过中间 Object Type 桥接两端实体，自动推断主键

选择完关系类型后，点击「下一步」进入第二步配置。

步骤二：配置关系详情​

根据第一步选择的关系类型，第二步展示对应的配置表单。

类型一：ObjectTypeForeignKeys（外键关联）​

适用场景：事实表与维表之间存在直接外键关联。例如，订单表（Order）通过 customer_id 字段关联到客户表（Customer）。

配置字段：

字段说明
Left（左端）左侧 Object Type 及其关联字段（通常为事实表侧）
Cardinality（基数）关联的基数关系，可选 MANY_ONE、ONE_ONE 等
Right（右端）右侧 Object Type 及其关联字段（通常为维表侧）

示例：

Left:  Order.customer_id
Cardinality: MANY_ONE
Right: Customer.id

生成的 Link 标识名格式为：{left_objectType}_join_{right_objectType}

类型二：JoinTableDataset（中间关联表）​

适用场景：两个 Object Type 之间为多对多关系，需要借助一张中间关联表来记录关联关系。例如，订单（Order）与商品（Product）之间通过订单明细表（OrderItem）关联。

配置字段：

字段说明
Left（左端）左侧 Object Type 及其在关联表中的关联字段
Right（右端）右侧 Object Type 及其在关联表中的关联字段
Join（关联表）中间关联表的 Object Type，以及两个关联键字段（targetField 和 rightTargetField）

示例：

Left:  Order.id
Right: Product.id
Join:  OrderItem（关联字段：order_id → rightTargetField: product_id）

类型三：BackingObjectType（背靠对象关联）​

适用场景：两个 Object Type 通过另一个 Object Type 桥接关联，系统会自动从左侧和右侧 Object Type 中推断主键字段，无需手动指定关联字段。

配置字段：

字段说明
leftObjectType左侧 Object Type 名称（必须已设置主键）
rightObjectType右侧 Object Type 名称（必须已设置主键）
joinObjectType桥接中间 Object Type 及其在中间表上的两个关联字段
前提条件

leftObjectType 和 rightObjectType 指定的 Object Type 必须已设置主键，否则系统将无法自动推断关联字段，并返回校验错误。

示例：

leftObjectType:  Customer（主键：id，自动推断）
rightObjectType: Product（主键：id，自动推断）
joinObjectType:  CustomerProduct（关联字段：customer_id → rightTargetField: product_id）

生成的 Link 标识名格式为：{left}_join_{right}_with_{joinObjectType}

三种关系类型对比​

特性ObjectTypeForeignKeysJoinTableDatasetBackingObjectType
关联方式直接外键中间关联表中间 ObjectType 桥接
需要指定关联字段是是仅指定中间表字段
自动推断主键否否是（两端自动推断）
适用关系一对多、一对一多对多多对多（主键推断）
前提条件无无两端必须设置主键

完成创建​

完成两步配置后，点击「保存」，系统将自动生成 Link Type 并在本体中注册两个方向的关联关系。创建成功后，可在 Link Type 列表中查看。