示例:基于精确值丰富你的数据
match 富化策略基于精确值(例如电子邮件地址或 ID)、使用 term 查询将富化数据匹配到传入文档。
以下示例创建一个 match 富化策略,根据电子邮件地址为传入文档添加用户姓名和联系信息。然后将该 match 富化策略添加到摄取管道的一个处理器中。
步骤 1:创建源索引
以下索引 API 请求创建一个源索引并向该索引索引一个新文档。
PUT /users/_doc/1?refresh=wait_for
{
"email": "mardy.brown@asciidocsmith.com",
"first_name": "Mardy",
"last_name": "Brown",
"city": "New Orleans",
"county": "Orleans",
"state": "LA",
"zip": 70116,
"web": "mardy.asciidocsmith.com"
}
步骤 2:创建富化策略
使用创建富化策略 API 创建一个 match 类型的富化策略。此策略必须包含:
- 一个或多个源索引
match_field,源索引中用于匹配传入文档的字段- 你希望追加到传入文档的源索引中的富化字段
PUT /_enrich/policy/users-policy
{
"match": {
"indices": "users",
"match_field": "email",
"enrich_fields": ["first_name", "last_name", "city", "zip", "state"]
}
}
步骤 3:执行富化策略
使用执行富化策略 API 为该策略创建一个富化索引。
POST /_enrich/policy/users-policy/_execute?wait_for_completion=false
步骤 4:创建包含富化处理器的摄取管道
使用创建或更新管道 API 创建一个摄取管道。在管道中,添加一个富化处理器,其中包含:
- 你的富化策略
- 传入文档中用于匹配富化索引文档的
field字段 - 用于存储传入文档追加的富化数据的
target_field目标字段。该字段包含富化策略中指定的match_field和enrich_fields
PUT /_ingest/pipeline/user_lookup
{
"processors" : [
{
"enrich" : {
"description": "Add 'user' data based on 'email'",
"policy_name": "users-policy",
"field" : "email",
"target_field": "user",
"max_matches": "1"
}
}
]
}
步骤 5:使用摄取管道索引文档
使用摄取管道索引一个文档。传入文档应包含富化处理器中指定的 field 字段。
PUT /my-index-000001/_doc/my_id?pipeline=user_lookup
{
"email": "mardy.brown@asciidocsmith.com"
}
步骤 6:验证结果
要验证富化处理器是否匹配并追加了相应的字段数据,使用获取文档 API 查看已索引的文档。
GET /my-index-000001/_doc/my_id
API 返回以下响应:
{
"found": true,
"_index": "my-index-000001",
"_id": "my_id",
"_version": 1,
"_seq_no": 55,
"_primary_term": 1,
"_source": {
"user": {
"email": "mardy.brown@asciidocsmith.com",
"first_name": "Mardy",
"last_name": "Brown",
"zip": 70116,
"city": "New Orleans",
"state": "LA"
},
"email": "mardy.brown@asciidocsmith.com"
}
}