Position Increment Gap 参数 #

position_increment_gap 参数控制数组中相邻文本值之间的位置间隔。该参数影响短语查询（match_phrase）在跨数组元素时的匹配行为。

默认值 #

默认值为 100。

当一个 text 字段接受数组值时，各元素的文本会被拼接分析。例如：

PUT my-index/_doc/1
{
  "tags": ["quick brown", "fox jumps"]
}

分析后的词条位置：

默认间隔 100 使得 match_phrase 查询 "brown fox" 不会匹配该文档，因为 brown（位置 1）和 fox（位置 102）之间有 100 个位置的间隔，远大于短语查询允许的 slop。

PUT my-index
{
  "mappings": {
    "properties": {
      "tags": {
        "type": "text",
        "position_increment_gap": 0
      }
    }
  }
}

设为 0 后，"brown fox" 的短语查询将跨元素匹配。

PUT my-index
{
  "mappings": {
    "properties": {
      "names": {
        "type": "text",
        "position_increment_gap": 50
      }
    }
  }
}