作為程序員,在日常開發中,記憶猶新的莫過於寫代碼,升級程序。升級程序包含兩部分:一是,對服務程序更新;二是,對數據庫結構更新。本篇博文主要介紹數據庫結構更新,在對數據庫升級時,不知道園友們是否有如下經歷:
1)腳本文件中建表語句未作判斷是否存在,而導致執行失敗。
2)腳本文件中修改字段在建表語句之前,關聯存儲過程執行順序顛倒而導致執行失敗。
3)各個歷史腳本文件代碼重復又重復,如存儲過程代碼在多個腳本文件中存在。
4)新客戶往往要執行多個腳本文件,才能使用最新的產品。
可以說,數據庫升級是否能成功,成了眾多程序員特別是團隊管理者的心病了。接下來,詳細介紹使用EF Core實現數據庫升級。
一.使用EF Core命令方式進行遷移數據庫
1. 程序包管理器控制台(PMC)遷移數據庫
1)准備好實體(對應數據庫表),數據庫操作類,數據庫連接字符串,及數據庫操作服務。
a.學生實體類
public class Student { public int ID { get; set; } public string FirstName { get; set; } public string LastName { get; set; } }
b.數據庫操作類
public class SchoolDB:DbContext { public SchoolDB(DbContextOptions<SchoolDB> options) : base(options)
{ } public DbSet<Student> Students { get; set; } protected override void OnModelCreating(ModelBuilder modelBuilder) { modelBuilder.Entity<Student>().ToTable(nameof(Student)); } }
c.在appsettings.json中配置數據庫連接字符串
{
"Logging": {
"LogLevel": {
"Default": "Information",
"Microsoft": "Warning",
"Microsoft.Hosting.Lifetime": "Information"
}
},
"AllowedHosts": "*",
"ConnectionStrings": {
"SchoolDB": "Server=ERQFJF;Database=SchoolDB;User ID=sa;Password=******"
}
}
d.在Startup中注入數據庫操作服務
public void ConfigureServices(IServiceCollection services) { services.AddControllersWithViews(); services.AddDbContext<SchoolDB>((options) => { options.UseSqlServer(Configuration.GetConnectionString("SchoolDB")); }); }
e.如下圖:是整個代碼初始架構及數據庫情況,方便后續操作過程進行比較
2)打開PMC,如下圖
3)接下來可以在PMC中輸入相關命令來創建迭代版本,升級數據庫。
a.使用Add-Migration命令創建迭代版本:如下圖
b.使用Update-Database升級數據庫:如下圖
升級數據庫命令Update-Database
升級后結果
4)當實體模型有更新時(如新增實體,新增實體屬性,修改實體屬性等),重復2(使用Add-Migration創建迭代文件),3(使用Update-Database更新數據庫)步驟,實現數據 庫(表)與程序(實體)同步,達成數據庫升級。
2.迭代文件說明,如下圖
3.缺陷說明:
PMC只能在Visual Studio下運行,在生產環境下無法使用,即無法在生產環境下使用PMC升級數據庫。
或許有園友會說,可以把其導出腳本放到數據庫中執行,這種方式只適合於首次使用產品的用戶,對於已經使用產品的用戶,則會存在以下問題:
1)導出的腳本不能直接使用,如創建表,新增字段等沒有做任何判斷,需要修改相關腳本。
2)若有很多客戶,每個客戶的升級的版本都不一致,要逐個客戶導出適用的腳本,工作量巨大
3)有些客戶的數據庫服務器管理很嚴,外部人員不能直連數據庫操作
二.自動升級數據庫
1.前面2個步驟,與PMC一致
准備好實體(對應數據庫表),數據庫操作類,數據庫連接字符串,及數據庫操作服務。
通過Add-Migration命令創建迭代文件
2.通過DatabaseFacade.Migrate方法進行自動升級數據庫,代碼如下圖
三.總結
1.通篇介紹下來,基本上是關於數據庫升級。那什么是數據庫遷移:其實就是數據庫升級,數據庫架構更新。
2.使用命令方式升級數據庫,除了PMC,還有CLI,其操作步驟相似,只是命令不一樣。下表列出了兩種方式的命令:
3.使用DatabaseFacade.Migrate()實現自動升級數據庫。