단순 규칙 유형을 사용하여 규칙 기반 일치 워크플로 생성

다음 절차에서는 AWS Entity Resolution 콘솔 또는 CreateMatchingWorkflow API를 사용하여 단순 규칙 유형으로 규칙 기반 일치 워크플로를 생성하는 방법을 보여줍니다.

Console

콘솔을 사용하여 단순 규칙 유형으로 규칙 기반 일치 워크플로를 생성하려면

1. 에 로그인 AWS Management Console 하고 https://console.aws.amazon.com/entityresolution/ AWS Entity Resolution 콘솔을 엽니다.

2. 왼쪽 탐색 창의 워크플로에서 일치를 선택합니다.

3. 매칭 워크플로 페이지의 오른쪽 상단 모서리에서 매칭 워크플로 생성을 선택합니다.

4. 1단계: 일치하는 워크플로 세부 정보 지정에서 다음을 수행합니다.

   1. 일치하는 워크플로 이름과 선택적 설명을 입력합니다.

   2. 데이터 입력의 경우 드롭다운에서 AWS Glue 데이터베이스를 선택하고 AWS Glue 테이블을 선택한 다음 해당 스키마 매핑을 선택합니다.

      최대 19개의 데이터 입력을 추가할 수 있습니다.

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

      참고

      정규화는 스키마 매핑 생성의 다음 시나리오에서만 지원됩니다.

      • 이름 하위 유형이 그룹화된 경우: 이름, 중간 이름, 성.

      • 주소 하위 유형이 그룹화된 경우: 거리 주소 1, 거리 주소 2, 거리 주소 3, 도시, 주, 국가, 우편 번호.

      • 전화 번호, 전화 국가 코드 등의 전화 하위 유형이 그룹화된 경우.

   4. 서비스 액세스 권한을 지정하려면 옵션을 선택하고 권장 조치를 취합니다.

      옵션	권장 조치
      새 서비스 역할 생성 및 사용	AWS Entity Resolution 는이 테이블에 필요한 정책을 사용하여 서비스 역할을 생성합니다. 기본 서비스 역할 이름은 entityresolution-matching-workflow-<timestamp>입니다. 역할을 생성하고 정책을 연결할 수 있는 권한이 있어야 합니다. 입력 데이터가 암호화된 경우 이 데이터는 KMS 키로 암호화됨 옵션을 선택한 다음 데이터 입력을 복호화하는 데 사용할 AWS KMS 키를 입력할 수 있습니다.
      기존 서비스 역할 사용	드롭다운 목록에서 기존 서비스 역할 이름을 선택합니다. 역할을 나열할 권한이 있는 경우 역할 목록이 표시됩니다. 역할을 나열할 수 있는 권한이 없는 경우 사용하려는 역할의 Amazon 리소스 이름(ARN)을 입력할 수 있습니다. 기존 서비스 역할이 없는 경우 기존 서비스 역할 사용 옵션을 사용할 수 없습니다. IAM에서 보기 외부 링크를 선택하여 서비스 역할을 확인합니다. 기본적으로 AWS Entity Resolution 는 필요한 권한을 추가하기 위해 기존 역할 정책을 업데이트하려고 시도하지 않습니다.

   5. (선택 사항) 리소스에 대해 태그를 활성화하려면 새 태그 추가를 선택한 다음 키 및 값 페어를 입력합니다.

   6. 다음을 선택합니다.

5. 2단계: 매칭 기법 선택:

   1. 일치 방법에서 규칙 기반 일치를 선택합니다.

   2. 규칙 유형에서 단순을 선택합니다.

      

   3. 케이던스 처리에서 다음 옵션 중 하나를 선택합니다.

      • 수동을 선택하여 대량 업데이트에 대해 온디맨드로 워크플로 실행

      • 새 데이터가 S3 버킷에 저장되는 즉시 워크플로를 실행하려면 자동을 선택합니다.

      참고

      자동을 선택한 경우 S3 버킷에 대해 Amazon EventBridge 알림이 켜져 있는지 확인합니다. S3 콘솔을 사용하여 Amazon EventBridge를 활성화하는 방법에 대한 지침은 Amazon Amazon S3 사용 설명서의 Amazon EventBridge 활성화를 참조하세요.

   4. (선택 사항) ID 매핑 전용 인덱스의 경우 데이터를 인덱싱하고 ID를 생성하지 않는 기능을 켜도록 선택할 수 있습니다. IDs

      기본적으로 일치하는 워크플로는 데이터가 IDs를 생성합니다.

   5. 일치 규칙에 규칙 이름을 입력한 다음 해당 규칙의 일치 키를 선택합니다.

      최대 15개의 규칙을 생성하고 규칙 전체에 최대 15개의 서로 다른 일치 키를 적용하여 일치 기준을 정의할 수 있습니다.

      

   6. 비교 유형에서 목표에 따라 다음 옵션 중 하나를 선택합니다.

      목표	권장 옵션
      여러 입력 필드에 저장된 데이터에서 일치하는 항목 조합을 찾습니다.	여러 입력 필드
      단일 입력 필드와의 제한 비교	단일 입력 필드

      

   7. 다음을 선택합니다.

6. 3단계: 데이터 출력 및 형식 지정:

   1. 데이터 출력 대상 및 형식에서 데이터 출력의 Amazon S3 위치와 데이터 형식이 정규화된 데이터인지 원래 데이터인지 선택합니다.

   2. 암호화에 암호화 설정 사용자 지정을 선택한 경우 AWS KMS 키 ARN을 입력합니다.

   3. 시스템 생성 출력을 봅니다.

   4. 데이터 출력에서 포함하거나 숨기거나 마스킹할 필드를 결정한 다음 목표에 따라 권장 조치를 취합니다.

      목표	권장 조치
      필드 포함	출력 상태를 포함으로 유지합니다.
      필드 숨기기(출력에서 제외)	출력 필드를 선택한 다음 숨기기를 선택합니다.
      마스크 필드	출력 필드를 선택한 다음 해시 출력을 선택합니다.
      이전 설정 재설정	재설정을 선택합니다.

   5. 다음을 선택합니다.

