EF Core 6：如何通过三元组匹配批量查询带关联的数据

针对你在EF Core 6中基于多列三元组筛选实体并关联查询的需求，提供两种高效方案：

方案一：值元组Contains查询（适合三元组数量较少场景） #

EF Core 5及以上版本支持直接使用值元组的Contains方法实现多列匹配，会自动转换为SQL的多列IN子句，且完全兼容Include关联查询。

代码示例 #

1. 准备三元组列表：

var targetTriples = new List<(int SchoolId, int SchoolYearId, int ItemId)>
{
    (1, 2024, 100),
    (2, 2024, 101),
    // 按需添加更多三元组
};

2. 执行查询（包含关联查询）：

var matchedEntities = await dbContext.YourEntityName
    .Where(entity => targetTriples.Contains((entity.SchoolId, entity.SchoolYearId, entity.ItemId)))
    .Include(entity => entity.RelatedEntityA) // 关联查询所需实体
    .Include(entity => entity.RelatedEntityB)
    .ToListAsync();

EF Core会生成类似以下的SQL：

SELECT * 
FROM YourEntityName
WHERE (SchoolId, SchoolYearId, ItemId) IN ((1,2024,100), (2,2024,101), ...)

方案二：表值参数（TVP）查询（适合三元组数量较多场景） #

当三元组数量较大时，IN子句可能触发SQL参数数量限制或性能下降，此时表值参数是更优选择，且同样支持Include关联查询。

步骤说明 #

1. 在数据库中创建表值类型：

CREATE TYPE SchoolItemTripleType AS TABLE (
    SchoolId INT,
    SchoolYearId INT,
    ItemId INT
);

2. C#中定义对应的数据类：

public class SchoolItemTriple
{
    public int SchoolId { get; set; }
    public int SchoolYearId { get; set; }
    public int ItemId { get; set; }
}

3. 在DbContext中配置无键实体映射：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<SchoolItemTriple>().HasNoKey(); // 表值类型无需主键
}

4. 构建表值参数并执行查询：

// 准备三元组数据
var tripleData = new List<SchoolItemTriple>
{
    new SchoolItemTriple { SchoolId = 1, SchoolYearId = 2024, ItemId = 100 },
    new SchoolItemTriple { SchoolId = 2, SchoolYearId = 2024, ItemId = 101 },
    // 更多数据
};

// 创建表值参数
var tvpParameter = new SqlParameter("@Triples", SqlDbType.Structured)
{
    TypeName = "SchoolItemTripleType",
    Value = tripleData
};

// 执行关联查询
var matchedEntities = await dbContext.YourEntityName
    .FromSqlRaw(@"
        SELECT e.* 
        FROM YourEntityName e
        INNER JOIN @Triples t 
            ON e.SchoolId = t.SchoolId 
            AND e.SchoolYearId = t.SchoolYearId 
            AND e.ItemId = t.ItemId
    ", tvpParameter)
    .Include(entity => entity.RelatedEntityA)
    .Include(entity => entity.RelatedEntityB)
    .ToListAsync();

注意事项 #

• 方案一需确认数据库支持多列IN子句（SQL Server、PostgreSQL、MySQL 8.0.19+均支持）；
• 方案二需保证表值类型的字段与C#类的属性名、类型完全匹配。

内容的提问来源于stack exchange，提问作者Emery Noel