규칙 기반 일치 워크플로에 대한 일치 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 테이블이 하나만 있는 경우 기본적으로 선택됩니다.

  7. 처리 유형을 선택합니다.

    • 일관성 - 기존 일치 ID를 조회하거나 새 일치 ID를 즉시 생성하고 저장할 수 있습니다. 이 옵션은 정확도가 가장 높고 응답 시간이 느립니다.

    • 배경(APIEVENTUAL에 로 표시됨) - 기존 일치 ID를 조회하거나 즉시 새 일치 ID를 생성할 수 있습니다. 업데이트된 레코드는 백그라운드에 저장됩니다. 이 옵션에는 빠른 초기 응답이 있으며 나중에 S3에서 전체 결과를 사용할 수 있습니다.

    • 빠른 ID 생성(APIEVENTUAL_NO_LOOKUP에 로 표시됨) - 기존 ID를 조회하지 않고도 새 일치 ID를 생성할 수 있습니다. 업데이트된 레코드는 백그라운드에 저장됩니다. 이 옵션은 응답이 가장 빠릅니다. 고유한 레코드에만 권장됩니다.

  8. 레코드 속성의 경우

    1. 고유 ID값을 입력합니다.

    2. 워크플로에 구성된 규칙에 따라 기존 레코드와 일치하는 각 일치 키값을 입력합니다.

  9. 일치 ID 찾기 및 레코드 저장을 선택합니다.

    매치 ID가 발견되었거나 새 매치 ID가 생성되어 레코드가 저장되었다는 성공 메시지가 나타납니다.

  10. 성공 메시지에서 일치하는 워크플로에 저장된 해당 일치 ID 및 관련 규칙을 확인합니다.

  11. (선택 사항) 일치 ID를 복사하려면 복사를 선택합니다.

API
API를 사용하여 일치 ID를 수정하거나 생성하려면
참고

이 API를 성공적으로 호출하려면 먼저 StartMatchingJob API를 사용하여 규칙 기반 매칭 워크플로를 성공적으로 실행해야 합니다.

지원되는 프로그래밍 언어의 전체 목록은 GenerateMatchID추가 섹션을 참조하세요.

  1. 터미널 또는 명령 프롬프트를 열어 API를 요청합니다.

  2. 다음 엔드포인트에 대한 POST 요청을 생성합니다.

    /matchingworkflows/workflowName/generateMatches
  3. 요청 헤더에서 콘텐츠 유형을 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 (필수) - 정확히 하나의 레코드 객체를 포함하는 배열

  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