技術情報ブログ

Artisanトップ
技術情報ブログ
C# EFCore マイグレーションを使用したコードファーストな開発

c#: 2021.07.30

C# EFCore マイグレーションを使用したコードファーストな開発

アプリ開発の調査にかかる
時間を削減したい

内製化支援サービス

アプリを自分たちで
作成できるようになりたい

DX人材育成プログラム

プロに開発を依頼したい

アプリ開発導入支援サービス

SharePoint デザイン拡張サービス

X-SP Design

モダン化から運用管理までサポート

移行・モダン化コンサルティング

こんにちは、アーティサン株式会社の戸田隆俊と申します。

私は主に C#でのバックエンド開発を担当しております。

近年、人気となっているフレームワークには様々な OR マッパーが採用されています。

しかし、OR マッパーの機能を生かし切れていないプロジェクトもあるかと思います。

今回は OR マッパーのマイグレーションのうち、EF Core でのサンプルをご紹介いたします。

EF Coreは C#の代表的O/Rマッパーですので、データベース接続するプロジェクトでは、即戦力ともいえるのではないでしょうか。

マイグレーションを活用することでデータベースやテーブルの状態を意識することなくコーディングに専念でき、開発速度の向上を実現できます。

また、手動でテーブル修正を行ったことにより発生するエンティティとカラムのずれや、共有漏れを防ぐことが出来ます。

環境

.Net Core 3.1
EF Core 3.1.10

O/Rマッパーとは

プログラミング言語におけるオブジェクトと、データベース間での相互変換を行うライブラリや機能のことです。

C#では一般的にテーブルレコードからクラスへの変換や、その逆の操作を自動的に行ってくれます。

EF Coreとは

ntity Framework の後継 OR マッパーです。

ほとんどの機能が EF Core に実装されていますが、全てではありません。しかし、Microsoft は Entity Framework は積極的に開発していないと名言しているため、今後は EF Core を使っていくのがベターかと思います。

以下は Microsoft へのリンクです。細かな違いはリンクをご確認ください。

EF Core と EF6 を比較する

シナリオ

プロジェクトを進めていく中でテーブルやカラム、型の変更等は頻繁に発生します。

今回は以下のBlog、Postエンティティに備考カラムを追加する場合のシナリオを例にご説明します。

Post エンティティ

投稿エンティティです。投稿 ID、タイトル、コンテンツを持ちます。

7,8 行目でブログエンティティと n:1 のリレーションシップが構築されます。

public class Blog
{
    public int BlogId { get; set; }
    public string Url { get; set; }

    public List<Post> Posts { get; } = new List<Post>();
}

SQL を使用した開発

まずは SQL を使用した場合の開発手法をご説明します。

エンティティに備考カラムを追加

Blog、Post エンティティに備考カラムを追加

実際のソースコードは以下のようになります。

Post エンティティ

5 行目に備考カラムが追加されています。

public class Blog
{
    public int BlogId { get; set; }
    public string Url { get; set; }
    public string Remarks { get; set; }

    public List<Post> Posts { get; } = new List<Post>();
}

Post エンティティ

6 行目に備考カラムが追加されています。

public class Post
{
    public int PostId { get; set; }
    public string Title { get; set; }
    public string Content { get; set; }
    public string Remarks { get; set; }

    public int BlogId { get; set; }
    public Blog Blog { get; set; }
}

SQL を使用してデータベースを修正

今回は検証用にSQLite3を使用していますので、以下の SQL を発行してデータベースを修正します。

alter table Blogs add column Remarks text;
alter table Posts add column Remarks text;

問題点

上記の手順には以下のような問題点があります。

SQL を理解している開発者が必要
別途変更履歴を保持する必要がある
テーブルの変更の都度 SQL を発行する必要がある

マイグレーションを活用した開発

以下が実際のマイグレーション作業です。

エンティティへのカラム追加については、エンティティに備考カラムを追加と同様ですので省略します。

Post エンティティ

実際に使用しているターミナルでコマンドを実行します。

今回はコマンドプロンプトで実行しています。

dotnet ef migrations add AddRemarks
dotnet ef database update

dotnet ef migrations addを実行したタイミングで差分クラスが作成されるので、どのような修正をしたのか後で確認することが出来ます。

以下が実際のファイル(AddRemarks)です。

5 行目、10 行目を見るとPostsとBlogsにRemarksカラムを追加していることが分かります。

public partial class AddRemarks : Migration
{
    protected override void Up(MigrationBuilder migrationBuilder)
    {
        migrationBuilder.AddColumn<string>(
            name: "Remarks",
            table: "Posts",
            nullable: true);

        migrationBuilder.AddColumn<string>(
            name: "Remarks",
            table: "Blogs",
            nullable: true);
    }

    protected override void Down(MigrationBuilder migrationBuilder)
    {
        migrationBuilder.DropColumn(
            name: "Remarks",
            table: "Posts");

        migrationBuilder.DropColumn(
            name: "Remarks",
            table: "Blogs");
    }
}