› › ›

JSON 处理器

将 JSON 字符串转换为结构化的 JSON 对象。

表 30. JSON 选项

名称	必需	默认值	描述
`field`	是	-	要解析的字段。
`target_field`	否	`field`	转换后的结构化对象将写入的字段。此字段中的任何现有内容都将被覆盖。
`add_to_root`	否	false	强制将解析的 JSON 添加到文档顶层的标志。选择此选项时，不能设置 `target_field`。
`add_to_root_conflict_strategy`	否	`replace`	设置为 `replace` 时，与解析的 JSON 中的字段冲突的根字段将被覆盖。设置为 `merge` 时，冲突的字段将被合并。仅当 `add_to_root` 设置为 `true` 时适用。
`allow_duplicate_keys`	否	false	设置为 `true` 时，如果 JSON 包含重复的键，JSON 解析器将不会失败。相反，任何重复键的最后遇到的值将获胜。
`strict_json_parsing`	否	true	设置为 `true` 时，JSON 解析器将严格解析字段值。设置为 `false` 时，JSON 解析器将更宽松，但也更有可能丢弃字段值的部分内容。例如，如果 `strict_json_parsing` 设置为 `true` 并且字段值为 `123 "foo"`，则处理器将抛出 IllegalArgumentException。但是，如果 `strict_json_parsing` 设置为 `false`，则字段值将被解析为 `123`。
`description`	否	-	处理器的描述。用于描述处理器的目的或其配置。
`if`	否	-	有条件地执行处理器。请参阅有条件地运行处理器。
`ignore_failure`	否	`false`	忽略处理器的失败。请参阅处理管道失败。
`on_failure`	否	-	处理处理器的失败。请参阅处理管道失败。
`tag`	否	-	处理器的标识符。用于调试和指标。

将解析所有 JSON 支持的类型（null、boolean、number、array、object、string）。

假设您提供 json 处理器的此配置

{
  "json" : {
    "field" : "string_source",
    "target_field" : "json_target"
  }
}

如果处理以下文档

{
  "string_source": "{\"foo\": 2000}"
}

在 json 处理器对其进行操作后，它将如下所示

{
  "string_source": "{\"foo\": 2000}",
  "json_target": {
    "foo": 2000
  }
}

如果提供以下配置，省略可选的 target_field 设置

{
  "json" : {
    "field" : "source_and_target"
  }
}

那么在 json 处理器操作此文档后

{
  "source_and_target": "{\"foo\": 2000}"
}

它将如下所示

{
  "source_and_target": {
    "foo": 2000
  }
}

这说明，除非在处理器配置中明确命名，否则 target_field 与必需的 field 配置中提供的字段相同。

« Join 处理器 KV 处理器 »