ルールベースの一致ワークフローの一致 ID を検索する - AWS Entity Resolution

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

ルールベースの一致ワークフローの一致 ID を検索する

ルールベースのマッチングワークフローが完了したら、処理された各レコードの一致 ID と関連するルールを取得できます。この情報は、レコードがどのように照合され、どのルールが適用されたかを理解するのに役立ちます。次の手順は、 AWS Entity Resolution コンソールまたは GetMatchID API を使用してこのデータにアクセスする方法を示しています。

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

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

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

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

  5. 一致 ID の検索 を選択します。

  6. 次のいずれかを行います:

    状況 結果
    このワークフローに関連付けられているスキーママッピングは 1 つだけです。 デフォルトでは選択されているスキーママッピングを表示します。
    このワークフローには複数のスキーママッピングが関連付けられています。 ドロップダウンリストからスキーママッピングを選択します。
  7. レコード属性には、既存の各レコードを検索する既存の一致キーの値を入力します。

    ヒント

    一致 ID を見つけるために、できるだけ多くの値を入力します。

  8. データ正規化オプションはデフォルトで選択され、一致する前にデータ入力が正規化されます。データを正規化しない場合は、データの正規化オプションの選択を解除します。

  9. 一致するルールを表示する場合は、一致するルールの表示を展開します。

  10. [検索] を選択します。

    一致 ID が見つかったことを示す成功メッセージが表示されます。

  11. 対応する一致 ID と、見つかった関連するルールを表示します。

API
API を使用して一致 ID を検索するには
注記

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

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

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

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

    /matchingworkflows/workflowName/matches
  3. リクエストヘッダーで、Content-type を 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