为基于规则的匹配工作流程查找匹配 ID - AWS Entity Resolution 数据匹配服务

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

为基于规则的匹配工作流程查找匹配 ID

完成基于规则的匹配工作流程后,您可以检索每条已处理记录的匹配 ID 和关联规则。此信息可帮助您了解记录是如何匹配的,以及应用了哪些规则。以下过程演示如何使用 AWS Entity Resolution 数据匹配服务 控制台或 GetMatchID API 访问这些数据。

Console
使用控制台查找比赛 ID
  1. 登录 AWS Management Console 并打开 AWS Entity Resolution 数据匹配服务 控制台,网址为https://console.aws.amazon.com/entityresolution/

  2. 在左侧导航窗格的 “工作流程” 下,选择 “匹配”。

  3. 选择已处理的基于规则的匹配工作流(Job 状态为 “完成”)。

  4. 在匹配的工作流程详细信息页面上,选择匹配 IDs选项卡。

  5. 选择 “查找匹配 ID”。

  6. 请执行以下操作之一:

    如果... 操作...
    只有一个架构映射与此工作流程相关联。 查看默认情况下选择的架构映射
    有多个架构映射与此工作流程相关联。 从下拉列表中选择架构映射
  7. “记录属性” 中,输入现有匹配键,以查找每条现有记录。

    提示

    输入尽可能多的值以帮助找到匹配 ID。

  8. 默认情况下,“标准化数据” 选项处于选中状态,以便在匹配之前对数据输入进行标准化。如果您不想对数据进行标准化处理,请取消选择 “标准化数据” 选项。

  9. 如果要查看匹配规则,请展开查看匹配规则

  10. 选择查找

    将显示一条成功消息,说明已找到匹配ID。

  11. 查看相应的匹配 ID 和找到的关联规则。

API
使用 API 查找匹配 ID
注意
  1. 打开终端或命令提示符发出 API 请求。

  2. 向以下端点创建 POST 请求:

    /matchingworkflows/workflowName/matches
  3. 在请求标头中,将内容类型设置为 application/json。

  4. 在请求 URI 中,指定您的workflowName

    workflowName须:

    • 长度介于 1 到 255 个字符之间

    • 匹配模式 [a-za-z_0-9-] *

  5. 对于请求正文,请提供以下 JSON:

    { "applyNormalization": boolean, "record": { "string" : "string" } }

    其中:

    applyNormalization(可选)-设置为true以标准化架构中定义的属性

    record(必填)-要获取匹配 ID 的记录

  6. 发送 请求。

    如果成功,您将收到状态码 200 的响应和包含以下内容的 JSON 正文:

    { "matchId": "string", "matchRule": "string" }

    matchId是这组匹配记录的唯一标识符,它matchRule表示该记录与哪条规则匹配。

    如果呼叫失败,您可能会收到以下错误之一:

    • 403- AccessDeniedException 如果你没有足够的访问权限

    • 404- ResourceNotFoundException 如果找不到资源

    • 429- ThrottlingException 如果请求被限制

    • 400- ValidationException 如果输入未通过验证

    • 500- InternalServerException 如果内部服务出现故障