Link Search Menu Expand Document Documentation Menu
文档

重命名处理器

rename 处理器用于重命名现有字段，也可用于将字段从一个对象移动到另一个对象或移动到根级别。

语法

以下是 rename 处理器的语法

{
    "rename": {
        "field": "field_name",
        "target_field" : "target_field_name"
    }
}

配置参数

下表列出了 rename 处理器的必需和可选参数。

参数 必需/可选 描述
字段 必需 包含要删除的数据的字段名称。支持模板片段。
目标字段 必需 字段的新名称。支持模板片段。
ignore_missing 可选 指定处理器是否应忽略不包含指定 field 的文档。如果设置为 true，则如果 field 不存在，处理器不会修改文档。默认值为 false。
override_target 可选 确定当文档中存在 target_field 时会发生什么。如果设置为 true，处理器将用新值覆盖现有 target_field 值。如果设置为 false，则保留现有值，处理器不会覆盖它。默认值为 false。
描述 可选 处理器的简要描述。
if 可选 运行处理器的条件。
ignore_failure 可选 指定处理器即使遇到错误是否仍继续执行。如果设置为 true，则忽略失败。默认值为 false。
on_failure 可选 处理器失败时要运行的处理器列表。
tag 可选 处理器的标识符标签。有助于调试以区分相同类型的处理器。

使用处理器

按照以下步骤在管道中使用处理器。

步骤 1：创建管道

以下查询创建一个名为 rename_field 的管道，该管道将对象中的字段移动到根级别

PUT /_ingest/pipeline/rename_field
{
  "description": "Pipeline that moves a field to the root level.",
  "processors": [
    {
      "rename": {
        "field": "message.content",
        "target_field": "content"
      }
    }
  ]
}

步骤 2（可选）：测试管道

建议您在摄入文档之前测试您的管道。

要测试管道，请运行以下查询

POST _ingest/pipeline/rename_field/_simulate
{
  "docs": [
    {
      "_index": "testindex1",
      "_id": "1",
      "_source":{
         "message": {
           "type": "nginx",
           "content": "192.168.1.10 - - [03/Nov/2023:15:20:45 +0000] \"POST /login HTTP/1.1\" 200 3456"
         }
      }
    }
  ]
}

响应

以下示例响应确认管道按预期工作

{
  "docs": [
    {
      "doc": {
        "_index": "testindex1",
        "_id": "1",
        "_source": {
          "message": {
            "type": "nginx",
          },
          "content": """192.168.1.10 - - [03/Nov/2023:15:20:45 +0000] "POST /login HTTP/1.1" 200 3456"""
        },
        "_ingest": {
          "timestamp": "2024-04-15T07:54:16.010447Z"
        }
      }
    }
  ]
}

步骤 3：摄取文档

以下查询将文档摄取到名为 testindex1 的索引中

PUT testindex1/_doc/1?pipeline=rename_field
{
  "message": {
    "type": "nginx",
    "content": "192.168.1.10 - - [03/Nov/2023:15:20:45 +0000] \"POST /login HTTP/1.1\" 200 3456"
  }
}

步骤 4（可选）：检索文档

要检索文档，请运行以下查询

GET testindex1/_doc/1

剩余 350 字符

有问题？。

想要贡献？或。