> ## Documentation Index
> Fetch the complete documentation index at: https://help.dingtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.
# 数据准备
> 了解数据准备的概念及其在数据分析中的重要性，包括如何配置数据源、创建数据集、处理数据以及加速数据。通过宜搭提供的服务，您可以轻松实现数据加工和可视化分析。
尊享版专享
## 1. 什么是数据准备
在正式进入数据准备功能的使用之前，我们先来看一下到底什么是数据准备？什么情况下我们需要使用到数据准备这样的高级功能？
宜搭提供数据加工，数据可视化，嵌入式 BI 的数据分析页面搭建服务。**数据准备是指在可视化分析之前，需要对数据源/数据集进行一系列的处理，比如多表 join、数据转换等，是可视化分析的前序环节。**
简单来说就是创建报表，对数据分析之前，我们可以先对数据源/数据集进行处理。
## 2. 怎么配置数据准备
### 2.1 进入数据准备
**路径**：进入应用页面 >> 新建报表 >> 拖动一个展示的组件 >> 选择数据集 >> 数据准备
应用表单内创建报表
添加数据集
数据准备页面
点击数据准备后，可以跳转至该页面，数据准备的需要执行以下步骤：
**配置数据源 >> 创建数据集 >> 配置数据字段并加工 >> 保存 >> 加速**
### 2.2 配置数据源
在数据准备里，有两种方式可以上传您的数据，比如导入本地数据（Excel/CSV），也可以连接服务器，比如MySQL，宜搭数据源等。
**注**：此处宜搭应用的数据会默认在首行，显示类型为宜搭数据源。
配置数据源
导入本地数据源支持 Excel、CSV 格式的文件上。如图：
连接服务器支持数据库形式导入，当前仅支持 MySQL 和宜搭数据源；选择宜搭数据源，选择对应的应用名称即可。
**特别说明：**
选择 MySQL 之后，需要填写如下项：Driver、URL、DB Name、User Name、Password。
URL 填写规范如下：**jdbc:mysql://数据库 IP 地址:数据库端口号/数据库名**
举例：如您的 MYSQL 数据库IP地址是 47.96.37.128 ,数据库端口号是 3306 ，数据库名为 aaa，这里需要填写：**jdbc:mysql://47.96.37.128:3306/aaa**
### 2.3 创建数据集
我们提供了明细，汇总数据这两种模式。
比如在明细数据集里面，您可以通过添加多张表，关联关系，公式等功能，来处理您的数据。
处理完数据之后，**请记得要保存当前配置规则**
#### Tips：
联接（Join）操作是数据库查询中常见的操作，用于将两个或多个表中的数据按一定的条件组合在一起。
当前列出了四种主要的联接类型：内联、左联、右联和外联，并且提供了一个示例，说明了如何设置这些联接。
##### 内联（Inner Join）
* 定义 ：内联只返回两个表中满足联接条件的记录。
* 应用场景 ：当你只想获取两个表中都存在的记录时使用内联。例如，如果你有一个客户表和一个订单表，你可能只想获取那些既存在于客户表也存在于订单表中的记录。
* 
##### 左联（Left Join）
* 定义 ：左联返回左表的所有记录以及右表中满足联接条件的记录。如果右表中没有匹配项，则结果集中的对应列将为空值。
* 应用场景 ：当你想确保左表中的所有记录都被包含在结果集中，即使右表中没有匹配项。例如，如果你想列出所有的客户以及他们对应的订单，即使有些客户还没有下过任何订单。
* 
##### 右联（Right Join）
* 定义 ：右联返回右表的所有记录以及左表中满足联接条件的记录。如果左表中没有匹配项，则结果集中的对应列将为空值。
* 应用场景 ：与左联类似，但方向相反。例如，如果你想列出所有的订单以及它们对应的客户信息，即使有些订单对应的客户信息丢失了。
* 
##### 外联（Full Outer Join）
* 定义 ：外联返回左表和右表中所有满足联接条件的记录。如果其中一个表中没有匹配项，则结果集中的对应列将为空值。
* 应用场景 ：当你想获取两个表中所有的记录，无论是否在另一个表中有匹配项。例如，如果你想列出所有的客户和所有的订单，包括那些没有订单的客户和没有客户信息的订单。
### 2.4 加速数据
数据准备还有最后一步，加速您的数据。保存后点击加速，后台会自动找到最适合您数据的加速方式。
您也可以点击日志查看当前加速的处理进展。完成后请预览数据，确认数据是否是您想要的。
### 2.5 报表分析
回到刚才数据分析编辑页面，点击刷新按钮即可在单表数据/多表关联中使用刚才生成的数据集。
## 3. 视频展示
## 4. 常见问题
查看加速日志，将日志拉到最后查看 fail 日志提示信息
```xml theme={"theme":{"light":"github-light","dark":"github-dark"}}
[2020-09-03 16:22:35] failed, jobId:T_4b1c7e0a-bd80-44d2-a3fd-0adc12b40387, schemaCode:query_APP_I8PRTK1GTAFLKO5DG4SH_371846, targetSchemaCode:null, tableName:query_APP_I8PRTK1GTAFL_234946_6d60de83d95fb0b96dd2ae1e_069cd3, queryCode:query_APP_I8PRTK1GTAFL_234946_6d60de83d95fb0b96dd2ae1e_069cd3, costTime:59794 error msg:表数据为空异常。详情:Query table:query_APP_I8PRTK1GTAFL_234946_6d60de83d95fb0b96dd2ae1e_069cd3 data size equal zero. cannot be accelerated. , root msg:DataSizeZeroException: 表数据为空异常。详情:Query table:query_APP_I8PRTK1GTAFL_234946_6d60de83d95fb0b96dd2ae1e_069cd3 data size equal zero. cannot be accelerated.
[2020-09-03 16:22:35] failed, jobId:T_74d02519-ae60-4971-b8db-57f00e8ec0dd, schemaCode:query_APP_I8PRTK1GTAFLKO5DG4SH_371846, targetSchemaCode:null, tableName:query_APP_I8PRTK1GTAFL_234946_6d60de83d95fb0b96dd2ae1e_069cd3, queryCode:query_APP_I8PRTK1GTAFL_234946_6d60de83d95fb0b96dd2ae1e_069cd3, costTime:59820 error msg:表数据为空异常。详情:Query table:query_APP_I8PRTK1GTAFL_234946_6d60de83d95fb0b96dd2ae1e_069cd3 data size equal zero. cannot be accelerated. , root msg:DataSizeZeroException: 表数据为空异常。详情:Query table:query_APP_I8PRTK1GTAFL_234946_6d60de83d95fb0b96dd2ae1e_069cd3 data size equal zero. cannot be accelerated.
[2020-09-03 16:22:35] failed, jobId:T_MAIN_bf7181fd-6a79-43f2-a5d8-d133751c3880, schemaCode:query_APP_I8PRTK1GTAFLKO5DG4SH_371846, targetSchemaCode:null, tableName:query_APP_I8PRTK1GTAFL_234946_6d60de83d95fb0b96dd2ae1e_069cd3, queryCode:query_APP_I8PRTK1GTAFL_234946_6d60de83d95fb0b96dd2ae1e_069cd3, costTime:73113 error msg:表数据为空异常。详情:Query table:query_APP_I8PRTK1GTAFL_234946_6d60de83d95fb0b96dd2ae1e_069cd3 data size equal zero. cannot be accelerated. , root msg:DataSizeZeroException: 表数据为空异常。详情:Query table:query_APP_I8PRTK1GTAFL_234946_6d60de83d95fb0b96dd2ae1e_069cd3 data size equal zero. cannot be accelerated.
```
（1）错误一
**原因**：文件内容为空
**解决方法**：确保文件内容非空
**注意**：如果文本内容非空，尝试打开文件，重新保存一下再上传
（2）错误二
**原因1**：MYSQL 版本目前只支持 5.7 及以下版本
**原因2**：MYSQL 配有访问白名单，宜搭所在服务器 IP 不在访问白名单内
**解决方法**：
1.调整 MYSQL 版本；
2.将宜搭所在服务器 IP 配置在 MYSQL 访问白名单内
数据加速的时间和周期目前是无法自定义的。