> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xpertai.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# 🛠️ 语义建模工作空间

语义建模工作空间是一个专门的环境，使用语义层对数据进行建模，使不同团队在组织内部对数据形成共同的共享理解。语义层用于定义维度、层次结构和多维数据集，并用于将原始数据转换为有意义的业务术语。语义建模工作空间有助于简化数据元素之间的复杂关系，使组织更容易进行数据分析和查询，并提供一种更直观的理解数据的方式。

语义建模界面功能分为以下区域:

* 模型实体列表;
* 数据源实体列表;
* 查询实验室;
  * 表结构列表
  * 查询语句编辑器
  * 查询结果预览
* 维度设计器;
  * 层级列表;
  * 数据表结构列表;
  * 数据预览表格;
  * 维度表关系构建区域;
* 多维数据集设计器;
  * 维度列表
  * 度量列表
  * 计算成员列表
  * 结构预览区域
  * 计算编辑器
  * 查询编辑器

## 模型实体

模型实体列表区域用于创建多种语义模型实体包括：共享维度、多维数据集和虚拟数据集。

<img src="https://mintcdn.com/xpertai/0avAZsO6pri8DJS6/public/img/models/semantic-model-entities.png?fit=max&auto=format&n=0avAZsO6pri8DJS6&q=85&s=726a4bd983589de3524e28487dbf3788" alt="语义模型实体" width="3012" height="1608" data-path="public/img/models/semantic-model-entities.png" />

* 共享维度：一种在多个数据集之间共享的维度，避免数据冗余和重复定义。
* 多维数据集：用于存储和组织数据，由维度（Dimensions）和度量（Measures）组成。
* 虚拟数据集：基于一个或多个现有数据集创建的一种虚拟数据模型。

## 数据表

**数据表** 区域的列表是来自数据源的实体元数据信息, 比如来自关系型数据库的数据表或者来自多维数据源的多维数据集.

### 刷新元数据

**刷新元数据** 按钮可以手动重新获取数据源中的实体信息.

### 上传数据

**上传表** 按钮可以上传数据文件创建表并保存数据至数据库中.

<img src="https://mintcdn.com/xpertai/8ELAM-RyAqJboiJw/public/img/models/upload-data-file.png?fit=max&auto=format&n=8ELAM-RyAqJboiJw&q=85&s=559f64580c0cbb8a2031574d7489ea9d" alt="上传数据" width="2410" height="1440" data-path="public/img/models/upload-data-file.png" />

1. 在上传窗口中, 添加一个数据文件后, 转到 **预览** 步骤.
2. 每个选择项代表了一个数据文件或者 Excel 的 Sheet
   1. 选择项中的标题将作为表名进行创建数据库表, 可以进行修改.
   2. 预览表抬头中每一列代表此表的列配置, 勾选 **键** 可将此列设置为主键, 选择不同的列类型和字段长度, 还可以修改列名称.
3. 下一步转到导入步骤
   1. **覆盖**、**追加**或**合并**: 表示数据将重新创建数据库表还是追加到已有的表中.
   2. 删除按钮可以删掉不需要导入的表.
   3. 点击导入进行上传, 等待上传成功即可.

完成后数据表区域将刷新出新建的表信息.

### 搜索数据表

可以根据表的关键值或者描述对列表进行过滤.

## 查询实验室

在使用数据源创建语义模型后, 用户可以使用查询实验室功能查询和管理数据源中的数据库对象, 可当作用户的日常数据运维工作功能, 也可以当作数据建模时的数据整理和预览功能.

详细功能参见[🧪查询实验室](../query-lab)

## 维度设计器

维度设计器功能帮助用户创建公共的共享维度, 共享维度统一创建和管理, 可以被用在不同的多维数据集中, 以尽量减少不同模型之间的数据差异.

维度中的层次结构(Hierarchy)使得用户可以以不同的视角来分析同一数据集的数据结果.

详细功能参见[❄️维度设计器](../dimension-designer)

## 多维数据集设计器

[🧊多维数据集设计器](../cube-designer/) 帮助用户对事实表数据通过关联不同的维度数据进行分析.

## 虚拟数据集设计器

[🔗虚拟数据集设计器](../mdx-modeling/virtual-cube/)

## 新建故事仪表板

从语义模型界面菜单栏 **常规** -> **故事** -> **创建故事** 创建故事, 那么新建的故事默认将使用当前的语义模型作为数据源模型;

## 快捷键

| 快捷键                | 描述     |
| ------------------ | ------ |
| `Ctrl + S`         | 保存当前模型 |
| `Ctrl + Z`         | 撤销     |
| `Ctrl + Shift + Z` | 重做     |
