Link Search Menu Expand Document Documentation Menu
文档

忽略高于

ignore_above 映射参数限制了索引字符串的最大字符数。如果字符串的长度超过了指定的阈值，该值将随文档存储，但不会被索引。这有助于防止索引因异常长的值而膨胀，并能确保查询效率。

默认情况下，如果您未指定 ignore_above，所有字符串值都将被完全索引。

示例：不使用 ignore_above

创建一个带有 keyword 字段的索引，且不指定 ignore_above 参数

PUT /test-no-ignore
{
  "mappings": {
    "properties": {
      "sentence": {
        "type": "keyword"
      }
    }
  }
}

索引一个包含长字符串值的文档

PUT /test-no-ignore/_doc/1
{
  "sentence": "text longer than 10 characters"
}

对完整字符串运行词项查询

POST /test-no-ignore/_search
{
  "query": {
    "term": {
      "sentence": "text longer than 10 characters"
    }
  }
}

文档被返回，因为 sentence 字段已被索引

{
  ...
  "hits": {
    "total": {
      "value": 1,
      "relation": "eq"
    },
    "max_score": 0.13353139,
    "hits": [
      {
        "_index": "test-no-ignore",
        "_id": "1",
        "_score": 0.13353139,
        "_source": {
          "sentence": "text longer than 10 characters"
        }
      }
    ]
  }
}

示例：使用 ignore_above

在同一字段上创建一个索引，并将 ignore_above 参数设置为 10

PUT /test-ignore
{
  "mappings": {
    "properties": {
      "sentence": {
        "type": "keyword",
        "ignore_above": 10
      }
    }
  }
}

索引包含相同长字符串值的文档

PUT /test-ignore/_doc/1
{
  "sentence": "text longer than 10 characters"
}

对完整字符串运行词项查询

POST /test-ignore/_search
{
  "query": {
    "term": {
      "sentence": "text longer than 10 characters"
    }
  }
}

未返回任何结果，因为 sentence 字段中的字符串超出了 ignore_above 阈值且未被索引

{
  "took": 3,
  "timed_out": false,
  "_shards": {
    "total": 1,
    "successful": 1,
    "skipped": 0,
    "failed": 0
  },
  "hits": {
    "total": {
      "value": 0,
      "relation": "eq"
    },
    "max_score": null,
    "hits": []
  }
}

然而，文档仍然存在，可以使用以下请求确认

GET test-ignore/_search

返回的命中包括该文档

{
  ...
  "hits": {
    "total": {
      "value": 1,
      "relation": "eq"
    },
    "max_score": 1,
    "hits": [
      {
        "_index": "test-ignore",
        "_id": "1",
        "_score": 1,
        "_source": {
          "sentence": "text longer than 10 characters"
        }
      }
    ]
  }
}
剩余 350 字符

有问题？。

想贡献？ 或 。