배치 예측 - Amazon Fraud Detector

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

배치 예측

Amazon Fraud Detector에서 배치 예측 작업을 사용하여 실시간 점수가 필요하지 않은 이벤트 집합에 대한 예측을 가져올 수 있습니다. 예를 들어 배치 예측 작업을 생성하여 오프라인 proof-of-concept 수행하거나 시간별, 일별 또는 주별로 이벤트 위험을 소급 평가할 수 있습니다.

Amazon Fraud Detector 콘솔을 사용하거나 AWS 명령줄 인터페이스(AWS CLI) 또는 Amazon Fraud Detector SDK 중 하나를 사용하여 CreateBatchPredictionJob API 작업을 호출하여 배치 예측 작업을 생성할 수 있습니다. SDKs

배치 예측 작동 방식

CreateBatchPredictionJob API 작업은 지정된 감지기 버전을 사용하여 Amazon S3 버킷에 있는 입력 CSV 파일에 제공된 데이터를 기반으로 예측합니다. 그러면 API가 결과 CSV 파일을 S3 버킷에 반환합니다.

배치 예측 작업은 GetEventPrediction 작업과 동일한 방식으로 모델 점수 및 예측 결과를 계산합니다. 와 마찬가지로 배치 예측 작업을 생성GetEventPrediction하려면 먼저 이벤트 유형을 생성하고, 선택적으로 모델을 훈련한 다음 배치 작업의 이벤트를 평가하는 감지기 버전을 생성합니다.

배치 예측 작업에서 평가한 이벤트 위험 점수의 요금은 GetEventPrediction API에서 생성한 점수의 요금과 동일합니다. 자세한 내용은 Amazon Fraud Detector 요금을 참조하세요.

배치 예측 작업은 한 번에 하나만 실행할 수 있습니다.

입력 및 출력 파일

입력 CSV 파일에는 선택한 감지기 버전과 연결된 이벤트 유형과 일치하는 헤더가 포함되어야 합니다. 입력 데이터 파일의 최대 크기는 1GB입니다. 이벤트 수는 이벤트 크기에 따라 다릅니다.

출력 데이터에 별도의 위치를 지정하지 않는 한 Amazon Fraud Detector는 입력 파일과 동일한 버킷에 출력 파일을 생성합니다. 출력 파일에는 입력 파일의 원본 데이터와 다음과 같은 추가된 열이 포함됩니다.

  • MODEL_SCORES - 선택한 감지기 버전과 연결된 각 모델의 이벤트에 대한 모델 점수를 자세히 설명합니다.

  • OUTCOMES - 선택한 감지기 버전 및 해당 규칙에 따라 평가된 이벤트 결과를 자세히 설명합니다.

  • STATUS - 이벤트가 성공적으로 평가되었는지 여부를 나타냅니다. 이벤트가 성공적으로 평가되지 않은 경우이 열에는 실패의 이유 코드가 표시됩니다.

  • RULE_RESULTS - 규칙 실행 모드에 따라 일치하는 모든 규칙의 목록입니다.

배치 예측 가져오기

다음 단계에서는 이벤트 유형을 이미 생성하고, 해당 이벤트 유형을 사용하여 모델을 훈련시키고(선택 사항), 해당 이벤트 유형에 대한 감지기 버전을 생성했다고 가정합니다.

배치 예측을 가져오려면
  1. 에 로그인 AWS Management Console 하고 https://console.aws.amazon.com/frauddetector Amazon Fraud Detector 콘솔을 엽니다.

  2. Amazon Fraud Detector 콘솔의 왼쪽 탐색 창에서 배치 예측을 선택한 다음 새 배치 예측을 선택합니다.

  3. 작업 이름에서 배치 예측 작업의 이름을 지정합니다. 이름을 지정하지 않으면 Amazon Fraud Detector가 임의로 작업 이름을 생성합니다.

  4. 감지기에서이 배치 예측을 위한 감지기를 선택합니다.

  5. 감지기 버전에서이 배치 예측을 위한 감지기 버전을 선택합니다. 모든 상태의 감지기 버전을 선택할 수 있습니다. 감지기 버전이 Active 상태인 경우 해당 버전이 자동으로 선택되지만 필요한 경우이 선택을 변경할 수도 있습니다.

  6. IAM 역할에서 입력 및 출력 Amazon S3 버킷에 대한 읽기 및 쓰기 액세스 권한이 있는 역할을 선택하거나 생성합니다. 자세한 내용은 IAM 역할에 대한 지침 섹션을 참조하세요.

    배치 예측을 가져오려면 CreateBatchPredictionJob 작업을 호출하는 IAM 역할에 입력 S3 버킷에 대한 읽기 권한과 출력 S3 버킷에 대한 쓰기 권한이 있어야 합니다. 버킷 권한에 대한 자세한 내용은 Amazon S3 사용 설명서사용자 정책 예제를 참조하세요.

  7. 입력 데이터 위치에서 입력 데이터의 Amazon S3 위치를 지정합니다. 출력 파일을 다른 S3 버킷에 저장하려면 출력을 위한 데이터 위치 분리를 선택하고 출력 데이터에 대한 Amazon S3 위치를 제공합니다.

  8. (선택 사항) 배치 예측 작업에 대한 태그를 생성합니다.

  9. 시작을 선택합니다.

    Amazon Fraud Detector는 배치 예측 작업을 생성하고 작업의 상태는 입니다In progress. 배치 예측 작업 처리 시간은 이벤트 수와 감지기 버전 구성에 따라 달라집니다.

