限制词元数量词元过滤器
编辑限制词元数量词元过滤器编辑
限制输出词元的数量。 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_count
,limit
过滤器也会耗尽词元流。默认为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 } } } } }