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版本号：

注意：上述SQL語句中的 目前版本号 應替換為實際DataGear版本号，比如：2.3.0

3、配置資料庫連接配接

在config/application.properties添加datasource.driverClassName、datasource.url、datasource.username、datasource.password配置項，配置新資料庫連接配接。

例如，對于MySQL資料庫，配置内容如下所示：

4、引入資料庫驅動程式

修改DataGear啟動腳本，在其中引入新資料庫JDBC驅動程式庫。

對于Linux系統，應修改startup.sh啟動腳本，例如，将：

修改為

對于Windows系統，應修改startup.bat啟動腳本，例如，将：

5、啟動

執行啟動腳本，啟動DataGear。

注意：變更資料庫需要DataGear-2.3.0及以上版本，舊版本程式存在資料庫相容問題。