1. 概述编辑
视频学习请点击：添加基础数据表
数据库表属于基础表，基础表概念请参见：基础表
1.1 版本
| FineBI 版本 | JAR 包版本 | 功能变动 |
|---|---|---|
| 5.1 | 2020-01-15 | |
| 5.1.5 | 2020-08-04 | 支持查看添加数据库表的去向 |
1.2 应用场景
用户可以通过添加「数据库表」将数据库的某张表直接添加进 FineBI 中。
1.3 适用人群
数据处理用户
2. 添加表前的准备工作编辑
2.1 授予添加数据库表权限
拥有添加数据库表的权限需要管理员为用户配置，且用户类型必须为「数据处理用户」，详情参见：基础表管理权限
2.2 确认数据表原始字段名形式
添加表时，表字段的原始名不要出现：既有 A 字段又有 A-B 字段这样的形式（比如同时存在「销售额」和「销售额-瀑布图」字段）,否则在添加表的过程中会自动把这种字段当作 自循环列 进行处理。
2.3 数据类型识别
字段中若是包含小数，一定会被识别成数值字段。
字段中若是不包含小数：
不打开「数值类型识别」开关：小于 19 位时被识别为数值字段，大于 19 位时被识别为文本字段；
打开「数据类型识别」开关：无论多少位都识别为数值字段。但字段类型会被识别成 double，double 本身支持的精度只有16-17 位，所以当数值长度超过 18 位时就可能发生精度丢失的情况
数值类型识别开关默认关闭，如何打开「数值类型识别」开关请参见：BI 参数
3. 操作步骤编辑
3.1 进入业务包
登录数据决策系统，选择「数据准备」并进入业务包，如下图所示：
3.2 添加表
1）点击添加表，选择数据库表，如下图所示：
2）进入数据库选表界面，可以选择已创建的数据连接，右侧会显示获取到的该数据连接中的表信息，已添加的表灰化不可选择。如下图所示：
3）根据需要选择添加到业务包中的表，选择表 FACT_FEE。点击右上角的确定，FineBI 会自动读取已选表中的数据库关联和表名转义、列名转义等如下图所示：
注：数据库中的表名、列名转义只有在添加表的时候才会获取到，若进行表更新操作后，在数据库中新增注释，再次更新 BI 中的表，则不会获取转义。
抽取状态下需要点击「更新数据」后，然后在数据预览中进行预览，如下图所示：
4）随后进入业务包界面，可以在业务包中看到刚刚添加成功的数据库表。如下图所示：
注：添加数据库表到 FineBI 后，系统会自动获取到字段的转义名。
注：添加基础表后可进行基础表的编辑操作，详情参见：编辑基础表 。
注：被 BI 识别成日期类型的字段都会自动补全「年月日时分秒」，展示成 yyyy-MM-dd HH:mm:ss（示例：2020-10-15 00:00:00）
3.3 查看数据库表去向
再次点击添加表，鼠标悬浮至刚才添加的FACT_FEE 表中，可以看到该表已经灰化并提示该表已经添加至 业务包（费用表），如下图所示：
提示规则如下所示：
| 业务包 | 提示 |
|---|---|
| 如果业务包归属于某个业务包分组 | 该表已添加至 分组/XX业务包（表名） |
如果业务包不归属于某个业务包分组，直接放置在数据列表下 | 该表已添加至 XX业务包（表名） |
3.4 搜索数据库表
在添加表界面的搜索框中输入关键词，即可展示所有相关的数据库表，如下图所示：
3.5 查看数据库表来源
在预览界面，点击「...」可以查看已添加的数据库表的原始名和来源，如下图所示：
4. 注意事项编辑
4.1 数据更新设置
添加成功的数据库表若不选择开启 实时数据，需要进行 数据更新 才能使用，如添加自助数据集、创建组件等。
4.2 读取数据库转义名
数据库中的表名、列名转义只有在添加表的时候才会获取到，若进行数据表更新操作后，在数据库中新增注释，再次更新 BI 中的数据表，则不会获取转义。
4.3 新增字段后数据预览界面不显示
4.3.1 问题现象
在数据库中增加一个字段，更新 FineBI 对应数据表，不显示已经增加的字段，如下图所示：
4.3.2 解决方案
点击「编辑」，进入数据表编辑界面，勾选新增加的字段，点击「保存」并更新数据，此时「数据预览」界面即出现新增的字段，如下图所示：
4.4 新增数据后数据预览界面不显示
4.4.1 问题现象
创建 MySQL 数据连接并添加数据库表，数据库中有数据但数据准备界面不显示数据，如下图所示：
4.4.2 解决方案
进入「权限管理>数据连接」，编辑对应的 MySQL 数据连接，在数据连接 URL 后增加「?zeroDateTimeBehavior=convertToNull」，如下图所示：
