오류 메시지

이 페이지에서는 Dataproc Metastore를 사용할 때 표시될 수 있는 일반적인 오류 메시지를 설명합니다. 각 섹션에는 메시지의 의미와 오류 해결을 위한 권장 조치에 대한 자세한 정보가 포함되어 있습니다.

일반적인 오류:

  • 잘못된 클라이언트 입력:

    • 'ResourceName 오류 경로 [RESOURCE_NAME]이(가) [RESOURCE_TEMPLATE] 템플릿과 일치하지 않습니다.'
    • '잘못된 웨어하우스 디렉터리 재정의: [GCS_URI].'
    • '제공된 krb5.conf 객체 krb5Config가 잘못되었습니다.'

  • 잘못된 API 리소스 상태:

    • '리소스 [RESOURCE_NAME]의 현재 상태가 이 작업에 유효한 상태가 아닙니다. 유효한 상태는 [RESOURCE_STATE]입니다.'
    • Dataproc Metastore 서비스에서 업데이트, 가져오기, 내보내기, 백업 또는 복원을 실행하려고 했지만 서비스가 ACTIVE가 아닙니다.
    • '백업 [BACKUP_ID]이(가) 준비되지 않았습니다.'

  • API 액세스 권한:

    • 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 서비스 에이전트가 읽고 쓸 수 없습니다.'

가져오기 및 내보내기 관련 오류:

백업 및 복원 관련 오류:

일반적인 오류

이 섹션에서는 일반적인 오류에 대해 설명합니다.

잘못된 클라이언트 입력

서버의 상태와 관계없이 요청의 특정 부분이 유효하지 않음을 의미하는 일반 오류입니다. 이 오류 유형은 다음과 같은 여러 가지 이유로 트리거될 수 있습니다.

  • 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를 사용할 때 발생할 수 있는 일반적인 문제에 대한 해결책을 찾으려면 문제 해결을 참조하세요.