物联网平台技术文档

数据源管理

数据源用于声明存储模块要把设备数据写到哪个数据库。系统会**自动创建一条「本平台主库」**记录（不可删除、不可改），如果数据想存到外部数据库，再在此页面新增「外部数据源」。

支持的数据库

1、MySQL （驱动 com.mysql.cj.jdbc.Driver）
2、PostgreSQL （驱动 org.postgresql.Driver）
其它数据库暂不支持。

页面入口

菜单：存储管理 → 数据源管理

img_3.png

新增外部数据源

操作步骤
1、点击右上角 新增外部数据源 按钮，弹出表单。
2、填写名称、选择数据库类型，填写 JDBC URL、用户名、密码。
3、（可选）调整连接池参数和心跳 SQL，留空则使用默认值。
4、点击 测试连接 按钮，下方提示 连接成功 后再点 确定 保存。

img_2.png

字段说明
字段说明默认值
名称数据源名称，便于识别，可重复必填
数据库类型MySQL / PostgreSQL必填
JDBC URL完整的 JDBC URL，含库名必填
用户名 / 密码数据库账号；密码加密后存数据库必填
最大连接数HikariCP maximumPoolSize10
最小空闲HikariCP minimumIdle2
空闲超时(ms)idleTimeout600000 (10 分钟)
最大生命(ms)maxLifetime，超过后连接自动重建1800000 (30 分钟)
获取超时(ms)connectionTimeout，从池里拿连接的等待上限10000 (10 秒)
心跳 SQL每 5 分钟执行一次的探活 SQLSELECT 1
备注可选，描述用途空
JDBC URL 模板
MySQL：jdbc:mysql://host:3306/dbname?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai
PostgreSQL：jdbc:postgresql://host:5432/dbname?currentSchema=public

测试连接

列表行操作里的 测试连接 按钮可在不重启服务的前提下立刻验证一次。失败时会显示具体异常（账号错误 / 网络不通 / 驱动缺失 等）。

修改数据源

点击行 修改 按钮可以改名称、URL、连接池等参数。密码留空表示沿用旧密码，不会清空。
修改保存后，旧的连接池会被立即关闭并按新配置重建，无需重启服务。

删除数据源

注意事项
1、本平台主库 由系统内置，禁止删除/修改，列表行不显示删除按钮。
2、删除外部数据源前，请先确认该数据源没有被「数据表设计」引用，否则相关表的写入会失败。
3、删除后系统会立即关闭并释放连接池。

连接池参数怎么调

默认参数适用于中等流量，建议按以下经验调整：
写入压力大（实时模式高 QPS）：把 最大连接数 提到 20-30，最小空闲 提到 5。
数据库带宽紧张：把 最大连接数 压到 5-10，避免压垮数据库。
数据库会主动断连接（如配置了 wait_timeout）：把 最大生命 调到比数据库 wait_timeout 短，否则会出现 Connection is not available 错误。
跨地域访问：把 获取超时 调到 30000 (30 秒)，避免网络抖动导致超时。

常见问题

A：检查 host:port 是否能从应用服务器连通；防火墙是否放通；如果是云数据库，白名单是否加上了应用服务器 IP。
Q：测试连接失败，提示 Access denied for user？
A：账号密码不对；或目标数据库的账号没有该 schema 的访问权限。
Q：本平台主库自动创建的记录，名称、URL 显示为「系统内置」？
A：这是为了避免主库的真实账号被前端泄露。系统在写入时会直接复用应用本身的主 DataSource，无需读取这条记录里的 URL。