View a markdown version of this page

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

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

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

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

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

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

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

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

  5. 选择 “查找比赛 ID”

    注意

    查找匹配 ID” 选项仅适用于使用自动处理节奏的匹配工作流程。如果您选择了手动处理节奏,则此选项将显示为非活动状态。要使用此选项,请编辑您的工作流程以使用自动处理节奏。有关编辑工作流程的更多信息,请参阅编辑匹配的工作流程

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

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

    提示

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

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

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

  10. 选择查找

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

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

API
使用 API 查找比赛 ID
注意

要成功调用此 API,必须先使用 StartMatchingJob API 成功运行基于规则的匹配工作流程。

有关支持的编程语言的完整列表,请参阅 GetMatch ID API 的 “另请参阅” 部分。

  1. 打开终端或命令提示符提示符发出 API 请求。

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

    /matchingworkflows/workflowName/matches
  3. 在请求标头中,将设置 Content-type 为 application/json。

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

    workflowName须:

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

    • 匹配模式 [a-z A-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 如果出现内部服务故障