DataGear 5.2.0+ 版本变更部署数据库操作指南

DataGear 企业版 1.3.0 已发布，欢迎体验！ http://datagear.tech/pro/

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

如果希望变更数据库（比如MySQL、Oracle、PostgreSQL、SQL Server），则需要预先准备数据库环境，手动初始化和管理数据库结构。

在之前的版本中，变更部署数据库除了要手动初始化数据库、安装JDBC驱动库，还要修改startup.sh、startup.bat启动脚本，最严重的是，无法支持JDK 9+版本的运行环境。

在5.2.0版本，对此做了改进，无需再修改startup.sh、startup.bat启动脚本，并且可以支持JDK 9+版本的运行环境。

详细的变更部署数据库步骤如下所示。

1、手动初始化数据库

参考DataGear源码仓库（见本文末尾）中内置的Derby数据库初始化SQL脚本（datagear-management/src/main/resources/org/datagear/management/ddl/datagear.sql），编写新数据库SQL语法规范的初始化SQL脚本，然后执行它们初始化数据库。

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

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

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

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

或

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

注意：上述SQL语句中的 当前版本号 应替换为实际DataGear版本号，比如：5.2.0

3、配置数据库连接

在config/application.properties添加datasource.driverClassName、datasource.url、datasource.username、datasource.password配置项，配置新数据库连接。

例如，对于MySQL数据库，配置内容如下所示：

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

4、安装数据库驱动库

将新数据库JDBC驱动库文件拷贝至DataGear程序目录的 lib/ 文件夹内，例如，MySQL的JDBC驱动库：

lib/mysql-connector-java-8.0.23.jar

5、启动

完成变更部署数据库，启动DataGear即可。

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

源码地址：

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

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

GitCode：https://gitcode.com/datageartech/datagear