Translated from Korean

EF Core 10 업데이트 살펴보기: LeftJoin과 벡터 검색 실전 적용 가이드

EF Core 10アップデート解説：LeftJoinとベクトル検索の実践ガイド

.NET 10のリリースとともに公開されたEntity Framework Core 10は、これまでC#開発者が回避策で解決してきた長年の不便を解消することに焦点を当てています。複雑なクエリの記述を簡素化し、最新のAIワークロードをデータ層で処理可能にする機能が追加されました。

新しいクエリメソッドやベクトル検索機能、そして既存プロジェクトをアップグレードする際に注意すべき主な変更点を順にまとめます。

ついに実装されたLeftJoin LINQ演算子

これまでのEF Coreで外部結合を記述するにはGroupJoinを呼び出した後、DefaultIfEmptyとSelectManyを連鎖呼び出しする必要がありました。コードが無駄に長くなり、初心者には直感的に理解しにくい構造でした。

EF Core 10ではクエリ記述の直感性を高めるため、LeftJoinとRightJoin演算子を標準LINQ APIとしてサポートします。テーブル間の関係探索プロパティを直接利用しにくいシナリオでも簡潔に記述可能です。

以下はEF Core 10でLeftJoinを使用する例です。

csharp

// EF Core 10 기준
var query = dbContext.Users
    .LeftJoin(
        dbContext.Orders,
        user => user.Id,
        order => order.UserId,
        (user, order) => new { user.Name, OrderAmount = (decimal?)order.Amount }
    )
    .ToListAsync();

不要なネストされたラムダなしで、SQLのLEFT JOIN構文と1対1で対応する直感的なLINQコードを構成できます。

SqlVectorとネイティブベクトル検索のサポート

埋め込みベクトルを保存して類似度を検索する検索増強生成（RAG）アーキテクチャの導入増加に伴い、EF Core 10はデータベース次元でのベクトル演算を公式サポートします。

SqlVector<T>形式とEF.Functions.VectorDistanceメソッドを通じて、Azure SQLおよびSQL Server 2025環境において、サードパーティライブラリなしで類似度ベースのクエリを実行できます。

csharp

// EF Core 10 기준
var queryVector = new SqlVector<float>(userEmbedding);

var documents = await dbContext.Documents
    .OrderBy(doc => EF.Functions.VectorDistance("cosine", doc.Embedding, queryVector))
    .Take(5)
    .ToListAsync();

データベースエンジン内部でコサイン類似度演算が最適化されて実行されるため、バックエンドアプリケーションに大容量ベクトルをダウンロードして計算する必要はありません。

ExecuteUpdateAsyncにおける非式ラムダのサポート

大量データを修正する際に使用するExecuteUpdateAsyncメソッドも柔軟になりました。以前のバージョンではラムダ式内部の制約が厳しく、動的条件や複数のカラムの条件付き更新を組み合わせる際に制限が多くありました。

EF Core 10は非式の一般ラムダ文法を受け入れるようになり、条件文の分岐に応じて更新対象カラムをより動的かつ柔軟に構成できるようになりました。

プロジェクト移行時に確認すべき破壊的変更

EF Core 10への移行前に必ず確認すべき変更点がいくつかあります。

ランタイム要件が.NET 10 SDKおよびランタイムに制限されます。下位ランタイムバージョンとの互換性はサポートされないため、ソリューション全体のターゲットフレームワークを更新する必要があります。

複数のターゲットフレームワークを指定したマルチターゲットプロジェクトの場合、dotnet-efCLIツールコマンドを実行する際に--frameworkオプションを明示的に指定する必要があります。このオプションがない場合、マイグレーションツールはターゲットを識別できずエラーを返します。

SQL Server 2025またはAzure SQLを互換性レベル170以上で使用する場合、デフォルトのコレクションデータ型マッピングが従来のnvarchar(max)からネイティブのjson型に自動変更されます。既存のJSONシリアル化カラムデータを移行する際は、データベースの互換性設定を見直す必要があります。