翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
ルールベースの一致ワークフローの一致 ID を検索する
ルールベースのマッチングワークフローが完了したら、処理された各レコードの一致 ID と関連するルールを取得できます。この情報は、レコードがどのように照合され、どのルールが適用されたかを理解するのに役立ちます。次の手順は、 AWS Entity Resolution コンソールまたは GetMatchID
API を使用してこのデータにアクセスする方法を示しています。
- Console
-
コンソールを使用して一致 ID を検索するには
-
にサインイン AWS Management Console し、https://console.aws.amazon.com/entityresolution/
で AWS Entity Resolution コンソールを開きます。 -
左側のナビゲーションペインのワークフローで、一致を選択します。
-
処理されたルールベースのマッチングワークフローを選択します (ジョブのステータスは完了です)。
-
一致するワークフローの詳細ページで、一致 IDsタブを選択します。
-
一致 ID の検索 を選択します。
-
次のいずれかを行います:
状況 結果 このワークフローに関連付けられているスキーママッピングは 1 つだけです。 デフォルトでは選択されているスキーママッピングを表示します。 このワークフローには複数のスキーママッピングが関連付けられています。 ドロップダウンリストからスキーママッピングを選択します。 -
レコード属性には、既存の各レコードを検索する既存の一致キーの値を入力します。
ヒント
一致 ID を見つけるために、できるだけ多くの値を入力します。
-
データ正規化オプションはデフォルトで選択され、一致する前にデータ入力が正規化されます。データを正規化しない場合は、データの正規化オプションの選択を解除します。
-
一致するルールを表示する場合は、一致するルールの表示を展開します。
-
[検索] を選択します。
一致 ID が見つかったことを示す成功メッセージが表示されます。
-
対応する一致 ID と、見つかった関連するルールを表示します。
-
- API
-
API を使用して一致 ID を検索するには
注記
この API を正常に呼び出すには、まず StartMatchingJob API を使用してルールベースのマッチングワークフローを正常に実行する必要があります。
サポートされているプログラミング言語の完全なリストについては、GetMatchID API のhttps://docs.aws.amazon.com/entityresolution/latest/apireference/API_GetMatchId.html#API_GetMatchId_SeeAlso「」セクションを参照してください。
-
ターミナルまたはコマンドプロンプトを開いて API リクエストを行います。
-
次のエンドポイントへの POST リクエストを作成します。
/matchingworkflows/workflowName/matches
-
リクエストヘッダーで、Content-type を application/json に設定します。
-
リクエスト URI で、 を指定します
workflowName
。は以下
workflowName
を行う必要があります。-
1~255 文字の長さ
-
パターンに一致 [a-zA-Z_0-9-]*
-
-
リクエスト本文には、次の JSON を指定します。
{ "applyNormalization": boolean, "record": { "string" : "string" } }
コードの説明は以下のとおりです。
applyNormalization
(オプション) - を に設定true
して、スキーマで定義された属性を正規化しますrecord
(必須) - の一致 ID を取得するレコード -
リクエストを送信します。
成功すると、ステータスコード 200 と以下を含む JSON 本文を含むレスポンスを受け取ります。
{ "matchId": "string", "matchRule": "string" }
matchId
は、一致したレコードのこのグループの一意の識別子であり、レコードが一致したルールmatchRule
を示します。呼び出しが失敗すると、次のいずれかのエラーが表示されることがあります。
-
403 - 十分なアクセスがない場合の AccessDeniedException
-
404 - リソースが見つからない場合の ResourceNotFoundException
-
429 - リクエストがスロットリングされた場合の ThrottlingException
-
400 - 入力が検証に失敗した場合の ValidationException
-
500 - 内部サービスに障害が発生した場合の InternalServerException
-
-