

# AWS Glue 기계 학습 예외 사항
<a name="exceptions-machine-learning"></a>

이 주제에서는 기계 학습과 관련된 AWS Glue 예외에 대한 HTTP 오류 코드 및 문자열에 대해 설명합니다. 작업을 수행할 때 발생할 수 있는 각 기계 학습 작업에 대해 오류 코드 및 오류 문자열이 제공됩니다. 또한 오류를 일으킨 작업을 다시 시도할 수 있는지 여부를 확인할 수 있습니다.

## CancelMLTaskRunActivity
<a name="exceptions-machine-learning-CancelMLTaskRunActivity"></a>

이 활동에는 다음과 같은 예외가 있습니다.
+ EntityNotFoundException (400)
  + “[transformName] 핸들이 있는 [accountId] 계정에서 MLTransform을 찾을 수 없습니다.”
  + “[transformName] 변환을 위한 [accountId] 계정에서 [taskRunId]에 대한 ML 작업 실행을 찾을 수 없습니다.”

  재시도 가능: 아니요.

## CreateMLTaskRunActivity
<a name="exceptions-machine-learning-CreateMLTransformActivity"></a>

이 활동에는 다음과 같은 예외가 있습니다.
+ InvalidInputException (400)
  + “예기치 않은 입력으로 인해 내부 서비스 오류가 발생했습니다.”
  + “변환에서 AWS Glue 테이블 입력 소스를 지정해야 합니다.”
  + “입력 소스 열 [columnName]에 카탈로그에 정의된 잘못된 데이터 형식이 있습니다.”
  + “정확히 하나의 입력 레코드 테이블을 제공해야 합니다.”
  + “데이터베이스 이름을 지정해야 합니다.”
  + “테이블 이름을 지정해야 합니다.”
  + “스키마가 변환에 정의되지 않았습니다.”
  + “스키마는 주어진 기본 키 [primaryKey]를 포함해야 합니다.”
  + “데이터 카탈로그 스키마를 가져오는 중 문제가 발생했습니다. [message].”
  + “최대 용량과 작업자 수/유형을 동시에 설정할 수 없습니다.”
  + “WorkerType과 NumberOfWorkers 둘 다 설정해야 합니다.”
  + “MaxCapacity는 >=[maxCapacity]이어야 합니다.”
  + “NumberOfWorkers는 >=[maxCapacity]이어야 합니다.”
  + “최대 재시도는 음수가 아니어야 합니다.”
  +  “일치 항목 찾기 파라미터가 설정되지 않았습니다.”
  + “일치 항목 찾기 파라미터에 기본 키를 지정해야 합니다.”

  재시도 가능: 아니요.
+ AlreadyExistsException (400)
  + “이름이 [transformName]인 변형이 이미 있습니다.”

  재시도 가능: 아니요.
+ IdempotentParameterMismatchException (400)
  + “[transformName] 변환에 대한 멱등성 생성 요청에 일치하지 않는 파라미터가 있습니다.”

  재시도 가능: 아니요.
+ InternalServiceException (500)
  + “종속성 오류가 발생했습니다.”

  재시도 가능: 예.
+ ResourceNumberLimitExceededException (400)
  + “ML 변환 수([count])가 [limit] 변환의 제한을 초과했습니다.”

  재시도 가능: 예, 이 새 변환을 위한 공간을 만들기 위해 변환을 삭제한 후 재시도합니다.

## DeleteMLTransformActivity
<a name="exceptions-machine-learning-DeleteMLTransformActivity"></a>

이 활동에는 다음과 같은 예외가 있습니다.
+ EntityNotFoundException (400)
  + “[transformName] 핸들이 있는 [accountId] 계정에서 MLTransform을 찾을 수 없습니다.”

  재시도 가능: 아니요.

## GetMLTaskRunActivity
<a name="exceptions-machine-learning-GetMLTaskRunActivity"></a>

이 활동에는 다음과 같은 예외가 있습니다.
+ EntityNotFoundException (400)
  + “[transformName] 핸들이 있는 [accountId] 계정에서 MLTransform을 찾을 수 없습니다.”
  + “[transformName] 변환을 위한 [accountId] 계정에서 [taskRunId]에 대한 ML 작업 실행을 찾을 수 없습니다.”

  재시도 가능: 아니요.

