DataGear 变更部署数据库操作指南

原创
2021/03/10 09:48
阅读数 1.6W

DataGear 部署数据库默认采用了内置的Derby数据库,存储在【用户主目录】/.datagear/derby 文件夹内。在DataGear启动时,会自动检查和安装内置Derby数据库,并且会根据当前DataGear版本号自动对其进行升级。内置Derby数据库能满足大部分的应用场景,并且简化了DataGear的安装部署,用户无需预先准备数据库环境,也不用在DataGear升级时手动检查和升级数据库。

如果希望变更数据库(比如MySQL、Oracle、PostgreSQL、SQL Server),则需要预先准备数据库环境,手动初始化和管理数据库结构,具体操作步骤如下所示:

1、手动初始化数据库

参考DataGear源码仓库(https://gitee.com/datagear/datagear)中内置的Derby数据库初始化SQL脚本(datagear-management/src/main/resources/org/datagear/management/ddl/datagear.sql),编写新数据库初始化SQL脚本,然后执行它们。

如果是初次安装DataGear,需要编写所有SQL脚本,如果是升级DataGear,则仅需要编写旧版本至新版本的升级SQL脚本。

对于 2.13.0 之前的版本的升级,需要先后参考 datagear-bak.sql 和 datagear.sql 中的SQL脚本,对于 2.13.0 或更高版本的升级,仅需参考 datagear.sql 中的SQL脚本。

提示:初始化脚本里的 DATAGEAR_REPLACEREGEX 函数及其相关的SQL语句都可以忽略,它们仅用作旧版本数据升级,没有在程序里使用。

2、手动设置数据库版本号表

手动执行如下SQL语句,设置当前DataGear版本号:

UPDATE DATAGEAR_VERSION SET VERSION_VALUE='当前版本号'

INSERT INTO DATAGEAR_VERSION(VERSION_VALUE) VALUES('当前版本号')

注意:上述SQL语句中的 当前版本号 应替换为实际DataGear版本号,比如:3.0.1

3、配置数据库连接

在config/application.properties添加datasource.driverClassNamedatasource.urldatasource.usernamedatasource.password配置项,配置新数据库连接。

例如,对于MySQL数据库,配置内容如下所示:

datasource.driverClassName=com.mysql.cj.jdbc.Driver
datasource.url=jdbc:mysql://localhost:3306/datagear
datasource.username=datagear
datasource.password=datagear

4、引入数据库驱动程序

在DataGear程序目录内,新建 lib/ 文件夹,然后将新数据库JDBC驱动程序文件拷贝至此文件夹内。

例如,对于MySQL的JDBC驱动程序库:

lib/mysql-connector-java-8.0.23.jar

修改DataGear启动脚本,在其中引入新数据库JDBC驱动程序库。

对于Linux系统,修改startup.sh启动脚本,将:

JAVA_OPTS=$JAVA_OPTS

修改为

JAVA_OPTS=-Xbootclasspath/a:lib/mysql-connector-java-8.0.23.jar $JAVA_OPTS

对于Windows系统,修改startup.bat启动脚本,将:

java -jar datagear-2.3.0.jar

修改为

java -Xbootclasspath/a:lib/mysql-connector-java-8.0.23.jar -jar datagear-2.3.0.jar

5、启动

执行启动脚本,启动DataGear。

注意:变更数据库需要DataGear-2.3.0及以上版本,旧版本程序存在数据库兼容问题。

官网地址:http://www.datagear.tech

源码地址:

Gitee:https://gitee.com/datagear/datagear

Github:https://github.com/datageartech/datagear

大屏模板地址:https://gitee.com/datagear/DataGearDashboardTemplate

展开阅读全文
加载中

作者的其它热门文章

打赏
1
0 收藏
分享
打赏
2 评论
0 收藏
1
分享
返回顶部
顶部