› › ›

分割处理器

分割处理器编辑

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

表 43. 分割选项

名称	必需	默认值	描述
`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
  }
}

« 排序处理器修剪处理器 »