Entity Framework Core

[アーティクル]
2023/08/24

Entity Framework (EF) Core は人気の Entity Framework データアクセステクノロジの軽量版であり、拡張性に優れ、オープンソースで、プラットフォームに依存しません。

EF Core は、次のようなオブジェクトリレーショナルマッパー (O/RM) として機能します。

.NET 開発者が .NET オブジェクトを使用してデータベースを操作できるようにする。
通常記述しなければならないデータアクセスコードの多くを不要にする。

EF Core は多くのデータベースエンジンに対応しています。詳細については、「Database Providers」(データベースプロバイダー) を参照してください。

モデル

EF Core では、データアクセスはモデルを利用して実行されます。モデルはエンティティクラスと、データベースとのセッションを表すコンテキストオブジェクトから構成されます。このコンテキストオブジェクトにより、データのクエリと保存が可能になります。詳しくは、「モデルの作成」をご覧ください。

EF は、次のモデル開発アプローチをサポートしています。

既存のデータベースからモデルを生成する。
データベースに合わせてモデルのコードを手動で書く。
モデルが作成されたら、EF の移行を使用して、モデルからデータベースを作成します。移行により、モデルの変更に応じてデータベースを進化させることができます。

using System.Collections.Generic;
using Microsoft.EntityFrameworkCore;

namespace Intro;

public class BloggingContext : DbContext
{
    public DbSet<Blog> Blogs { get; set; }
    public DbSet<Post> Posts { get; set; }

    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
    {
        optionsBuilder.UseSqlServer(
            @"Server=(localdb)\mssqllocaldb;Database=Blogging;Trusted_Connection=True;ConnectRetryCount=0");
    }
}

public class Blog
{
    public int BlogId { get; set; }
    public string Url { get; set; }
    public int Rating { get; set; }
    public List<Post> Posts { get; set; }
}

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

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

クエリ実行

エンティティクラスのインスタンスは、統合言語クエリ (LINQ) を利用し、データベースから取得されます。詳しくは、「データのクエリ」をご覧ください。

using (var db = new BloggingContext())
{
    var blogs = await db.Blogs
        .Where(b => b.Rating > 3)
        .OrderBy(b => b.Url)
        .ToListAsync();
}

データの保存

データはエンティティクラスのインスタンスを利用し、データベース内で作成、削除、変更されます。詳細については、「Saving Data」 (データの保存) を参照してください。

using (var db = new BloggingContext())
{
    var blog = new Blog { Url = "http://sample.com" };
    db.Blogs.Add(blog);
    await db.SaveChangesAsync();
}

EF O/RM の考慮事項

EF Core は多くのプログラミングの詳細を抽象化するのに適していますが、運用アプリでよくある落とし穴を回避するために、どの O/RM にも適用できるいくつかのベストプラクティスがあります。

高パフォーマンスの運用アプリでデータを設計、デバッグ、プロファイル、移行するには、基になるデータベースサーバーの中級レベル以上の知識が不可欠です。たとえば、主キーと外部キー、制約、インデックス、正規化、DML および DDL のステートメント、データ型、プロファイルなどの知識です。
機能と統合のテスト: 運用環境は、できるだけ次が行われるようにレプリケートすることが重要です。
- 特定のバージョンまたはエディションのデータベースサーバーを使用している場合にのみ表示される、アプリのイシューを検索する。
- EF Core およびその他の依存関係をアップグレードするときに、破壊的変更をキャッチする。たとえば、ASP.NET Core、OData、AutoMapper などのフレームワークの追加またはアップグレードです。これらの依存関係は、予期しない形で EF Core に影響を与える可能性があります。
代表的な負荷によるパフォーマンスとストレステスト。一部の機能は、そのまま使用しても、あまりスケーリングされません。たとえば、複数コレクションのインクルード、遅延読み込みの頻繁な使用、非インデックス列に対する条件付きのクエリ、ストアで生成された値を使用した大規模な更新と挿入、コンカレンシー処理の欠如、大規模なモデル、不適切なキャッシュポリシーなどです。
セキュリティレビュー: たとえば、接続文字列やその他のシークレットの処理、デプロイ操作以外でのデータベースのアクセス許可、生 SQL の入力検証、機密データの暗号化などがあります。セキュリティで保護された構成と認証フローについては、「安全な認証フロー」を参照してください。
ログと診断が十分であり、使用可能であることを確認します。たとえば、適切なログ構成、クエリタグ、Application Insights などです。
エラー回復。バージョンのロールバック、サーバーのフォールバック、スケールアウトと負荷分散、DoS の軽減、データバックアップなど、一般的なエラーのシナリオの緊急時に対する準備を行います。
アプリケーションの配置と移行。配置中に移行がどのように適用されるかを計画します。これをアプリケーションの起動時に実行すると、コンカレンシーのイシューが発生し、通常の操作に必要なものより高いアクセス許可が必要になります。ステージングを使用して、移行中の致命的なエラーからの回復を容易にします。詳しくは、「移行の適用」をご覧ください。
生成された移行の詳細な調査とテスト。移行は、運用データに適用する前に十分にテストする必要があります。テーブルに運用データが格納されると、スキーマの構造と列の型を簡単に変更することはできません。たとえば、SQL Server では、nvarchar(max) と decimal(18, 2) が文字列と 10 進数のプロパティにマップされた列に最適な型になることはまれですが、EF では特定のシナリオについての知識がないために、既定値として使用されます。

次のステップ

入門チュートリアルについては、「Entity Framework Core の概要」を参照してください。

AI Skills Fest

次の方法で共有

Entity Framework Core

モデル

クエリ実行

データの保存

EF O/RM の考慮事項

次のステップ

その他のリソース