## GetMLTaskRunsActivity
<a name="exceptions-machine-learning-GetMLTaskRunsActivity"></a>

이 활동에는 다음과 같은 예외가 있습니다.
+ EntityNotFoundException (400)
  + “[transformName] 핸들이 있는 [accountId] 계정에서 MLTransform을 찾을 수 없습니다.”
  + “[transformName] 변환을 위한 [accountId] 계정에서 [taskRunId]에 대한 ML 작업 실행을 찾을 수 없습니다.”

  재시도 가능: 아니요.

## GetMLTransformActivity
<a name="exceptions-machine-learning-GetMLTransformActivity"></a>

이 활동에는 다음과 같은 예외가 있습니다.
+ EntityNotFoundException (400)
  + “[transformName] 핸들이 있는 [accountId] 계정에서 MLTransform을 찾을 수 없습니다.”

  재시도 가능: 아니요.

## GetMLTransformsActivity
<a name="exceptions-machine-learning-GetMLTransformsActivity"></a>

이 활동에는 다음과 같은 예외가 있습니다.
+ EntityNotFoundException (400)
  + “[transformName] 핸들이 있는 [accountId] 계정에서 MLTransform을 찾을 수 없습니다.”

  재시도 가능: 아니요.
+ InvalidInputException (400)
  + “계정 ID는 비워 둘 수 없습니다.”
  + “[column] 열에는 정렬이 지원되지 않습니다.”
  + “[column]은(는) 비워 둘 수 없습니다.”
  + “예기치 않은 입력으로 인해 내부 서비스 오류가 발생했습니다.”

  재시도 가능: 아니요.

## GetSaveLocationForTransformArtifactActivity
<a name="exceptions-machine-learning-GetSaveLocationForTransformArtifactActivity"></a>

이 활동에는 다음과 같은 예외가 있습니다.
+ EntityNotFoundException (400)
  + “[transformName] 핸들이 있는 [accountId] 계정에서 MLTransform을 찾을 수 없습니다.”

  재시도 가능: 아니요.
+ InvalidInputException (400)
  + “지원되지 않는 아티팩트 유형 [artifactType]입니다.”
  + “예기치 않은 입력으로 인해 내부 서비스 오류가 발생했습니다.”

  재시도 가능: 아니요.

## GetTaskRunArtifactActivity
<a name="exceptions-machine-learning-GetTaskRunArtifactActivity"></a>

이 활동에는 다음과 같은 예외가 있습니다.
+ EntityNotFoundException (400)
  + “[transformName] 핸들이 있는 [accountId] 계정에서 MLTransform을 찾을 수 없습니다.”
  + “[transformName] 변환을 위한 [accountId] 계정에서 [taskRunId]에 대한 ML 작업 실행을 찾을 수 없습니다.”

  재시도 가능: 아니요.
+ InvalidInputException (400)
  + “파일 이름 '[fileName]’이(가) 게시에 유효하지 않습니다.”
  + “[taskType] 작업 유형에 대한 아티팩트를 검색할 수 없습니다.”
  + “[artifactType]에 대한 아티팩트를 검색할 수 없습니다.”
  + “예기치 않은 입력으로 인해 내부 서비스 오류가 발생했습니다.”

  재시도 가능: 아니요.

## PublishMLTransformModelActivity
<a name="exceptions-machine-learning-PublishMLTransformModelActivity"></a>

이 활동에는 다음과 같은 예외가 있습니다.
+ EntityNotFoundException (400)
  + “[transformName] 핸들이 있는 [accountId] 계정에서 MLTransform을 찾을 수 없습니다.”
  + “계정 ID - [accountId] - 및 변환 ID - [transformId]에서 버전 - [version] 버전이 있는 기존 모델을 찾을 수 없습니다.”

  재시도 가능: 아니요.
+ InvalidInputException (400)
  + “파일 이름 '[fileName]’이(가) 게시에 유효하지 않습니다.”
  + “부호 없는 문자열 [string] 앞에 잘못된 마이너스 부호가 있습니다.”
  + “[string]의 끝에 잘못된 숫자가 있습니다.”
  +  “문자열 값 [string]은(는) 부호 없는 long 범위를 초과합니다.”
  + “예기치 않은 입력으로 인해 내부 서비스 오류가 발생했습니다.”

  재시도 가능: 아니요.

