› › ›

Gsub 处理器

通过应用正则表达式和替换来转换字符串字段。如果该字段是字符串数组，则数组的所有成员都将被转换。如果遇到任何非字符串值，处理器将抛出异常。

表 25. Gsub 选项

名称	必需	默认值	描述
`field`	是	-	要应用替换的字段
`pattern`	是	-	要替换的模式
`replacement`	是	-	用于替换匹配模式的字符串
`target_field`	否	`field`	用于分配转换后的值的字段，默认情况下 `field` 会被就地更新
`ignore_missing`	否	`false`	如果 `true` 并且 `field` 不存在或为 `null`，则处理器将静默退出而不修改文档
`description`	否	-	处理器的描述。用于描述处理器的目的或其配置。
`if`	否	-	有条件地执行处理器。请参阅有条件地运行处理器。
`ignore_failure`	否	`false`	忽略处理器的失败。请参阅处理管道失败。
`on_failure`	否	-	处理处理器的失败。请参阅处理管道失败。
`tag`	否	-	处理器的标识符。对于调试和指标很有用。

{
  "gsub": {
    "field": "field1",
    "pattern": "\\.",
    "replacement": "-"
  }
}