前言
在数字化转型的浪潮中,任务调度成为了后端服务不可或缺的一部分。XXL-JOB 是一个轻量级、分布式的任务调度框架,广泛应用于各种业务场景。达梦数据库(DM),作为一款国内领先的数据库产品,已经被越来越多的企业采用。本文将介绍如何将 XXL-JOB 适配到达梦数据库,实现任务调度的国产化支持。
Nacos 配置管理介绍
Nacos 提供了配置管理功能,支持动态配置更新,使得微服务架构中的配置管理更加灵活和高效。
达梦数据库介绍
达梦数据库是一款关系型数据库管理系统,具有高性能、高可用性、易于维护等特点,广泛应用于政府、金融、电信等行业。
环境准备
在开始之前,请确保已经准备好以下环境:
XXL-JOB:下载 XXL-JOB 的最新版本。并构建
达梦数据库:安装并启动达梦数据库。 mysql上的xxl-job库 迁移到达梦数据库上 最好使用传输工具进行传输 避免不必要用的问题
JDK:确保已安装 JDK 1.8 或以上版本。
xxl-job适配人大金仓
特此说明: 当前修改的xxl-job版本 为 2.4.1-SNAPSHOT
源码修改
pom中新增依赖 DmJdbcDriver18 驱动 注意版本
<!-- dameng -->
<dependency>
<groupId>com.dameng</groupId>
<artifactId>DmJdbcDriver18</artifactId>
<version>8.1.3.140</version>
</dependency>
- 注释掉 原有的MySQL驱动
修改xxl-job 数据库连接以及账号密码 还有驱动类
## 注释掉原有的数据库配置
spring.datasource.url=jdbc:dm://dm连接IP:5236/xxl_job?useUnicode=true&characterEncoding=UTF-8&autoReconnect=true&serverTimezone=Asia/Shanghai
spring.datasource.username=xxx
spring.datasource.password=xxx
spring.datasource.driver-class-name=dm.jdbc.driver.DmDriver
数据库连接 配置没问题的话 应该就可以启动了
问题汇总
Caused by: dm.jdbc.driver.DMException: 第12 行附近出现错误:无效的表或视图名[xxl_job.xxl_job_log]
com.xxl.job.admin.core.thread.JobFailMonitorHelper#start
的41行 提示 xxl_job_log 表不存在
刚开始以为也需要添加库名 ,然后尝试加了 启动依然报错
后续查询资料 是 不支持 `这个符号
解决: 全局替换 xml中的 这个符号即可
示例
<!-- 修改前 -->
<select id="findFailJobLogIds" resultType="long">
SELECT id
FROM `xxl_job.xxl_job_log`
WHERE !(
(trigger_code in (0
, 200)
and handle_code = 0)
OR
(handle_code = 200)
)
AND alarm_status = 0
ORDER BY id ASC
LIMIT #{pagesize}
</select>
<!-- 修改后 -->
<select id="findFailJobLogIds" resultType="long">
SELECT id
FROM xxl_job.xxl_job_log
WHERE !(
(trigger_code in (0
, 200)
and handle_code = 0)
OR
(handle_code = 200)
)
AND alarm_status = 0
ORDER BY id ASC
LIMIT #{pagesize}
</select>
后续 全局替换 xml中的 这个符号即可
函数 DATE ADD(unknown . interval)不存在
com.xxl.job.admin.core.thread.JobRegistryHelper#start 66行 报错
List<Integer> ids = XxlJobAdminConfig.getAdminConfig().getXxlJobRegistryDao().findDead(RegistryConfig.DEAD_TIMEOUT, new Date());
提示 bad SOL grammar 错误:函数 DATE ADD(unknown . interval)不存在
Hint:没有匹配指定名称和参数类型的函数.
您也许需要增加明确的类型转换.
解决- 替换新的实现方式
查询资料说是替换 新的实现方式 尝试多次 均不可
DATE_ADD(#{nowTime},INTERVAL -#{timeout} SECOND) 为
date '${nowTime}' - INTERVAL '${timeout} second'
类似的修改 等等
官方的地址说明: ’
date_add 函数若对添加时间间隔的表达式进行求值,可采用 DM 的
TIMESTAMPADD 函数进行替代,例子如下:
--MySQL
select DATE_ADD(sysdate(), INTERVAL 1 YEAR);
--2020-07-02 11:24:18
-- DM
select TIMESTAMPADD(SQL_TSI_YEAR, 1,sysdate());
--2020-07-02 11:27:56.000000
直接看终极解决办法 替换现有实现
本质来讲就是需要个工具类 将传入的时间减去一个传入的 秒数 返回修改后的时间
直接在工具类com.xxl.job.core.util.DateUtil 中 添加 如下方法
public static Date addSeconds(final Date date, final int amount) {
return add(date, Calendar.SECOND, amount);
}
然后在 com.xxl.job.admin.dao.XxlJobRegistryDao 新增两个dao的方法
public List<Integer> findDeadByTime(@Param("nowTime") Date nowTime);
public List<XxlJobRegistry> findAllByTime(@Param("nowTime") Date nowTime);
在mapper文件 XxlJobRegistryMapper.xml 中 新增两个方法对应的sql 内容
<select id="findDeadByTime" resultType="java.lang.Integer">
SELECT <include refid="Base_Column_List" />
FROM xxl_job.xxl_job_registry AS t
WHERE t.update_time <![CDATA[ < ]]> #{nowTime}
</select>
<!-- 2024年09月12日16:26:10 新修改
注意 resultMap 是 map映射 XxlJobRegistry 而不是一个实体类
否则导致结果集部分参数获取不到-->
<select id="findAllByTime" resultMap="XxlJobRegistry">
SELECT <include refid="Base_Column_List" />
FROM xxl_job.xxl_job_registry AS t
WHERE t.update_time > #{nowTime}
</select>
最后在 com.xxl.job.admin.core.thread.JobRegistryHelper#registryMonitorThread 文件中替换实现
//List<Integer> ids = XxlJobAdminConfig.getAdminConfig().getXxlJobRegistryDao().findDead(RegistryConfig.DEAD_TIMEOUT, new Date());
//新增修改后的内容
Date beforeDate = DateUtil.addSeconds(new Date(), -1 * RegistryConfig.DEAD_TIMEOUT);
List<Integer> ids = XxlJobAdminConfig.getAdminConfig().getXxlJobRegistryDao().findDeadByTime(beforeDate);
if (ids!=null && ids.size()>0) {
XxlJobAdminConfig.getAdminConfig().getXxlJobRegistryDao().removeDead(ids);
}
// fresh online address (admin/executor)
HashMap<String, List<String>> appAddressMap = new HashMap<String, List<String>>();
//List<XxlJobRegistry> list = XxlJobAdminConfig.getAdminConfig().getXxlJobRegistryDao().findAll(RegistryConfig.DEAD_TIMEOUT, new Date());
//新增的内容
Date nowDate = DateUtil.addSeconds(new Date(), -1 * RegistryConfig.DEAD_TIMEOUT);
List<XxlJobRegistry> list = XxlJobAdminConfig.getAdminConfig().getXxlJobRegistryDao().findAllByTime(nowDate);
com.xxl.job.admin.controller.JobGroupController#findRegistryByAppName 方法中 修改为使用 findAllByTime 方法
Date nowDate = DateUtil.addSeconds(new Date(), -1 * RegistryConfig.DEAD_TIMEOUT);
List<XxlJobRegistry> list = xxlJobRegistryDao.findAllByTime(nowDate);
注意事项
注意dm Caused by: dm.jdbc.driver.DMException: 第12 行附近出现错误:无效的表或视图名[xxl_job.xxl_job_log]
这个报错 不一定是这个表不存在 可能具体的位置的SQL语法有问题 导致这个报错
驱动连接问题
使用正确的驱动 或者直接去dm的安装目录下查找需要使用的版本 再使用jdk8的时候 可以使用DmJdbcDriver18
*达梦8 JDBC驱动版本说明
- DmJdbcDriver16 实现JDBC 4.0标准接口,已在JDK6上验证相关功能
- DmJdbcDriver17 实现JDBC 4.1标准接口,已在JDK7上验证相关功能
- DmJdbcDriver18 实现JDBC 4.2标准接口,已在JDK8,JDK11,JDK17上验证相关功能
good day!!!