创建Elasticsearch索引时如何配置自定义settings与mapping
自定义索引配置注入实现方案
核心结论
完全支持在创建索引的流程中直接传入自定义settings与mapping配置,无需先创建空索引再后续更新配置。这种方式可以从索引初始化阶段就应用自定义规则,避免默认动态映射覆盖自定义字段配置的问题。
现有代码存在的问题
- 调用
indices.create方法时仅传入了索引名称,没有将自定义配置放入请求体,因此会触发ES的默认配置生成规则 - 提供的自定义mapping与实际写入逻辑不匹配:mapping中定义的类型名为
test,但实际数据写入时指定的类型为cities_list,即使配置传入也无法触发生效 - 存在异步时序漏洞:代码没有等待索引创建完成的回调,就直接发起单条写入、批量导入请求,很容易出现请求命中未初始化完成的索引而报错
- 配置存在版本兼容性问题:ES 5.x之后已经移除了
string字段类型,拆分出了text和keyword类型;ES 7.x之后移除了索引层面的类型概念,不再支持自定义多层类型映射
正确的实现步骤
- 按照实际使用的ES版本调整自定义配置的结构
- 适配ES 7.x/8.x版本:去掉mapping下的多余类型层,将原配置中的
string类型替换为text,统一数据写入的类型为默认的_doc - 适配ES 6.x及更早版本:将mapping中的类型名
test替换为实际写入用的cities_list,保持类型名完全一致
- 适配ES 7.x/8.x版本:去掉mapping下的多余类型层,将原配置中的
- 将调整后的自定义配置作为
body参数传入indices.create方法,让ES在创建索引时直接加载对应规则 - 将所有数据写入、批量导入逻辑移动到索引创建成功的回调函数中执行,避免异步时序导致的请求错误
修正后的参考代码
const elasticsearchLoading = require("elasticsearch"); const indexNameLoading = "cities"; const dataJsonFile = "./cities.json"; // 定义自定义索引配置 const indexCustomConfig = { settings: { analysis: { filter: { my_ascii_folding: { type: "asciifolding", preserve_original: true } }, analyzer: { turkish_analyzer: { tokenizer: "standard", filter: [ "lowercase", "my_ascii_folding" ] } } } }, mappings: { // 7.x及以上版本直接写properties;6.x及更早版本需在 mappings 下包裹一层 cities_list 类型 properties: { name: { type: "text", // 替换原配置中的string类型,适配新版本ES规则 analyzer: "turkish_analyzer" } } } } const loadIndexclient = new elasticsearchLoading.Client({ hosts: ["http://localhost:9200"], }); // 创建索引,传入自定义配置 loadIndexclient.indices.create({ index: indexNameLoading, body: indexCustomConfig // 核心改动:将自定义配置传入请求体 }, function (error, response, status) { if (error) { console.log("索引创建失败", error); return; } console.log("created a new index", response); // 单条写入逻辑放入创建成功的回调中执行 loadIndexclient.index({ index: indexNameLoading, type: "_doc", // 7.x及以上使用_doc,旧版本替换为cities_list与mapping配置保持一致 body: { name: "Content for key one" }, }, function (error, response, status) { if (error) console.log("单条写入失败", error); }); // 加载城市数据并执行批量导入 const cities = require(dataJsonFile); let bulk = []; cities.forEach((city) => { bulk.push({ index: { _index: indexNameLoading, _type: "_doc", // 与mapping的类型配置保持一致 }, }); bulk.push(city); }); loadIndexclient.bulk({ body: bulk }, function (err, response) { if (err) { console.log("Failed Bulk operation", err); } else { console.log("Successfully imported ", cities.length); } }); });
关键注意事项
- 索引的分析器、分词器配置在索引创建完成后无法直接修改,必须在创建阶段一次性传入,后续调整需要执行全量索引重建
- 所有数据写入操作指定的类型名,必须和mapping中配置的类型完全匹配,否则自定义的字段映射不会生效,会自动套用ES的动态默认映射规则
- 索引创建是异步操作,提前发起的写入请求很容易触发“索引不存在”的报错,所有写入操作必须等待创建成功的回调触发后再执行
内容的提问来源于stack exchange,提问作者Angels
相关产品推荐
相关产品推荐

