이 페이지에서는 Dataproc Metastore를 사용할 때 표시될 수 있는 일반적인 오류 메시지를 설명합니다. 각 섹션에는 메시지의 의미와 오류 해결을 위한 권장 조치에 대한 자세한 정보가 포함되어 있습니다.
일반적인 오류:
-
- 'ResourceName 오류 경로 [RESOURCE_NAME]이(가) [RESOURCE_TEMPLATE] 템플릿과 일치하지 않습니다.'
- '잘못된 웨어하우스 디렉터리 재정의: [GCS_URI].'
- '제공된 krb5.conf 객체 krb5Config가 잘못되었습니다.'
-
- '리소스 [RESOURCE_NAME]의 현재 상태가 이 작업에 유효한 상태가 아닙니다. 유효한 상태는 [RESOURCE_STATE]입니다.'
- Dataproc Metastore 서비스에서 업데이트, 가져오기, 내보내기, 백업 또는 복원을 실행하려고 했지만 서비스가
ACTIVE
가 아닙니다. - '백업 [BACKUP_ID]이(가) 준비되지 않았습니다.'
-
- Dataproc Metastore API를 호출할 권한이 부족했습니다.
-
'Dataproc Metastore 서비스 에이전트 [SERVICE_AGENT]에 네트워크 [NETWORK]에 액세스할 수 있는 충분한 IAM 권한이 없습니다. 서비스 에이전트에 [PROJECT_NUMBER] 프로젝트에서 roles/metastore.serviceAgent가 부여되었는지 확인하세요.'
'Dataproc Metastore 서비스 에이전트가 [SERVICE_AGENT_PERMISSIONS] 권한으로 Cloud Storage URI [GCS_URI]에 액세스할 수 없습니다. 권한 또는 VPC 서비스 제어 서비스 경계를 확인하세요.'
'제공된 웨어하우스 디렉터리의 Cloud Storage 버킷 [GCS_URI]을(를) Dataproc Metastore 서비스 에이전트가 읽고 쓸 수 없습니다.'
가져오기 및 내보내기 관련 오류:
-
- 'Dataproc Metastore 서비스 에이전트' 또는 '호출자'가 가져오기/내보내기에 필요한 Cloud Storage URI 권한이 없습니다([SERVICE_AGENT]이(가) [SERVICE_AGENT_PERMISSIONS] 권한으로 Cloud Storage URI [GCS_URI]에 액세스할 수 없습니다).'
지원되지 않는 Hive 버전에서 Avro 가져오기 또는 내보내기 실행
- 'Avro 파일에서 가져오기는 Hive 버전 [HIVE_METASTORE_VERSION]에서 지원되지 않으며 지원되는 버전은 [SUPPORT_HIVE_VERSIONS]입니다.'
-
- 'Avro 소스 파일을 [MISSING_TABLE_LIST] 테이블에서 찾을 수 없습니다.'
- 'Hive 스키마 유효성 검사 실패, 누락된 테이블: [MISSING_TABLE_LIST].'
백업 및 복원 관련 오류:
-
- '백업 [BACKUP_ID]을(를) 찾을 수 없습니다.'
-
- '[RESOURCE_STATE] 상태의 백업을 삭제할 수 없습니다.'
일반적인 오류
이 섹션에서는 일반적인 오류에 대해 설명합니다.
잘못된 클라이언트 입력
서버의 상태와 관계없이 요청의 특정 부분이 유효하지 않음을 의미하는 일반 오류입니다. 이 오류 유형은 다음과 같은 여러 가지 이유로 트리거될 수 있습니다.
REST API를 사용할 때 잘못된 형식으로 네트워크 이름을 지정했습니다.
ResourceName 오류 경로 [RESOURCE_NAME]이(가) [RESOURCE_TEMPLATE] 템플릿과 일치하지 않습니다.
웨어하우스 디렉터리가 올바른 Cloud Storage 경로가 아닙니다. 자세한 내용은 Hive Metastore를 참조하세요.
잘못된 웨어하우스 디렉터리 재정의: [GCS_URI].
잘못된 Kerberos 구성을 지정했습니다(서비스용 Kerberos 구성 참조).
제공된 krb5.conf 객체 krb5Config가 잘못되었습니다.
권장 조치: 요청을 수정하세요.
잘못된 API 리소스 상태
요청의 특정 부분이 서버 리소스의 현재 상태와 호환되지 않음을 의미하는 일반 오류입니다.
리소스 [RESOURCE_NAME]의 현재 상태가 이 작업에 유효한 상태가 아닙니다. 유효한 상태는 [RESOURCE_STATE]입니다.
이 문제는 API 리소스(Dataproc Metastore 서비스, 가져오기, 내보내기, 백업 또는 복원)가 작업을 수행할 올바른 상태가 아닌 경우에 발생할 수 있습니다. 예를 들면 다음과 같습니다.
- Dataproc Metastore 서비스에서 업데이트, 가져오기, 내보내기, 백업 또는 복원을 실행하려고 했지만 서비스가
ACTIVE
가 아닙니다. 백업을 복원하려고 했고 Dataproc Metastore 서비스가
ACTIVE
이지만 백업은ACTIVE
가 아닙니다.백업 [BACKUP_ID]이(가) 준비되지 않았습니다.
권장 조치: 요청을 다시 시도하기 전에 API 리소스가 올바른 상태인지 확인합니다.
API 액세스 권한
Dataproc Metastore API를 호출할 권한이 부족했습니다.
권장 조치: 사용자에게 올바른 Dataproc Metastore IAM 권한을 부여합니다.
부족한 서비스 에이전트 권한
프로젝트에서 리소스를 만들 때 권한 오류가 수신되었습니다. 이 오류는 일반적으로 삭제된 서비스 계정 또는 수정된 서비스 계정 권한에 의해 발생합니다. 예를 들면 다음과 같습니다.
다른 프로젝트에 속하는 네트워크를 사용했지만 Dataproc Metastore 서비스 에이전트에 여기에 액세스할 수 있는 권한을 부여하지 않았습니다. 자세한 내용은 프로젝트 간 배포를 참조하세요.
Dataproc Metastore 서비스 에이전트 [SERVICE_AGENT]가 네트워크 [NETWORK]에 액세스할 수 있는 충분한 IAM 권한을 가지고 있지 않습니다. 서비스 에이전트에 [PROJECT_NUMBER] 프로젝트에서 roles/metastore.serviceAgent가 부여되었는지 확인하세요.
커스텀 데이터 웨어하우스 Cloud Storage 버킷을 제공했지만 Dataproc Metastore 서비스 에이전트에게 여기에 액세스할 수 있는 권한을 부여하지 않았습니다. 자세한 내용은 Hive 웨어하우스 디렉터리를 참조하세요.
Dataproc Metastore 서비스 에이전트가 [SERVICE_AGENT_PERMISSIONS] 권한으로 Cloud Storage URI [GCS_URI]에 액세스할 수 없습니다. 권한 또는 VPC 서비스 제어 서비스 경계를 확인하세요.
또는 Dataproc Metastore가 웨어하우스 디렉터리 Cloud Storage 경로에 액세스할 수 없습니다.
제공된 웨어하우스 디렉터리의 Cloud Storage 버킷 [GCS_URI]을(를) Dataproc Metastore 서비스 에이전트가 읽고 쓸 수 없습니다.
권장 조치: 서비스 계정 권한이나 VPC 서비스 제어 서비스 경계를 확인합니다.
가져오기 및 내보내기 관련 오류
이 섹션에서는 가져오기 및 내보내기 관련 오류를 설명합니다.
Cloud Storage 권한 가져오기 및 내보내기
Dataproc Metastore 서비스 에이전트에 가져오기 또는 내보내기를 수행할 수 있는 권한이 부족했습니다.
'Dataproc Metastore 서비스 에이전트' 또는 '호출자'가 가져오기/내보내기에 필요한 Cloud Storage URI 권한이 없습니다([SERVICE_AGENT]이(가) [SERVICE_AGENT_PERMISSIONS] 권한으로 Cloud Storage URI [GCS_URI]에 액세스할 수 없습니다).
권장 조치: 서비스 계정 권한이나 VPC 서비스 제어 서비스 경계를 확인합니다.
지원되지 않는 Hive 버전에서 Avro 가져오기 또는 내보내기 실행
Avro 파일에서 가져오기는 Hive 버전 [HIVE_METASTORE_VERSION]에서 지원되지 않으며 지원되는 버전은 [SUPPORT_HIVE_VERSIONS]입니다.
권장 조치: 버전 정책에서 최신 Hive 버전 지원을 참조하세요. 데이터베이스 파일을 지원되는 버전으로 업데이트합니다.
가져오기 테이블 누락
Avro 가져오기의 경우
Avro 소스 파일을 [MISSING_TABLE_LIST] 테이블에서 찾을 수 없습니다.
SQL 가져오기
Hive 스키마 유효성 검사 실패, 누락된 테이블: [MISSING_TABLE_LIST].
권장 조치: Dataproc Metastore Toolkit을 참조로 사용하여 데이터베이스 파일의 올바른 Hive 메타데이터 스키마를 확인합니다.
백업 및 복원 관련 오류
이 섹션에서는 백업 및 복원과 관련된 오류에 대해 설명합니다.
복원할 백업을 찾을 수 없음
서비스에서 백업을 복원할 때 Dataproc Metastore가 제공된 백업 리소스를 찾을 수 없습니다.
백업 [BACKUP_ID]을(를) 찾을 수 없습니다.
권장 조치: Dataproc Metastore 서비스 내에서 백업이 있는지 확인합니다.
백업을 삭제할 수 없음
서비스를 복원하는 데 사용 중인 백업을 삭제할 수 없습니다.
[RESOURCE_STATE] 상태의 백업을 삭제할 수 없습니다.
권장 조치: 백업을 삭제하기 전에 복원 작업이 완료될 때까지 기다립니다.
다음 단계
- Dataproc Metastore를 사용할 때 발생할 수 있는 일반적인 문제에 대한 해결책을 찾으려면 문제 해결을 참조하세요.