ElasticSearch NEST(C#)：如何通过注解配置数字格式？

当然可以！你完全不用每次都去Kibana里手动配置数字格式，通过NEST结合C#的POCO类，不管是用注解还是代码配置都能轻松实现。下面给你两种常用的方案：

方式一：通过POCO类注解直接配置 #

NEST提供了NumberAttribute注解，你可以直接在POCO的数字字段上指定格式，这样在创建索引时，Elasticsearch会自动应用这个格式配置。

比如下面的例子，我们给价格字段设置保留两位小数的格式，给折扣率设置百分比格式：

public class Product
{
    // 设置为保留两位小数的格式（如199.99）
    [Number(Format = "0.00")]
    public decimal Price { get; set; }

    // 设置为百分比格式（如0.25会显示为25%）
    [Number(Format = "percent")]
    public double DiscountRate { get; set; }

    // 千分位分隔+两位小数（如1234.56显示为1,234.56）
    [Number(Format = "#,###.00")]
    public long SalesVolume { get; set; }
}

当你用这个POCO类创建索引时，NEST会自动把格式参数写入Elasticsearch的字段映射中，Kibana识别到后就会直接使用这个格式，不用再手动配置了。

方式二：通过NEST Fluent API手动构建映射 #

如果你的映射配置比较复杂，或者需要动态调整，用Fluent API会更灵活。比如在创建索引时，手动指定每个数字字段的格式：

var settings = new ConnectionSettings(new Uri("http://localhost:9200"))
    .DefaultIndex("products");

var client = new ElasticClient(settings);

// 创建索引并配置映射
var createIndexResponse = client.Indices.Create("products", c => c
    .Map<Product>(m => m
        .Properties(p => p
            .Number(n => n
                .Name(f => f.Price)
                .Format("0.00")
                .Type(NumberType.Double)
            )
            .Number(n => n
                .Name(f => f.DiscountRate)
                .Format("percent")
                .Type(NumberType.Double)
            )
        )
    )
);

补充：Elasticsearch支持的数字格式 #

你可以使用Elasticsearch内置的格式，也可以自定义格式：

• 内置格式：
  • percent：百分比格式（如0.3 → 30%）
  • currency：货币格式（如123 → $123.00，会根据Kibana的本地化设置调整）
  • number：默认的数字格式
• 自定义格式：使用类似Java DecimalFormat的语法，比如：
  • 0.00：强制保留两位小数
  • #,###：千分位分隔
  • #.##：最多保留两位小数（自动省略末尾的0）

如何更新已有索引的字段格式 #

如果索引已经创建，你也可以通过更新映射来修改数字格式，不需要重新索引数据（因为格式只是显示层面的配置，不影响存储）：

var putMappingResponse = client.Indices.PutMapping<Product>(m => m
    .Properties(p => p
        .Number(n => n
            .Name(f => f.Price)
            .Format("#,###.00") // 修改为千分位+两位小数
        )
    )
);

这样配置后，Kibana在加载对应的索引模式时，就会自动应用你设置的格式，省去了手动配置的麻烦。

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