진행 중인 배치 예측 작업을 중지하려면 배치 예측 작업 세부 정보 페이지로 이동하여 작업을 선택한 다음 배치 예측 중지를 선택합니다. 배치 예측 작업을 중지하면 해당 작업에 대한 결과가 수신되지 않습니다.

배치 예측 작업의 상태가 로 변경되면 지정된 출력 Amazon S3 버킷에서 작업의 출력을 검색할 Complete수 있습니다. 출력 파일의 이름은 형식입니다batch prediction job name_file creation timestamp_output.csv. 예를 들어 라는 작업의 출력 파일은 mybatchjob입니다mybatchjob_ 1611170650_output.csv.

배치 예측 작업으로 평가된 특정 이벤트를 검색하려면 Amazon Fraud Detector 콘솔의 왼쪽 탐색 창에서 과거 예측 검색을 선택합니다.

완료된 배치 예측 작업을 삭제하려면 배치 예측 작업 세부 정보 페이지로 이동하여 작업을 선택한 다음 배치 예측 삭제를 선택합니다.

IAM 역할에 대한 지침

배치 예측을 가져오려면 CreateBatchPredictionJob 작업을 호출하는 IAM 역할에 입력 S3 버킷에 대한 읽기 권한과 출력 S3 버킷에 대한 쓰기 권한이 있어야 합니다. 버킷 권한에 대한 자세한 내용은 Amazon S3 사용 설명서의 사용자 정책 예제를 참조하세요. Amazon Fraud Detector 콘솔에는 배치 예측에 대한 IAM 역할을 선택하는 세 가지 옵션이 있습니다.

  1. 새 배치 예측 작업을 생성할 때 역할을 생성합니다.

  2. Amazon Fraud Detector 콘솔에서 이전에 생성한 기존 IAM 역할을 선택합니다. 이 단계를 수행하기 전에 역할에 S3:PutObject 권한을 추가해야 합니다.

  3. 이전에 생성한 IAM 역할에 대한 사용자 지정 ARN을 입력합니다.

IAM 역할과 관련된 오류가 발생하면 다음을 확인합니다.

  1. Amazon S3 입력 및 출력 버킷은 감지기와 동일한 리전에 있습니다.

  2. 사용 중인 IAM 역할에는 입력 S3 버킷에 대한 s3:GetObject 권한과 출력 S3 버킷에 대한 s3:PutObject 권한이 있습니다.

  3. 사용 중인 IAM 역할에는 서비스 보안 주체에 대한 신뢰 정책이 있습니다frauddetector.amazonaws.com.

를 사용하여 배치 사기 예측 가져오기 AWS SDK for Python (Boto3)

다음 예제에서는 CreateBatchPredictionJob API에 대한 샘플 요청을 보여줍니다. 배치 예측 작업에는 감지기, 감지기 버전 및 이벤트 유형 이름 등의 기존 리소스가 포함되어야 합니다. 다음 예제에서는 이벤트 유형 sample_registration, 감지기 및 감지기 버전 sample_detector를 생성했다고 가정합니다1.

import boto3 fraudDetector = boto3.client('frauddetector') fraudDetector.create_batch_prediction_job ( jobId = 'sample_batch', inputPath = 's3://bucket_name/input_file_name.csv', outputPath = 's3://bucket_name/', eventTypeName = 'sample_registration', detectorName = 'sample_detector', detectorVersion = '1', iamRoleArn = 'arn:aws:iam::**:role/service-role/AmazonFraudDetector-DataAccessRole-**' )