WTM的專案中EFCore如何適配人大金倉資料庫

踏平扶桑發表於2024-07-08

一、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到人大金倉的資料庫遷移。

相關文章