7. 4단계: 검토 및 생성의 경우:

   1. 이전 단계에서 선택한 내용을 검토하고 필요한 경우 편집하세요.

   2. [Create and run]을 선택합니다.

      일치하는 워크플로가 생성되었고 작업이 시작되었음을 나타내는 메시지가 나타납니다.

8. 일치하는 워크플로 세부 정보 페이지의 지표 탭에서 마지막 작업 지표에서 다음을 확인합니다.

   • 작업 ID입니다.

   • 일치하는 워크플로 작업의 상태: 대기 중, 진행 중, 완료됨, 실패

   • 워크플로 작업에 대해 완료된 시간입니다.

   • 처리된 레코드 수입니다.

   • 처리되지 않은 레코드 수입니다.

   • 생성된 고유 일치 IDs.

   • 입력 레코드 수입니다.

   작업 기록에서 이전에 실행된 일치하는 워크플로 작업에 대한 작업 지표를 볼 수도 있습니다.

9. 일치하는 워크플로 작업이 완료되면(상태가 완료됨) 데이터 출력 탭으로 이동한 다음 Amazon S3 위치를 선택하여 결과를 볼 수 있습니다.

10. (수동 처리 유형만 해당) 수동 처리 유형으로 규칙 기반 매칭 워크플로를 생성한 경우 매칭 워크플로 세부 정보 페이지에서 워크플로 실행을 선택하여 언제든지 매칭 워크플로를 실행할 수 있습니다.

API

API를 사용하여 단순 규칙 유형으로 규칙 기반 일치 워크플로를 생성하려면

참고

기본적으로 워크플로는 표준(배치) 처리를 사용합니다. 증분(자동 처리를 사용하려면 명시적으로 구성해야 합니다.

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

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

   /matchingworkflows

3. 요청 헤더에서 Content-type을 application/json으로 설정합니다.

   참고

   지원되는 프로그래밍 언어의 전체 목록은 AWS Entity Resolution API 참조를 참조하세요.

4. 요청 본문에 대해 다음과 같은 필수 JSON 파라미터를 제공합니다.

   {
      "description": "string",
      "incrementalRunConfig": { 
         "incrementalRunType": "string"
      },
      "inputSourceConfig": [ 
         { 
            "applyNormalization": boolean,
            "inputSourceARN": "string",
            "schemaName": "string"
         }
      ],
      "outputSourceConfig": [ 
         { 
            "applyNormalization": boolean,
            "KMSArn": "string",
            "output": [ 
               { 
                  "hashed": boolean,
                  "name": "string"
               }
            ],
            "outputS3Path": "string"
         }
      ],
      "resolutionTechniques": { 
         "providerProperties": { 
            "intermediateSourceConfiguration": { 
               "intermediateS3Path": "string"
            },
            "providerConfiguration": JSON value,
            "providerServiceArn": "string"
         },
         "resolutionType": "RULE_MATCHING",
         "ruleBasedProperties": { 
            "attributeMatchingModel": "string",
            "matchPurpose": "string",
            "rules": [ 
               { 
                  "matchingKeys": [ "string" ],
                  "ruleName": "string"
               }
            ]
         },
         "ruleConditionProperties": { 
            "rules": [ 
               { 
                  "condition": "string",
                  "ruleName": "string"
               }
            ]
         }
      },
      "roleArn": "string",
      "tags": { 
         "string" : "string" 
      },
      "workflowName": "string"
   }

   위치:

   • workflowName (필수) - 고유해야 하며 [a-zA-Z_0-9-]*와 일치하는 패턴 1~255자여야 합니다.

   • inputSourceConfig (필수) - 1~20개의 입력 소스 구성 목록

   • outputSourceConfig (필수) - 정확히 하나의 출력 소스 구성

   • resolutionTechniques (필수) - 규칙 기반 일치의 경우 "RULE_MATCHING"으로 설정

   • roleArn (필수) - 워크플로 실행을 위한 IAM 역할 ARN

   • ruleConditionProperties (필수) - 규칙 조건 및 일치하는 규칙의 이름 목록입니다.

   선택적 파라미터는 다음과 같습니다.

   • description - 최대 255자

   • incrementalRunConfig - 증분 실행 유형 구성

   • tags - 최대 200개의 키-값 페어

5. (선택 사항) 기본 표준(배치) 처리 대신 증분 처리를 사용하려면 요청 본문에 다음 파라미터를 추가합니다.

   "incrementalRunConfig": {
      "incrementalRunType": "AUTOMATIC"
   }
   

6. 요청을 보냅니다.

7. 성공하면 상태 코드 200과 다음을 포함하는 JSON 본문이 포함된 응답을 받게 됩니다.

   {
      "workflowArn": "string",
      "workflowName": "string",
      // Plus all configured workflow details
   }
   

8. 호출에 실패하면 다음 오류 중 하나가 표시될 수 있습니다.

   • 400 - 워크플로 이름이 이미 있는 경우 ConflictException

   • 400 - 입력이 검증에 실패한 경우 ValidationException

   • 402 - 계정 제한을 초과하는 경우 ExceedsLimitException

   • 403 - 충분한 액세스 권한이 없는 경우 AccessDeniedException

   • 429 - 요청이 제한된 경우 ThrottlingException

   • 500 - 내부 서비스 장애가 있는 경우 InternalServerException