限制词元数量词元过滤器编辑

限制输出词元的数量。 limit 过滤器通常用于根据词元数量限制文档字段值的大小。

默认情况下, limit 过滤器仅保留流中的第一个词元。例如,该过滤器可以将词元流 [ one, two, three ] 更改为 [ one ]

此过滤器使用 Lucene 的 LimitTokenCountFilter

 If you want to limit the size of field values based on
_character length_, use the <<ignore-above,`ignore_above`>> mapping parameter.

可配置参数编辑

max_token_count
(可选,整数)要保留的最大词元数。一旦达到此限制,任何剩余的词元都将从输出中排除。默认为 1
consume_all_tokens
(可选,布尔值)如果为 true,则即使已达到 max_token_countlimit 过滤器也会耗尽词元流。默认为 false

示例编辑

以下 分析 API 请求使用 limit 过滤器仅保留 quick fox jumps over lazy dog 中的前两个词元

response = client.indices.analyze(
  body: {
    tokenizer: 'standard',
    filter: [
      {
        type: 'limit',
        max_token_count: 2
      }
    ],
    text: 'quick fox jumps over lazy dog'
  }
)
puts response
GET _analyze
{
  "tokenizer": "standard",
    "filter": [
    {
      "type": "limit",
      "max_token_count": 2
    }
  ],
  "text": "quick fox jumps over lazy dog"
}

该过滤器产生以下词元

[ quick, fox ]

添加到分析器编辑

以下 创建索引 API 请求使用 limit 过滤器配置新的 自定义分析器

response = client.indices.create(
  index: 'limit_example',
  body: {
    settings: {
      analysis: {
        analyzer: {
          standard_one_token_limit: {
            tokenizer: 'standard',
            filter: [
              'limit'
            ]
          }
        }
      }
    }
  }
)
puts response
PUT limit_example
{
  "settings": {
    "analysis": {
      "analyzer": {
        "standard_one_token_limit": {
          "tokenizer": "standard",
          "filter": [ "limit" ]
        }
      }
    }
  }
}

自定义编辑

要自定义 limit 过滤器,请复制它以创建新的自定义词元过滤器的基础。您可以使用其可配置参数修改过滤器。

例如,以下请求创建了一个自定义 limit 过滤器,该过滤器仅保留流中的前五个词元

response = client.indices.create(
  index: 'custom_limit_example',
  body: {
    settings: {
      analysis: {
        analyzer: {
          whitespace_five_token_limit: {
            tokenizer: 'whitespace',
            filter: [
              'five_token_limit'
            ]
          }
        },
        filter: {
          five_token_limit: {
            type: 'limit',
            max_token_count: 5
          }
        }
      }
    }
  }
)
puts response
PUT custom_limit_example
{
  "settings": {
    "analysis": {
      "analyzer": {
        "whitespace_five_token_limit": {
          "tokenizer": "whitespace",
          "filter": [ "five_token_limit" ]
        }
      },
      "filter": {
        "five_token_limit": {
          "type": "limit",
          "max_token_count": 5
        }
      }
    }
  }
}