WTM的項目中EFCore如何適配人大金倉資料庫

一、WTM是什麼

WalkingTec.Mvvm框架（簡稱WTM）最早開發與2013年，基於Asp.net MVC3 和 最早的Entity Framework, 當初主要是為瞭解決公司內部開發效率低，代碼風格不統一的問題。
2017年9月，將代碼移植到了.Net Core上，併進行了深度優化和重構，推出了基於Asp.net Core和EF Core的全新框架，新框架在架構，穩定性，速度上都有長足進步，真正成為一款高效開發的利器。
經歷了四年間數十個項目的考驗，框架逐步的完善，推出了四個主要版本。
WTM框架設計的核心理念就是”盡一切可能提高開發效率“。
WTM框架把常規編碼結構化，重覆編碼自動化，它不僅是一個框架，它是強有力的生產力工具！
在不分離的模式下，它連通了前臺UI和後臺代碼。你不需要前後臺分離，不需要兩個人配合，減少成本，縮短工期。
在前後端分離的模式下，同樣可以使用代碼生成器同時生成前臺和後臺的代碼，極大的降低了前後端人員的溝通成本，從本質上提升了開發效率，讓“分離”不再複雜和昂貴。
框架特點：
一鍵生成WTM項目
一鍵生成增刪改查，導入導出，批量操作代碼
支持一對多，多對多關聯模型的識別和代碼生成
支持React+AntD,Vue+Element,LayUI,Blazor等多種前端模式
支持sqlserver，mysql，pgsql，sqlite，Oracle等多種資料庫
封裝了Layui，AntD，Element的大部分控制項，編寫前臺更加簡便
提供了很多基類，封裝了絕大部分後臺常用操作
提供了用戶，角色，用戶組，菜單，日誌等常用模塊
支持數據許可權的開發和配置
支持讀寫分離和資料庫分庫

開源地址：
(GitHub) https://github.com/WalkingTec/WalkingTec.Mvvm
(Gitee) https://gitee.com/liuliang-wtm/WTM

二、人大金倉是什麼
人大金倉資料庫管理系統[簡稱:KingbaseES]是北京人大金倉信息技術股份有限公司[簡稱人大金倉]的核心產品，具有大型通用、"三高"（高可靠、高性能、高安全）、"三易"（易管理、易使用、易擴展）、運行穩定等特點，是唯一入選國家自主創新產品目錄的資料庫產品，也是國家級、省部級實際項目中應用最廣泛的國產資料庫產品。
人大金倉資料庫管理系統 KingbaseES（KES） 是面向全行業、全客戶關鍵應用的企業級大型通用資料庫管理系統，適用於聯機事務處理、查詢密集型數據倉庫、要求苛刻的互聯網應用等場景，提供全部應用開發及系統管理功能，提供性能增強特性，可支持主備集群、讀寫分離集群、多活共用存儲集群等全集群架構，具有高性能、高安全、高可用、易使用、易管理、易維護的特點，支持所有國內外主流CPU、操作系統與雲平臺部署。
下載試用地址：
https://www.kingbase.com.cn/xzzx/index.htm
可在下載頁面申請開發試用授權文件，授權時間365天。
安裝過程比較簡單，唯一需要註意的就是在安裝過程中可以選擇資料庫相容類型，這裡選擇的是UTF8字元集，相容MySql，大小寫不敏感。

三、遷移註意事項

項目用的是.NET6框架，在項目里引用（或者NuGet安裝）人大金倉官方的EFCore的Kdbndp驅動Kdbndp.EntityFrameworkCore6.KingbaseES。

1、工作流使用的資料庫所屬模式手動創建

WTM集成了Elsa的工作流，在遷移的過程中需要把Elsa所需要的幾個表遷移到特定的模式下麵，否則運行會提示找不到Elsa.xxxx的錯誤提示；

模式右鍵-->新建-->Elsa，然後把所需要的這幾個表遷移到它下麵。

2、欄位類型轉換

絕大部分的Mysql欄位可以無縫遷移到人大金倉，對於mysql的bool類型的欄位需要特別關註一下，會遷移成bit或者int類型，需要手動調整成人大金倉的bool類型；

mysql的datetime類型，遷移到人大金倉後對應的類型是timestamp。這個需要在DataContext的OnConfiguring中指定一下參數，否則會報以下錯誤：

System.InvalidCastException: Cannot write DateTime with Kind=Local to PostgreSQL type 'timestamp with time zone', only UTC is supported. Note that it's not possible to mix DateTimes with different Kinds in an array/range. See the Npgsql.EnableLegacyTimestampBehavior AppContext switch to enable legacy behavior.

具體參考：https://www.npgsql.org/doc/types/datetime.html#timestamps-and-timezones

protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
		{
			if (DBType == DBTypeEnum.PgSql)
			{
				AppContext.SetSwitch("Npgsql.EnableLegacyTimestampBehavior", true);
				AppContext.SetSwitch("Npgsql.DisableDateTimeInfinityConversions", true);
			}
			base.OnConfiguring(optionsBuilder);
		}

2、自增欄位實現

在mysql、sqlserver等資料庫中，只要把欄位設置為int，然後打開自增選項後，欄位就會實現自增功能。在人大金倉中，預設沒有這種欄位類型，官網中稱這種為序數類型，類似於Oracle的SEQUENCE：

smallserial、serial 和 bigserial類型不是真正的類型， 它們只是為了創建唯一標識符列而存在的方便符號（類似其它一些資料庫中支持的 AUTO_INCREMENT 屬性）。 這是 KingbaseES 特有的創建一個自增列的方法。

因為 smallserial、serial 和 bigserial 是用序列實現的，所以即使沒有刪除過行，在出現在列中的序列值可能有“空洞”或者間隙。如果一個從序列中分配的值被用在一行中，即使該行最終沒有被成功地插入到表中，該值也被“用掉”了。例如，當插入事務回滾時就會發生這種情況。更多信息參見序列操作函數中的 nextval()。

在人大金倉中需要通過序列類型實現欄位自增的方式，需要我們在資料庫的Public模式下的序列中，創建一個序列（這裡設置的最大值為bigint的最大值附近，具體可自己決定）：

隨後，在需要自增的欄位，給它的預設值設置為 nextval('USER_SEQUENCE'::regclass)  ，這樣在每次insert數據的時候，這個欄位會自動從序列中獲取最新的值來填充（不需要代碼中進行賦值）。

至此就基本完成了mysql到人大金倉的資料庫遷移。