## PullLatestMLTransformModelActivity
<a name="exceptions-machine-learning-PullLatestMLTransformModelActivity"></a>

이 활동에는 다음과 같은 예외가 있습니다.
+ EntityNotFoundException (400)
  + “[transformName] 핸들이 있는 [accountId] 계정에서 MLTransform을 찾을 수 없습니다.”

  재시도 가능: 아니요.
+ InvalidInputException (400)
  + “예기치 않은 입력으로 인해 내부 서비스 오류가 발생했습니다.”

  재시도 가능: 아니요.
+ ConcurrentModificationException (400)
  + “파라미터가 일치하지 않는 레이싱 입력으로 인해 훈련할 모델 버전을 만들 수 없습니다.”
  + “변환 ID [transformId]에 대한 ML 변환 모델이 오래되었거나 다른 프로세스에 의해 업데이트되고 있습니다. 다시 시도하십시오.”

  재시도 가능: 예.

## PutJobMetadataForMLTransformActivity
<a name="exceptions-machine-learning-PutJobMetadataForMLTransformActivity"></a>

이 활동에는 다음과 같은 예외가 있습니다.
+ EntityNotFoundException (400)
  + “[transformName] 핸들이 있는 [accountId] 계정에서 MLTransform을 찾을 수 없습니다.”
  + “[transformName] 변환을 위한 [accountId] 계정에서 [taskRunId]에 대한 ML 작업 실행을 찾을 수 없습니다.”

  재시도 가능: 아니요.
+ InvalidInputException (400)
  + “예기치 않은 입력으로 인해 내부 서비스 오류가 발생했습니다.”
  + “알 수 없는 작업 메타데이터 유형 [jobType]입니다.”
  +  “업데이트할 작업 실행 ID를 제공해야 합니다.”

  재시도 가능: 아니요.

## StartExportLabelsTaskRunActivity
<a name="exceptions-machine-learning-StartExportLabelsTaskRunActivity"></a>

이 활동에는 다음과 같은 예외가 있습니다.
+ EntityNotFoundException (400)
  + “[transformName] 핸들이 있는 [accountId] 계정에서 MLTransform을 찾을 수 없습니다.”
  + “계정 ID [accountId]에 변환 ID [transformId]에 대한 labelset가 없습니다.”

  재시도 가능: 아니요.
+ InvalidInputException (400)
  + “[message].”
  + “제공된 S3 경로가 변환과 동일한 리전에 있지 않습니다. 예상한 리전은 [region]이지만 받은 리전은 [region]입니다.”

  재시도 가능: 아니요.

## StartImportLabelsTaskRunActivity
<a name="exceptions-machine-learning-StartExportLabelsTaskRunActivity"></a>

이 활동에는 다음과 같은 예외가 있습니다.
+ EntityNotFoundException (400)
  + “[transformName] 핸들이 있는 [accountId] 계정에서 MLTransform을 찾을 수 없습니다.”

  재시도 가능: 아니요.
+ InvalidInputException (400)
  + “[message].”
  + “잘못된 레이블 파일 경로입니다.”
  + “[labelPath]에서 레이블 파일에 액세스할 수 없습니다. [message].”
  + “변환에 제공된 IAM 역할을 사용할 수 없습니다. 역할: [role]입니다.”
  + “크기가 0인 잘못된 레이블 파일입니다.”
  + “제공된 S3 경로가 변환과 동일한 리전에 있지 않습니다. 예상한 리전은 [region]이지만 받은 리전은 [region]입니다.”

  재시도 가능: 아니요.
+ ResourceNumberLimitExceededException (400)
  + “레이블 파일이 [limit]MB 제한을 초과했습니다.”

  재시도 가능: 아니오. 레이블 파일을 여러 개의 작은 파일로 나누는 것이 좋습니다.

## StartMLEvaluationTaskRunActivity
<a name="exceptions-machine-learning-StartMLEvaluationTaskRunActivity"></a>

