규칙 기반 일치 워크플로에 대한 일치 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. 다음 중 하나를 수행합니다.

    상황 THEN ...
    이 워크플로와 연결된 스키마 매핑은 하나뿐입니다. 기본적으로 선택된 스키마 매핑을 봅니다.
    이 워크플로와 연결된 스키마 매핑이 두 개 이상 있습니다. 드롭다운 목록에서 스키마 매핑을 선택합니다.
  7. 레코드 속성에 기존 일치 키값을 입력하여 각 기존 레코드를 조회합니다.

    작은 정보

    일치 ID를 찾는 데 도움이 되도록 가능한 한 많은 값을 입력합니다.

  8. 데이터 정규화 옵션은 일치 전에 데이터 입력이 정규화되도록 기본적으로 선택됩니다. 데이터를 정규화하지 않으려면 데이터 정규화 옵션을 선택 취소합니다.

  9. 일치하는 규칙을 보려면 일치하는 규칙 보기가 확장됩니다.

  10. Look up(조회)을 선택합니다.

    일치 ID를 찾았다는 성공 메시지가 나타납니다.

  11. 해당 일치 ID와 발견된 관련 규칙을 확인합니다.

API
API를 사용하여 일치 ID를 조회하려면
참고

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

지원되는 프로그래밍 언어의 전체 목록은 GetMatchID API의 섹션도 참조하세요.

  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