1. 概述
1.1 应用场景
用户在本地安装了数据库，想要将数据库中的表同步到产品中进行分析。
1.2 功能简介
「本地数据源」支持通过「本地宝」连接本地数据库，将数据库中的数据表同步至产品中，支持连接的数据库有：MySQL、PostgreSQL、Oracle、SQLServer、SQLite、Access、ClickHouse、DB2。
2. 连接本地数据库
2.1 操作步骤
1）请根据 连接本地数据源 文档完成前期准备，先连接好本地数据源。
2）打开本地宝，点击左上角「+」按钮添加一个数据库的数据源，如下图所示：
3）在弹窗中输入相关信息，具体配置项说明可参见下表：
| 配置 | 介绍 |
|---|---|
| 分组名 | 自定义分组名，方便识别 配置生效后，更改名称会导致连接失效 |
| 数据库 | 选择自己使用的数据库，目前支持连接的数据库有：MySQL、PostgreSQL、Oracle、 SQLServer、SQLite、Access、ClickHouse、DB2 |
| 驱动 | 连接数据库所需要的驱动，本地宝已内置了数据库驱动，使用默认即可。 |
| 主机 | 输入数据库所在主机（或服务器）的 IP |
| 端口 | 输入数据库所在主机（或服务器）的端口 |
| 数据库 | 输入想要连接的数据库名称 |
| 用户名/密码 | 输入数据库的用户名和密码 |
| 模式 | 要连接的数据库模式，没有则保持空 |
| URL | 自动生成的 URL ，无需特意配置 |
| 读表设置 |
|
开放表/禁用表设置，可以配置需要同步或者不需要同步的表：
|
4）填写完成后，可以点击「测试数据库连接」按钮测试当前连接是否成功，成功后点击「确定」。如下图所示：
5）当前配置已经发生了变化，需要点击左上角的「保存」按钮，使配置生效。如下图所示：
6）若 2.1 节的读表设置选择「自动读取」，那么界面中会展示自动读取的数据库表。如下图所示：
7）进入本地数据源界面，可以看到获取的数据库表。如下图所示：
2.2 手动添加表
若 2.1 节设置不自动读取数据表，需要手动添加表。或者需要对数据的原始表进行一些处理，需要输入 SQL 语句。
1）根据 2.1 节先连接好数据库，然后点击「添加表」按钮，设置数据表名、自定义 SQL 语句。如下图所示：
2）输入 SQL 语句后，点击小眼睛按钮可以查看当前语句执行的结果。如下图所示：
3）点击「确定」后，就可以手动新增的表，在右侧展示该表的相关信息，点击「编辑」按钮可对此表进行编辑。如下图所示：
4）当前数据源信息已变更，要生效需要保存一下当前配置。如下图所示：
3. 同步数据
3. 注意事项
常见问题 1：Oracle 连接失败。
解决方案 1：本地宝中缺少 Oracle 驱动，请前往 Oracle 官网 自行下载对应的驱动，将其放置在本地宝的 lib 文件夹下。重启本地宝后，再连接 Oracle 数据库。
常见问题 2：
报错 1：Runtime environment or build system does not support multi-release JARs. This will impact location-based features.
报错 2：
解决方案 2：请访问 Oracle 官网 下载对应的 jdk文件，解压后，复制 jdk 文件中的内容，替换掉本地宝 jre 文件中的内容。替换后重启即可。
