连接本地数据库

1. 概述

1.1 应用场景

用户在本地安装了数据库，想要将数据库中的表同步到产品中进行分析。

1.2 功能简介

「本地数据源」支持通过「本地宝」连接本地数据库，将数据库中的数据表同步至产品中，支持连接的数据库有：MySQL、PostgreSQL、Oracle、SQLServer、SQLite、Access、ClickHouse、DB2。

2. 连接本地数据库

2.1 操作步骤

1）请根据 连接本地数据源 文档完成前期准备，先连接好本地数据源。

2）打开本地宝，点击左上角「+」按钮添加一个数据库的数据源，如下图所示：

3）在弹窗中输入相关信息，具体配置项说明可参见下表：

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 文件中的内容。替换后重启即可。