在 Elasticsearch 中解析 JSON 字段

作者:来自 Elastic Valentin Crettaz

学习如何在 Elasticsearch 中使用 ingest pipeline 来高效地索引、查询和聚合 JSON 数据。

初次接触 Elasticsearch?加入我们的 Elasticsearch 入门网络研讨会吧。你也可以立即开始免费的云端试用,或在本地运行 Elastic。

在本文中,我们将讨论如何在 Elasticsearch 中解析 JSON 字段,这是处理日志数据或其他结构化数据格式时的常见需求。我们将涵盖以下主题:

  • 将 JSON 数据导入 Elasticsearch

  • 使用 Ingest Pipeline 解析 JSON 字段

  • 查询和聚合 JSON 字段

1. 将 JSON 数据导入 Elasticsearch

在将 JSON 数据导入 Elasticsearch 时,确保数据格式和结构正确非常重要。Elasticsearch 可以自动检测并映射 JSON 字段,但建议定义显式映射,以更好地控制索引过程。

要创建带有自定义映射的索引,可以使用以下 API 调用:

bash 复制代码
`

1.  PUT /my_index
2.  {
3.   "mappings": {
4.     "properties": {
5.       "message": {
6.         "type": "keyword"
7.       },
8.       "json_field": {
9.         "properties": {
10.           "field1": {
11.             "type": "keyword"
12.           },
13.           "field2": {
14.             "type": "integer"
15.           }
16.         }
17.       }
18.     }
19.   }
20.  }

`AI写代码![](https://csdnimg.cn/release/blogv2/dist/pc/img/runCode/icon-arrowwhite.png)

在这个示例中,我们创建了一个名为 my_index 的索引,并为一个名为 json_field 的 JSON 字段定义了自定义映射。

2. 使用 Ingest Pipeline 解析 JSON 字段

如果你的 JSON 数据以字符串形式存储在某个字段中,可以使用 Elasticsearch 的 Ingest Pipeline 功能来解析该 JSON 字符串并提取相关字段。Ingest Pipeline 提供了一组内置处理器,其中包括 json 处理器,可用于解析 JSON 数据。

要创建一个包含 json 处理器的 ingest pipeline,请使用以下 API 调用:

markdown 复制代码
`

1.  PUT _ingest/pipeline/json_parser
2.  {
3.   "description": "Parse JSON field",
4.   "processors": [
5.     {
6.       "json": {
7.         "field": "message",
8.         "target_field": "json_field"
9.       }
10.     }
11.   ]
12.  }

`AI写代码![](https://csdnimg.cn/release/blogv2/dist/pc/img/runCode/icon-arrowwhite.png)

在这个示例中,我们创建了一个名为 json_parser 的 ingest pipeline,它会解析存储在 message 字段中的 JSON 字符串,并将解析后的 JSON 对象存储到一个名为 json_field 的新字段中。

要使用此 pipeline 索引文档,请使用以下 API 调用:

swift 复制代码
`

1.  POST /my_index/_doc?pipeline=json_parser
2.  {
3.   "message": "{\"field1\": \"value1\", \"field2\": 42}"
4.  }

`AI写代码

该文档将以解析后的 JSON 字段形式被索引:

swift 复制代码
`

1.  {
2.   "_index": "my_index",
3.   "_type": "_doc",
4.   "_id": "1",
5.   "_source": {
6.     "message": "{\"field1\": \"value1\", \"field2\": 42}",
7.     "json_field": {
8.       "field1": "value1",
9.       "field2": 42
10.     }
11.   }
12.  }

`AI写代码![](https://csdnimg.cn/release/blogv2/dist/pc/img/runCode/icon-arrowwhite.png)

3. 查询和聚合 JSON 字段

一旦 JSON 字段被索引,就可以使用 Elasticsearch Query DSL 对其进行查询和聚合。例如,要搜索在 field1 子字段中具有特定值的文档,可以使用以下查询:

bash 复制代码
`

1.  POST /my_index/_search
2.  {
3.   "query": {
4.         "term": {
5.           "json_field.field1": "value1"
6.         }
7.   }
8.  }

`AI写代码

额外提示:如何处理未解析的 JSON 数据?

如果你已经将未解析的 JSON 数据导入到 text/keyword 字段中,不必从头重新索引,也有办法提取其中的 JSON 数据。

你可以利用第 2 节中创建的 ingest pipeline,结合 Update by Query API 来完成这一操作。但在执行更新之前,需要像第 1 节中那样更新索引映射,为 json_field 添加映射,可以通过运行以下命令实现:

bash 复制代码
`

1.  PUT /my_index/_mapping
2.  {
3.    "properties": {
4.      "json_field": {
5.        "properties": {
6.          "field1": {
7.            "type": "keyword"
8.          },
9.          "field2": {
10.            "type": "integer"
11.          }
12.        }
13.      }
14.    }
15.  }

`AI写代码![](https://csdnimg.cn/release/blogv2/dist/pc/img/runCode/icon-arrowwhite.png)

完成后,你可以直接运行以下命令,它会遍历索引中的所有文档,从 message 字段中提取 JSON,并将解析后的 JSON 数据索引到 json_field 对象中。

ini 复制代码
`POST /my_index/_update_by_query?pipeline=json_parser`AI写代码

结论

总之,在 Elasticsearch 中解析 JSON 字段可以通过自定义映射、Ingest Pipeline 功能以及 Elasticsearch Query DSL 来实现。通过遵循这些步骤,你可以在 Elasticsearch 集群中高效地索引、查询和聚合 JSON 数据。

原文:www.elastic.co/search-labs...

相关推荐
lpfasd1235 分钟前
git-团队协作基础
chrome·git·elasticsearch
苗壮.5 小时前
「个人 Gitee 仓库」与「企业 Gitee 仓库」同步的几种常见方式
大数据·elasticsearch·gitee
Elastic 中国社区官方博客6 小时前
如何使用 Ollama 在本地设置和运行 GPT-OSS
人工智能·gpt·elasticsearch·搜索引擎·ai·语言模型
Elasticsearch9 小时前
Elastic Streams 中的数据协调:稳健架构深度解析
elasticsearch
Elasticsearch9 小时前
使用 Instrumentation Score 和 Elastic 的 OpenTelemetry 数据质量洞察
elasticsearch
青鱼入云11 小时前
ES索引配置字段解读
大数据·elasticsearch·搜索引擎
小牛马爱写博客11 小时前
ELK 企业级日志分析系统部署与实践
elk·elasticsearch·kibana·logstash
玥轩_52113 小时前
Git命令速查手册
大数据·git·elasticsearch·gitee·github·命令速查
Ribou13 小时前
Elasticsearch 9.2.0 三节点集群配置
大数据·elasticsearch·搜索引擎
Saintsafa14 小时前
centos安装ES
elasticsearch·centos