作為程式員,在日常開發中,記憶猶新的莫過於寫代碼,升級程式。升級程式包含兩部分:一是,對服務程式更新;二是,對資料庫結構更新。本篇博文主要介紹資料庫結構更新,在對資料庫升級時,不知道園友們是否有如下經歷: 1)腳本文件中建表語句未作判斷是否存在,而導致執行失敗。 2)腳本文件中修改欄位在建表語句之前 ...
作為程式員,在日常開發中,記憶猶新的莫過於寫代碼,升級程式。升級程式包含兩部分:一是,對服務程式更新;二是,對資料庫結構更新。本篇博文主要介紹資料庫結構更新,在對資料庫升級時,不知道園友們是否有如下經歷:
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()實現自動升級資料庫。