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

# ルールベースの一致ワークフローの一致 ID の変更または生成
<a name="generate-match-id"></a>

*一致 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 マネジメントコンソール し、[https://console.aws.amazon.com/entityresolution/](https://console.aws.amazon.com/entityresolution/) で AWS Entity Resolution コンソールを開きます。

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

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

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

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

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

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

1. **処理タイプ**を選択します。
   + **一貫性** – 既存の一致 ID を検索するか、新しい一致 ID をすぐに生成して保存できます。このオプションは、最も精度が高く、応答時間が遅くなります。
   + **背景** ( API `EVENTUAL`で と表示) – 既存の一致 ID を検索したり、新しい一致 ID をすぐに生成したりできます。更新されたレコードはバックグラウンドで保存されます。このオプションの初期応答は高速で、後で S3 で完全な結果を利用できます。
   + **クイック ID 生成** ( API `EVENTUAL_NO_LOOKUP`で と表示) – 既存の一致 ID を検索せずに新しい一致 ID を作成できます。更新されたレコードはバックグラウンドで保存されます。このオプションは最速の応答です。一意のレコードにのみ推奨されます。

1. **レコード属性**の場合、

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

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

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

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

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

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

------
#### [ API ]

**API を使用して一致 ID を変更または生成するには**
**注記**  
この API を正常に呼び出すには、まず [StartMatchingJob API](https://docs.aws.amazon.com/entityresolution/latest/apireference/API_StartMatchingJob.html) を使用してルールベースのマッチングワークフローを正常に実行する必要があります。  
サポートされているプログラミング言語の完全なリストについては、[GenerateMatchID](https://docs.aws.amazon.com/entityresolution/latest/apireference/API_GenerateMatchId.html) の[https://docs.aws.amazon.com/entityresolution/latest/apireference/API_GenerateMatchId.html#API_GenerateMatchId_SeeAlso](https://docs.aws.amazon.com/entityresolution/latest/apireference/API_GenerateMatchId.html#API_GenerateMatchId_SeeAlso)「」セクションを参照してください。

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

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

   ```
   /matchingworkflows/workflowName/generateMatches
   ```

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

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

   は以下`workflowName`を行う必要があります。
   + 1～255 文字の長さ 
   + パターンに一致 [a-zA-Z\_0-9-]\*

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

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

   説明は以下のとおりです。
   + `processingType` (オプション) - デフォルトは です`CONSISTENT`。次のいずれかの値を選択します。
     + `CONSISTENT` - 応答時間が遅く、最高の精度を実現 
     + `EVENTUAL` - バックグラウンド処理による初期レスポンスの高速化 
     + `EVENTUAL_NO_LOOKUP` - レコードが一意であることがわかっている場合の最速レスポンス 
   + `records` (必須) - 1 つのレコードオブジェクトのみを含む配列

1.  リクエストを送信します。

   成功すると、ステータスコード 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 

------