基于数组生效日期查询当前有效名称的ElasticSearch文档

嘿，针对你用NEST查询Elasticsearch中当前生效官方名称的需求，我整理了一套实用的解决方案，一起来看看吧！

先明确文档结构假设 #

因为你没贴具体映射，我先基于常见的生效周期设计做合理假设：你的文档里official_names是一个嵌套对象数组，每个对象包含名称、生效起始日期、生效结束日期，大概结构如下：

{
  "official_names": [
    {
      "name": "X",
      "start_date": "2014-01-01",
      "end_date": "2015-12-31"
    },
    {
      "name": "Y",
      "start_date": "2016-01-01",
      "end_date": "2018-12-31"
    }
  ]
}

如果你的结构略有不同，调整字段名即可。

核心查询思路 #

我们需要精准匹配同时满足两个条件的文档：

1. 数组中存在某个对象的name和目标名称一致
2. 该对象的start_date ≤ 当前UTC时间，且end_date ≥ 当前UTC时间（如果end_date为null表示永久生效，下面会补充这种情况的处理）

这里必须用Nested查询，避免出现“跨对象匹配”的误判（比如数组中一个对象的名称匹配，另一个对象的日期匹配，导致不符合要求的文档被查出）。

NEST代码实现 #

基础版本（end_date有明确截止日期） #

using Nest;
using System;
using System.Collections.Generic;

// 假设你的文档实体类定义
public class YourDocument
{
    public Guid Id { get; set; }
    public List<OfficialName> OfficialNames { get; set; }
}

public class OfficialName
{
    public string Name { get; set; }
    public DateTime StartDate { get; set; }
    public DateTime EndDate { get; set; }
}

// 查询逻辑
var targetName = "Y"; // 你要查找的目标名称
var now = DateTime.UtcNow; // 用UTC时间避免时区问题

var searchResponse = client.Search<YourDocument>(s => s
    .Query(q => q
        .Nested(n => n
            .Path(p => p.OfficialNames) // 指定嵌套数组的路径
            .Query(nq => nq
                .Bool(b => b
                    .Must(
                        // 匹配目标名称
                        m => m.Term(t => t.Field(f => f.OfficialNames.First().Name).Value(targetName)),
                        // 生效起始日期不晚于当前时间
                        m => m.Range(r => r.Field(f => f.OfficialNames.First().StartDate).LessThanOrEquals(now)),
                        // 生效结束日期不早于当前时间
                        m => m.Range(r => r.Field(f => f.OfficialNames.First().EndDate).GreaterThanOrEquals(now))
                    )
                )
            )
        )
    )
);

// 处理查询结果
if (searchResponse.IsValid)
{
    var matchingDocs = searchResponse.Documents;
    // 后续业务逻辑
}

适配end_date为null的场景（永久生效） #

如果你的设计中，end_date为null表示该名称至今有效，只需把日期条件改成Should组合：

// 替换Bool中的Must部分
.Bool(b => b
    .Must(
        m => m.Term(t => t.Field(f => f.OfficialNames.First().Name).Value(targetName)),
        m => m.Range(r => r.Field(f => f.OfficialNames.First().StartDate).LessThanOrEquals(now))
    )
    .Should(
        // 要么有明确的结束日期且未过期，要么结束日期不存在（永久生效）
        sh => sh.Range(r => r.Field(f => f.OfficialNames.First().EndDate).GreaterThanOrEquals(now)),
        sh => sh.Exists(e => e.Field(f => f.OfficialNames.First().EndDate).Exists(false))
    )
    .MinimumShouldMatch(1) // 至少满足一个Should条件
)

额外注意点 #

• 确保你的start_date和end_date在Elasticsearch映射中是date类型，否则Range查询会失效
• 如果需要匹配多个目标名称，把Term查询换成Terms查询即可
• 建议给official_names字段设置nested类型的映射，能大幅提升嵌套查询的效率

内容的提问来源于stack exchange，提问作者Lars Holdgaard