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

닷넷 10 릴리스와 함께 공개된 Entity Framework Core 10은 그동안 C# 개발자들이 우회 방식으로 해결하던 오랜 불편을 덜어내는 데 초점을 맞췄습니다. 복잡한 쿼리 작성법을 단순화하고, 최신 인공지능 워크로드를 데이터 계층에서 처리할 수 있도록 돕는 기능들이 포함되었습니다.

새로운 쿼리 메서드와 벡터 검색 기능, 그리고 기존 프로젝트 업그레이드 시 주의해야 할 주요 변경 사항을 차례로 정리합니다.

드디어 추가된 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 구문과 일대일로 대응되는 직관적인 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-ef CLI 도구 명령을 실행할 때 --framework 옵션을 명시적으로 지정해야 합니다. 옵션이 누락되면 마이그레이션 도구가 대상을 식별하지 못하고 오류를 반환합니다.

SQL Server 2025 또는 Azure SQL을 호환성 수준 170 이상에서 사용하는 경우, 기본 컬렉션 데이터 타입 매핑이 기존 nvarchar(max)에서 네이티브 json 타입으로 자동 변경됩니다. 기존 JSON 직렬화 컬럼 데이터를 마이그레이션할 때 데이터베이스 호환성 설정을 검토해야 합니다.