› › ›

拆分处理器

使用分隔符将字段拆分为数组。仅适用于字符串字段。

表 44. 拆分选项

名称	必需	默认值	描述
`field`	是	-	要拆分的字段
`separator`	是	-	匹配分隔符的正则表达式，例如 `,` 或 `\s+`
`target_field`	否	`field`	将拆分值分配到的字段，默认情况下 `field` 会被就地更新
`ignore_missing`	否	`false`	如果为 `true` 并且 `field` 不存在，则处理器将安静退出，而不修改文档
`preserve_trailing`	否	`false`	保留任何尾随的空字段（如果有）。
`description`	否	-	处理器的描述。用于描述处理器的用途或其配置。
`if`	否	-	有条件地执行处理器。请参阅有条件地运行处理器。
`ignore_failure`	否	`false`	忽略处理器的失败。请参阅处理管道失败。
`on_failure`	否	-	处理处理器的失败。请参阅处理管道失败。
`tag`	否	-	处理器的标识符。用于调试和指标。

{
  "split": {
    "field": "my_field",
    "separator": "\\s+" 
  }
}

将所有连续的空格字符视为单个分隔符

如果启用了 preserve_trailing 选项，则会保留输入中的任何尾随空字段。例如，在下面的配置中，my_field 属性中的值 A,,B,, 将被拆分为包含五个元素的数组 ["A", "", "B", "", ""]，其中包含两个尾随空字段。如果未启用 preserve_trailing 属性，则会丢弃这两个尾随空字段，从而得到包含三个元素的数组 ["A", "", "B"]。

{
  "split": {
    "field": "my_field",
    "separator": ",",
    "preserve_trailing": true
  }
}

« 排序处理器终止处理器 »