# 模型关系 (Relationship)

## 概述

**关系（Relationship）** 用于定义不同语义模型（Cube）之间的 join 方式。通过建立 Cube 之间的关系，可以实现数据的无缝集成，方便用户创建高效、准确的数据视图（View）。

## 关系的类型

1. **一对一（One-to-One，1-1）：**每个 Cube A 中的记录与 Cube B 中的记录一一对应。场景示例：一个用户档案表和用户详细信息表，每个用户仅对应一条详细信息。
2. **一对多（One-to-Many，1-n）或 多对一（Many-to-One，n-1）：**Cube A 中的一条记录可以关联 Cube B 中的多条记录。场景示例：一个客户对应多张订单，客户表与订单表之间是一对多关系。

## 为什么要建立关系？

**1. 用于视图（View）创建**

* 支持在视图中聚合并展示来自多个 Cube 的数据。
* 提前定义好数据关联，提高 BI 工具展示和查询的性能。

**2. 保障数据一致性和完整性**

* 确保不同数据集之间的正确关联，避免数据孤岛。
* 降低数据冗余，便于模型维护和更新。

**3. 优化查询性能**

* 通过预定义的关系减少运行时复杂 Join 的计算压力。
* 依赖已建立的索引和优化逻辑，提高数据检索效率。

## 举例说明

如果你有一个 **客户 Cube** 和一个 **订单 Cube**，你可以通过客户 ID 建立“一对多”关系：

* 一个客户对应多个订单。
* 你可以在视图里直接分析每个客户的订单总额、下单频次等指标。
* 查询性能更好，不需要临时去写复杂的 Join。

## 定义关系

在 Recurve 中定义 Cube 之间的关系，可以按照以下步骤操作：

{% hint style="warning" %}
在创建关系之前，须为 Cube 设置好主键（Primary Key）。参考文档 [#chuang-jian-cube](https://docs.reorc.com/cn-reorc-help-center/yu-yi-ceng-mo-xing-cube#chuang-jian-cube "mention")
{% endhint %}

1. **点击「编辑关系」按钮**
   1. 在 Cube 页面中，点击 **「编辑关系（Edit Relationship）」** 按钮，系统将弹出「关系配置窗口（Relationship Modal）」。

2. **新增关系**

* 点击 **「添加关系（Add Relationship）」** 按钮，开始配置新的关系行。
* 在新建的行中，选择以下信息：
  * **关系类型（Relationship Type）**\
    例如：一对一（1-1）、一对多（1-n）
  * **来源字段（From）**\
    选择当前 Cube 中作为关联字段的列
  * **目标字段（To）**\
    选择要关联的目标 Cube 以及其字段
* 配置完成后，点击 **「添加（Add）」** 按钮。

3. **保存关系**\
   所有关系配置完成后，点击 **「保存（Save）」** 按钮，保存已定义的所有关系。

***

#### 小提示

* 建议先理清 Cube 之间的逻辑关系，确认好主键、外键设置，避免数据连接错误。
* 配置完成后，可以在 View 或 BI 工具中直接使用已建立的关系，快速分析跨表数据。