View a markdown version of this page

为基于规则的匹配工作流程修改或生成匹配 ID - AWS Entity Resolution 数据匹配服务

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

为基于规则的匹配工作流程修改或生成匹配 ID

匹配 ID 是运行匹配工作流程后由每个匹配记录集生成 AWS Entity Resolution 数据匹配服务 并应用于每个匹配记录集的标识符。这是输出中包含的匹配工作流程元数据的一部分。

当您需要更新现有客户的记录或向数据集添加新客户时，可以使用 AWS Entity Resolution 数据匹配服务 控制台或 GenerateMatchId API。修改现有匹配编号有助于在更新客户信息时保持一致性。当您向系统添加以前未识别的客户时，必须生成新的匹配 ID。

注意

无论您使用控制台还是 API，都需要支付额外费用。您选择的处理类型会影响操作的准确性和响应时间。

Real-time 匹配要求

要在基于高级规则的匹配工作流程上调用 GenerateMatchId API，请将设置enableRealTimeMatching为。true对于简单匹配工作流程，实时匹配始终可用，您无需设置此标志。

您无法对使用以下任何内容的工作流程启用实时匹配：

  • 模糊属性：CosineSoundex、或 Levenshtein

  • EmptyValues=Ignore

如果设置enableRealTimeMatching为true，则该工作流程不能与 StartMatchingJob API 一起使用来运行工作流程作业。

重要

如果您在任务进行时撤消了 S3 存储桶的 AWS Entity Resolution 数据匹配服务 权限，则仍 AWS Entity Resolution 数据匹配服务 将处理向 S3 输出结果并收取费用，但无法将结果交付到您的存储桶。为避免此问题，请确保在开始任务之前 AWS Entity Resolution 数据匹配服务 拥有写入您的 S3 存储桶的正确权限。如果权限在处理过程中被撤销，则恢复正确的存储桶权限后，会 AWS Entity Resolution 数据匹配服务 尝试在任务完成后最多 30 天内重新交付结果。

以下过程将指导您完成查找或生成匹配 ID、选择处理类型以及查看结果的过程。

Console
使用控制台修改或生成比赛 ID

  1. 登录 AWS 管理控制台 并打开 AWS Entity Resolution 数据匹配服务 控制台，地址为https://console.aws.amazon.com/entityresolution/。

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

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

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

  5. 选择 “修改” 或 “生成比赛 ID”。

    注意

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

  6. 从下拉列表中选择该表。AWS Glue

    如果工作流程中只有一个 AWS Glue 表，则默认情况下会将其选中。

  7. 选择处理类型。

    • 一致 — 您可以查找现有的比赛 ID，也可以立即生成并保存新的比赛 ID。此选项具有最高的精度和较慢的响应时间。

    • 背景（如 API EVENTUAL 中所示）— 您可以查找现有的比赛 ID 或立即生成新的比赛 ID。更新的记录保存在后台。此选项具有快速的初始响应，完整结果将在稍后的 S3 中提供。

    • 快速生成 ID（如 API EVENTUAL_NO_LOOKUP 中所示）— 您无需查找现有匹配编号即可创建新的比赛 ID。更新的记录保存在后台。此选项的响应速度最快。建议仅用于唯一记录。

  8. 对于记录属性，

    1. 输入唯一 ID 的值。

    2. 根据工作流程中配置的规则，为每个匹配密钥输入一个值，该值将与现有记录相匹配。

  9. 选择 “查找比赛 ID” 并保存记录。

    将显示一条成功消息，说明已找到比赛 ID 或生成了新的比赛 ID 并保存了记录。

  10. 在成功消息中查看相应的匹配 ID 和保存到匹配工作流程的关联规则。

  11. （可选）要复制比赛 ID，请选择 “复制” 。

API
使用 API 修改或生成比赛 ID
注意

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

有关支持的编程语言的完整列表，请参阅的 “另请参阅” 部分GenerateMatchId。

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

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

    /matchingworkflows/workflowName/generateMatches

  3. 在请求标头中，将设置 Content-type 为 application/json。

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

    必workflowName须：

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

    • 匹配模式 [a-z A-Z _0-9-] *

  5. 对于请求正文，提供以下 JSON：

    {
   "processingType": "string",
   "records": [ 
      { 
         "inputSourceARN": "string",
         "recordAttributeMap": { 
            "string" : "string" 
         },
         "uniqueId": "string"
      }
   ]
}

    其中：

    • processingType（可选）-默认为CONSISTENT。选择以下值之一：

      • CONSISTENT-以较慢的响应时间获得最高精度

      • EVENTUAL-通过后台处理实现更快的初始响应

      • EVENTUAL_NO_LOOKUP-当已知记录是唯一时，可获得最快的响应

    • records（必填）-仅包含一个记录对象的数组

  6. 发送 请求。

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

    {
   "failedRecords": [ 
      { 
         "errorMessage": "string",
         "inputSourceARN": "string",
         "uniqueId": "string"
      }
   ],
   "matchGroups": [ 
      { 
         "matchId": "string",
         "matchRule": "string",
         "records": [ 
            { 
               "inputSourceARN": "string",
               "recordId": "string"
            }
         ]
      }
   ]
}

    如果呼叫不成功，您可能会收到以下错误之一：

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

    • 404- ResourceNotFoundException 如果找不到资源

    • 429-请求 ThrottlingException 是否受到限制

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

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