ルールベースの一致ワークフローの一致 ID の変更または生成 - AWS Entity Resolution

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

ルールベースの一致ワークフローの一致 ID の変更または生成

一致 ID は、一致するワークフローの実行後に によって生成 AWS Entity Resolution され、一致する各レコードセットに適用される識別子です。これは、出力に含まれる一致するワークフローメタデータの一部です。

既存の顧客のレコードを更新したり、データセットに新しい顧客を追加したりする必要がある場合は、 AWS Entity Resolution コンソールまたは GenerateMatchID API を使用できます。既存の一致 ID を変更すると、顧客情報を更新する際の一貫性を維持できますが、以前に識別されていない顧客をシステムに追加する場合は新しい一致 ID を生成する必要があります。

注記

コンソールを使用するか API を使用するかにかかわらず、追加料金が適用されます。選択した処理タイプは、オペレーションの精度と応答時間の両方に影響します。

重要

ジョブの進行中に S3 バケットへのアクセス AWS Entity Resolution 許可を取り消すと、 AWS Entity Resolution は引き続き結果を S3 に出力するための処理と課金を行いますが、結果をバケットに配信することはできません。この問題を回避するには、ジョブを開始する前に、 に S3 バケットに書き込むための正しいアクセス許可 AWS Entity Resolution があることを確認してください。処理中にアクセス許可が取り消された場合、 AWS Entity Resolution 正しいバケットアクセス許可を復元すると、 はジョブ完了後最大 30 日間、結果の再配信を試みます。

次の手順では、一致 ID を検索または生成し、処理タイプを選択し、結果を表示するプロセスについて説明します。

Console
コンソールを使用して一致 ID を変更または生成するには
  1. にサインイン AWS Management Console し、https://console.aws.amazon.com/entityresolution/ で AWS Entity Resolution コンソールを開きます。

  2. 左側のナビゲーションペインのワークフローで、一致を選択します。

  3. 処理されたルールベースのマッチングワークフローを選択します (ジョブのステータス完了です)。

  4. 一致するワークフローの詳細ページで、一致 IDsタブを選択します。

  5. 一致 ID の変更または生成を選択します。

    注記

    一致 ID の変更または生成オプションは、自動処理頻度を使用するマッチングワークフローでのみ使用できます。手動処理頻度を選択した場合、このオプションは非アクティブになります。このオプションを使用するには、ワークフローを編集して自動処理の頻度を使用します。ワークフローの編集の詳細については、「」を参照してください一致するワークフローの編集

  6. ドロップダウンリストからAWS Glue テーブルを選択します。

    ワークフローに AWS Glue テーブルが 1 つしかない場合は、デフォルトで選択されます。

  7. 処理タイプを選択します。

    • 一貫性 – 既存の一致 ID を検索するか、新しい一致 ID をすぐに生成して保存できます。このオプションは、最も精度が高く、応答時間が遅くなります。

    • 背景 ( API EVENTUALで と表示) – 既存の一致 ID を検索したり、新しい一致 ID をすぐに生成したりできます。更新されたレコードはバックグラウンドで保存されます。このオプションは高速の初期応答で、後で S3 で完全な結果を利用できます。

    • クイック ID 生成 ( API EVENTUAL_NO_LOOKUPで と表示) – 既存の一致 ID を検索せずに新しい一致 ID を作成できます。更新されたレコードはバックグラウンドで保存されます。このオプションは最速の応答です。一意のレコードにのみ推奨されます。

  8. レコード属性の場合、

    1. 一意の ID の値を入力します。

    2. ワークフローで設定されたルールに基づいて、既存のレコードと一致する各一致キーの値を入力します。

  9. 一致 ID を検索 を選択し、レコードを保存します

    一致 ID が見つかったか、新しい一致 ID が生成され、レコードが保存されたことを示す成功メッセージが表示されます。

  10. 対応する一致 ID と、一致するワークフローに保存された関連するルールを成功メッセージで表示します。

  11. (オプション) 一致 ID をコピーするには、コピーを選択します。

API
API を使用して一致 ID を変更または生成するには
注記

この API を正常に呼び出すには、まず StartMatchingJob API を使用してルールベースのマッチングワークフローを正常に実行する必要があります。

サポートされているプログラミング言語の完全なリストについては、GenerateMatchIDhttps://docs.aws.amazon.com/entityresolution/latest/apireference/API_GenerateMatchId.html#API_GenerateMatchId_SeeAlso「」セクションを参照してください。

  1. ターミナルまたはコマンドプロンプトを開いて API リクエストを行います。

  2. 次のエンドポイントへの POST リクエストを作成します。

    /matchingworkflows/workflowName/generateMatches
  3. リクエストヘッダーで、Content-type を application/json に設定します。

  4. リクエスト URI で、 を指定しますworkflowName

    は以下workflowNameを行う必要があります。

    • 1~255 文字の長さ

    • パターンに一致 [a-zA-Z_0-9-]*

  5. リクエスト本文には、次の JSON を指定します。

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

    コードの説明は以下のとおりです。

    • processingType (オプション) - デフォルトは ですCONSISTENT。次のいずれかの値を選択します。

      • CONSISTENT - 応答時間が遅く、最高の精度を実現

      • EVENTUAL - バックグラウンド処理による初期レスポンスの高速化

      • EVENTUAL_NO_LOOKUP - レコードが一意であることがわかっている場合の迅速な対応

    • records (必須) - 1 つのレコードオブジェクトのみを含む配列

  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