DataGear 變更部署數據庫操作指南

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腳本。

提示：初始化腳本里的 DATAGEAR_REPLACEREGEX 函數及其相關的SQL語句都可以忽略，它們僅用作舊版本數據升級，沒有在程序裏使用。

2、手動更新數據庫版本號表

手動執行如下SQL語句，更新當前DataGear版本號：

UPDATE DATAGEAR_VERSION SET VERSION_VALUE='當前版本號'

注意：上述SQL語句中的 當前版本號 應替換爲實際DataGear版本號，比如：2.3.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、引入數據庫驅動程序

修改DataGear啓動腳本，在其中引入新數據庫JDBC驅動程序庫。

對於Linux系統，應修改startup.sh啓動腳本，例如，將：

JAVA_OPTS=$JAVA_OPTS

修改爲

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

對於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