如何在Elastic.Clients.Elasticsearch .NET 8中创建索引映射？

1. 正确映射嵌套/对象类型 #

针对你的模型结构，EmployeeInfo属于Object类型，而数组类型的JobRoles必须用Nested类型（否则Elasticsearch会扁平化数组元素，导致跨元素查询逻辑错误）。完整的fluent映射代码如下：

var createIndexResponse = client.Indices.Create<Company>("myindex", c => c
    .Mappings(m => m
        .Properties(p => p
            // 将CompanyName映射为Keyword类型
            .Keyword(k => k
                .Name(n => n.CompanyName)
            )
            // 映射EmployeeInfo为Object类型
            .Object<Employee>(o => o
                .Name(n => n.EmployeeInfo)
                .Properties(empProps => empProps
                    // 映射EmployeeName为Text类型（可根据需求改为Keyword）
                    .Text(t => t
                        .Name(n => n.EmployeeName)
                    )
                    // 映射JobRoles为Nested类型（数组对象必备）
                    .Nested<JobRole>(nest => nest
                        .Name(n => n.JobRoles)
                        .Properties(roleProps => roleProps
                            .Text(t => t
                                .Name(n => n.RoleName)
                            )
                        )
                    )
                )
            )
        )
    )
);

关键说明 #

• .Object<T>()用于映射单个嵌套对象（如EmployeeInfo），内部通过.Properties()定义子字段的映射规则。
• .Nested<T>()用于映射数组型嵌套对象（如JobRoles），确保数组中每个对象能被独立查询，避免扁平化导致的查询逻辑错误。

2. 排除属性不被索引 #

8.x版本中，可通过两种方式排除字段：

方式1：显式忽略指定字段 #

在对应层级的.Properties()中使用.Ignore()方法：

// 示例：排除Employee的某个属性（假设新增Age字段）
.Object<Employee>(o => o
    .Name(n => n.EmployeeInfo)
    .Properties(empProps => empProps
        .Text(t => t.Name(n => n.EmployeeName))
        .Nested<JobRole>(nest => nest.Name(n => n.JobRoles).Properties(...))
        // 显式忽略Age字段
        .Ignore(i => i.Age)
    )
)

方式2：全局映射时忽略字段 #

在.Map<T>()中直接指定要忽略的字段：

var createIndexResponse = client.Indices.Create<Company>("myindex", c => c
    .Mappings(m => m
        .Map<Company>(map => map
            // 忽略Company类的某个属性
            .Ignore(n => n.UnwantedProperty)
            .Properties(p => p
                // ... 其他映射规则
            )
        )
    )
);

内容的提问来源于stack exchange，提问作者Ole EH Dufour