이 활동에는 다음과 같은 예외가 있습니다.
+ EntityNotFoundException (400)
  + “[transformName] 핸들이 있는 [accountId] 계정에서 MLTransform을 찾을 수 없습니다.”

  재시도 가능: 아니요.
+ InvalidInputException (400)
  + “정확히 하나의 입력 레코드 테이블을 제공해야 합니다.”
  + “데이터베이스 이름을 지정해야 합니다.”
  + “테이블 이름을 지정해야 합니다.”
  + “일치 항목 찾기 파라미터가 설정되지 않았습니다.”
  + “일치 항목 찾기 파라미터에 기본 키를 지정해야 합니다.”

  재시도 가능: 아니요.
+ MLTransformNotReadyException (400)
  + “이 작업은 준비 상태에 있는 변환에만 적용할 수 있습니다.”

  재시도 가능: 아니요.
+ InternalServiceException (500)
  + “종속성 오류가 발생했습니다.”

  재시도 가능: 예.
+ ConcurrentRunsExceededException (400)
  + “ML 작업 실행 수 [count]이(가) 작업 실행 [limit]의 변환 제한을 초과했습니다.”
  + “ML 작업 실행 수 [count]이(가) 작업 실행 [limit]의 제한을 초과했습니다.”

  재시도 가능: 예, 작업 실행이 완료될 때까지 기다린 후 재시도합니다.

## StartMLLabelingSetGenerationTaskRunActivity
<a name="exceptions-machine-learning-StartMLLabelingSetGenerationTaskRunActivity"></a>

이 활동에는 다음과 같은 예외가 있습니다.
+ EntityNotFoundException (400)
  + “[transformName] 핸들이 있는 [accountId] 계정에서 MLTransform을 찾을 수 없습니다.”

  재시도 가능: 아니요.
+ InvalidInputException (400)
  + “정확히 하나의 입력 레코드 테이블을 제공해야 합니다.”
  + “데이터베이스 이름을 지정해야 합니다.”
  + “테이블 이름을 지정해야 합니다.”
  + “일치 항목 찾기 파라미터가 설정되지 않았습니다.”
  + “일치 항목 찾기 파라미터에 기본 키를 지정해야 합니다.”

  재시도 가능: 아니요.
+ InternalServiceException (500)
  + “종속성 오류가 발생했습니다.”

  재시도 가능: 예.
+ ConcurrentRunsExceededException (400)
  + “ML 작업 실행 수 [count]이(가) 작업 실행 [limit]의 변환 제한을 초과했습니다.”

  재시도 가능: 예, 작업 실행이 완료된 후 재시도합니다.

## UpdateMLTransformActivity
<a name="exceptions-machine-learning-UpdateMLTransformActivity"></a>

이 활동에는 다음과 같은 예외가 있습니다.
+ EntityNotFoundException (400)
  + “[transformName] 핸들이 있는 [accountId] 계정에서 MLTransform을 찾을 수 없습니다.”

  재시도 가능: 아니요.
+ InvalidInputException (400)
  + “이름이 [transformName]인 다른 변환이 이미 있습니다.”
  + “[message].”
  + “변환 이름은 비워 둘 수 없습니다.”
  + “최대 용량과 작업자 수/유형을 동시에 설정할 수 없습니다.”
  + “WorkerType과 NumberOfWorkers 둘 다 설정해야 합니다.”
  + “MaxCapacity는 >=[minMaxCapacity]이어야 합니다.”
  + “NumberOfWorkers는 >=[minNumWorkers]이어야 합니다.”
  + “최대 재시도는 음수가 아니어야 합니다.”
  + “예기치 않은 입력으로 인해 내부 서비스 오류가 발생했습니다.”
  + “일치 항목 찾기 파라미터가 설정되지 않았습니다.”
  + “일치 항목 찾기 파라미터에 기본 키를 지정해야 합니다.”

  재시도 가능: 아니요.
+ AlreadyExistsException (400)
  + “이름이 [transformName]인 변형이 이미 있습니다.”

  재시도 가능: 아니요.
+ IdempotentParameterMismatchException (400)
  + “[transformName] 변환에 대한 멱등성 생성 요청에 일치하지 않는 파라미터가 있습니다.”

  재시도 가능: 아니요.