如何在Nest库的CreateIndexDescriptor中映射枚举？我的配置是否正确？

当前映射的问题 #

你的映射存在以下几个明显问题：

• 遗漏字段：实体定义中的LocalName字段未在映射中配置，会导致该字段无法被Elasticsearch正确索引和查询。
• 枚举类型映射不合理：RegionType作为枚举类型，当前映射为Text类型不合适。Text类型会对内容做分词处理，而枚举值是固定离散的，不需要分词，且Text类型无法高效支持精确匹配、聚合等操作。
• 数字类型未明确指定：Population映射为Number时未明确整数类型，虽然Elasticsearch可能自动推断，但显式指定能避免潜在的类型不兼容问题。

枚举类型的正确映射方式 #

枚举在Elasticsearch中有两种常用的映射方案，可根据业务需求选择：

1. 映射为Keyword类型：存储枚举的字符串名称，可读性强，适合需要直观查看枚举值或基于名称做精确匹配的场景。
2. 映射为Integer类型：存储枚举的整数值，占用空间更小，查询性能略优，适合对性能要求高或不需要直观查看枚举名称的场景。

修正后的完整映射代码 #

public static CreateIndexDescriptor CityMapping(this CreateIndexDescriptor descriptor)
{
    return descriptor.Map<City>(m => m.Properties(p => p
        .Keyword(k => k.Name(n => n.Id))
        .Text(t => t.Name(n => n.Name))
        // 补充LocalName字段，可根据需求选择Text或Keyword类型
        .Text(t => t.Name(n => n.LocalName))
        // 方案1：枚举映射为Keyword（存储字符串名称）
        .Keyword(k => k.Name(n => n.RegionType))
        // 方案2：枚举映射为Integer（存储枚举的整数值）
        // .Number(n => n.Integer(i => i.Name(nm => nm.RegionType)))
        .Number(n => n.Integer(i => i.Name(nm => nm.Population)))
        .Date(d => d.Name(n => n.CreateDate))
    ));
}

补充说明 #

• 若选择枚举映射为Keyword类型，默认情况下NEST客户端会自动将枚举序列化为字符串，若有自定义序列化逻辑需确保配置正确。
• 若选择枚举映射为Integer类型，需保证序列化时将枚举转换为对应的整数值，避免因类型不匹配导致索引失败。

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