기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 규칙 기반 일치 워크플로에 대한 일치 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 Management Console 하고 [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. **처리 유형을** 선택합니다.
   + **일관성** - 기존 일치 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)하세요.

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.  요청을 보냅니다.

   성공하면 상태 코드 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 

------