移轉概觀

  • 發行項

在實際專案中，資料模型會隨著功能的實作 (新增和移除新的實體或屬性) 而變更，而且必須據以變更資料庫結構描述，使其與應用程式保持同步。 EF Core 中的移轉功能讓您能夠以累加方式來更新資料庫結構描述，讓它與應用程式的資料模型保持同步，同時將現有的資料保留在資料庫中。

概括而言，移轉的運作方式如下：

  • 引進資料模型變更時，開發人員會使用 EF Core 工具來新增對應的移轉，描述讓資料庫架構保持同步所需的更新。EF Core 會比較目前的模型與舊模型的快照集，以判斷差異，並產生移轉來源檔案;檔案可以在專案的原始檔控制中追蹤，就像任何其他原始程式檔一樣。
  • 一旦產生了新的移轉，就可以用各種方式將其套用到資料庫。 EF Core 會在特殊歷程記錄資料表中記錄所有套用的移轉，因此可知道已套用與尚未套用的移轉。

此頁面的其餘部分是使用移轉的逐步入門指南。 如需更深入的資訊，請參閱此節中的其他頁面。

開始使用

假設您剛完成第一個 EF Core 應用程式，其中包含下列簡單的模型：

public class Blog
{
    public int Id { get; set; }
    public string Name { get; set; }
}

在開發期間，您可能已使用建立及卸除 API 來快速逐一查看，並視需要變更您的模型；但既然您的應用程式即將進入生產階段，您需要一種方法來安全地使您的結構描述進化，而不需卸載整個資料庫。

安裝工具

首先，您必須安裝 EF Core 命令列工具：

建立第一個移轉

您現在已準備好加入第一個移轉！ 指示 EF Core 建立名為 InitialCreate 的移轉：

dotnet ef migrations add InitialCreate

EF Core 將會在專案中建立名為 Migrations 的目錄，並產生一些檔案。 最好的作法是檢查 EF Core 產生的確切項目，並視需要加以修改，但我們現在會跳過此程序。

建立您的資料庫與結構描述

此時，您可以讓 EF 建立您的資料庫，並從移轉建立您的結構描述。 這可以透過下列項目來完成：

dotnet ef database update

就是這麼簡單，您的應用程式已準備好在新的資料庫上執行，而且您不需要撰寫任何一行 SQL。 請注意，這種套用移轉的方式適用於本機開發，但較不適合用於生產環境。如需詳細資訊，請參閱套用移轉頁面。

發展您的模型

幾天過去了，而且有人要求您將建立時間戳記新增至您的部落格。 您已完成對應用程式進行的必要變更，而且您的模型現在看起來像這樣：

public class Blog
{
    public int Id { get; set; }
    public string Name { get; set; }
    public DateTime CreatedTimestamp { get; set; }
}

您的模型與生產資料庫現在已不同步，我們必須將新的資料行加入您的資料庫結構描述。 讓我們為此建立新的移轉：

dotnet ef migrations add AddBlogCreatedTimestamp

請注意，我們會為移轉提供描述性名稱，讓您稍後可以更輕鬆地了解專案歷程記錄。

由於這不是專案的第一次移轉，因此在加入資料行之前，EF Core 現在會將已更新的模型與舊模型的快照集進行比較；模型快照集是當您加入移轉時 EF Core 所產生的其中一個檔案，而且會簽入原始程式碼控制中。 根據該比較，EF Core 會偵測到已新增資料行，並新增適當的移轉。

您現在可以像之前一樣套用移轉：

dotnet ef database update

請注意，這次 EF 會偵測到資料庫已經存在。 此外，第一次套用上面的移轉時，此事實會記錄在資料庫的特殊移轉歷程記錄資料表中；這可讓 EF 僅自動套用新的移轉。

排除模型的元件

有時候您可能會想要從另一個 DbCoNtext 參考類型。 這可能會導致移轉衝突。 若要避免這種情況，請將類型從其中一個 DbCoNtexts 移轉中排除。

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<IdentityUser>()
        .ToTable("AspNetUsers", t => t.ExcludeFromMigrations());
}

下一步

以上只是簡單的移轉簡介。 請參閱其他文件頁面，以深入了解管理移轉、 套用移轉與其他層面。 .NET Core CLI 工具參考也包含不同命令的實用資訊

其他資源