连接本地数据库
1. 概述
1.1 应用场景
用户在本地安装了数据库，想要将数据库中的表同步到产品中进行分析。
1.2 功能简介
「本地数据源」支持通过「本地宝」连接本地数据库，将数据库中的数据表同步至产品中，支持连接的数据库有：MySQL、PostgreSQL、Oracle、SQLServer、SQLite、Access、ClickHouse、DB2。
2. 安装驱动（Oracle）
因 Oracle 限制，无法在「本地宝」安装包中内置 Oracle 驱动。
如你需要连接 Oracle 本地数据库，请前往 Oracle 官网 自行下载对应的驱动，将其放置在本地宝的 lib 文件夹下。重启本地宝后，再连接 Oracle 数据库。
3. 连接本地数据库
3.1 操作步骤
1）请根据 连接本地数据源 文档完成前期准备，先连接好本地数据源。
2）打开本地宝，点击左上角「+」按钮添加一个数据库的数据源，如下图所示：
3）在弹窗中输入相关信息，具体配置项说明可参见下表：
配置 | 介绍 |
分组名 | 自定义分组名，方便识别 |
数据库 | 选择自己使用的数据库，目前支持连接的数据库有：MySQL、PostgreSQL、Oracle、 SQLServer、SQLite、Access、ClickHouse、DB2 |
驱动 | 连接数据库所需要的驱动，本地宝已内置了数据库驱动，使用默认即可。 |
主机 | 输入数据库所在主机（或服务器）的 IP |
端口 | 输入数据库所在主机（或服务器）的端口 |
数据库 | 输入想要连接的数据库名称 |
用户名/密码 | 输入数据库的用户名和密码 |
模式 | 要连接的数据库模式，没有则保持空 |
URL | 自动生成的 URL ，无需特意配置 |
读表设置 |
|
开放表/禁用表设置，可以配置需要同步或者不需要同步的表：
|
注：配置生效后，更改名称会导致连接失效
4）填写完成后，可以点击「测试数据库连接」按钮测试当前连接是否成功，成功后点击「确定」。如下图所示：
5）当前配置已经发生了变化，需要点击左上角的「保存」按钮，使配置生效。如下图所示：
6）若 2.1 节的读表设置选择「自动读取」，那么界面中会展示自动读取的数据库表。如下图所示：
7）进入本地数据源界面，可以看到获取的数据库表。如下图所示：
3.2 手动添加表
若 2.1 节设置不自动读取数据表，需要手动添加表。或者需要对数据的原始表进行一些处理，需要输入 SQL 语句。
1）根据 2.1 节先连接好数据库，然后点击「添加表」按钮，设置数据表名、自定义 SQL 语句。如下图所示：
2）输入 SQL 语句后，点击小眼睛按钮可以查看当前语句执行的结果。如下图所示：
3）点击「确定」后，就可以手动新增的表，在右侧展示该表的相关信息，点击「编辑」按钮可对此表进行编辑。如下图所示：
4）当前数据源信息已变更，要生效需要保存一下当前配置。如下图所示：
4. 同步数据
数据库中已有的表发生更新后，刷新页面（比如重新进入数据源界面），数据源界面的表会自动更新。
但已经添加进项目中的表不会自动更新，需要设置手动同步或者定时更新。更多内容可参考文档：同步数据源 进行设置。
5. 常见问题
5.1 启动失败
常见问题 ：
报错 1：Runtime environment or build system does not support multi-release JARs. This will impact location-based features.
报错 2：
解决方案 ：请访问 Oracle 官网 下载对应的 jdk文件，解压后，复制 jdk 文件中的内容，替换掉本地宝 jre 文件中的内容。替换后重启即可。
5.2 性能优化
在「数据连接」页面预览本地数据源时，系统会实时查询数据库以获取最新数据。然而高频次的查询会增加服务器压力，进而可能延长请求响应时间。
为有效缓解服务器压力，提升操作性能，建议您参考以下优化策略：
- 请尽量避免使用复杂 SQL 语句；
- 请尽量不要进入「数据连接」处预览数据。每一次预览都会触发向数据库的查询，高频查询会增加服务器压力。
- 请根据实际业务场景与需求差异，为不同的数据表量身定制定时同步计划，巧妙错开同步时间。
- 当本地宝连接数据库时，不要勾选「数据行数」。如下图所示：
400-111-0890
在线咨询