오류 메시지

Document AI에서 발생한 몇 가지 오류를 해결하는 방법을 알아봅니다. 이 주제에서는 오류 메시지에 설명된 것 이상으로 추가 해결 단계가 필요한 오류를 설명합니다.

오류 처리 권장사항은 Cloud API 문서를 참고하세요.

권한

해결하려면 오류 메시지에 설명된 대로 몇 가지 단계를 실행해야 합니다.

애플리케이션 기본 사용자 인증 정보를 사용할 수 없음

다음과 같은 메시지가 표시될 경우:

The Application Default Credentials are not available. They are
available if running in Compute Engine. Otherwise, the
environment variable GOOGLE_APPLICATION_CREDENTIALS must be defined
pointing to a file defining the credentials.
See https://developers.google.com/accounts/docs/application-default-credentials
for more information.

Document AI는 인증에 애플리케이션 기본 사용자 인증 정보를 사용합니다.

프로젝트의 서비스 계정이 있어야 하며 서비스 계정의 키(JSON 파일)를 개발 환경에 다운로드한 다음 JSON 파일 위치를 GOOGLE_APPLICATION_CREDENTIALS라는 환경 변수로 설정해야 합니다.

또한 Document AI API를 호출하는 컨텍스트 내에서 GOOGLE_APPLICATION_CREDENTIALS 환경 변수를 사용할 수 있어야 합니다. 예를 들어 터미널 세션 내에서 변수를 설정했는데 IDE의 디버거에서 코드를 실행하면 코드의 실행 컨텍스트가 변수에 액세스하지 못할 수 있습니다. 이러한 상황에서는 적절한 인증이 이루어지지 않아 Document AI 요청이 실패할 수 있습니다.

GOOGLE_APPLICATION_CREDENTIALS 환경 변수를 설정하는 방법에 대한 자세한 내용은 Document AI 빠른 시작 또는 애플리케이션 기본 사용자 인증 정보 사용에 관한 문서를 참고하세요.

권한 거부됨

다음과 같은 메시지가 표시될 경우:

ERROR: (gcloud.auth.application-default.print-access-token) File
(pointed by GOOGLE_APPLICATION_CREDENTIALS environment variable) does not exist!
{
  "error": {
    "code": 403,
    "message": "The request is missing a valid API key.",
    "status": "PERMISSION_DENIED"
  }
}

GOOGLE_APPLICATION_CREDENTIALS 환경 변수에 저장된 위치에 유효한 서비스 계정 키 JSON 파일이 있고 이 변수가 올바른 위치를 가리키고 있는지 확인합니다.

이 오류를 진단하려면 Document AI API를 호출하려는 폴더에서 서비스 계정 키 파일을 열어보세요.

cat $GOOGLE_APPLICATION_CREDENTIALS

금지됨: 403 POST API를 사용한 적이 없거나 사용 중지했습니다.

다음과 같은 메시지가 표시될 경우:

Forbidden: 403 POST Document AI API has not been used in
project # before or it is disabled.
Enable it by visiting [url], then retry.
If you enabled this API recently, wait a few minutes for the action to
propagate and retry.
  1. 오류 메시지에 지정된 링크로 이동하여 Document AI API를 사용 설정합니다. 몇 분 정도 기다린 후 다시 시도합니다.
  2. GOOGLE_APPLICATION_CREDENTIALS 환경 변수에 유효한 서비스 계정 키 JSON 파일이 저장되어 있는지 확인합니다. 이 오류를 진단하려면 Document AI API를 호출하려는 폴더에서 서비스 계정 키 파일을 열어보세요. 
    cat $GOOGLE_APPLICATION_CREDENTIALS

최종 출력 쓰기 오류

일괄 처리 요청의 결과를 수신할 때 다음과 같은 메시지가 표시되면

{
  "name": "projects/project-name/operations/operation-id",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.document.v1beta1.OperationMetadata",
    "state": "SUCCEEDED",
    "createTime": "2019-09-19T02:02:15.885267760Z",
    "updateTime": "2019-09-19T02:02:31.896425001Z"
  },
  "done": true,
  "error": {
    "code": 5,
    "message": "Error writing final output to: gs://bucket-name/filename.json"
  }
}

서비스 계정에 Cloud Storage 버킷에 객체를 만들 권한이 없을 수 있습니다. 빠른 시작에 설명된 대로 서비스 계정에 올바른 권한을 할당했는지 확인합니다.

Cloud Storage 버킷 이름을 잘못 입력했을 수도 있습니다. 액세스하려는 버킷이 있는지 확인합니다.

P4SA에 Cloud Storage 액세스 권한 없음

Document AI 제품별 서비스 계정 (P4SA)에 일부 Cloud Storage 리소스에 액세스할 권한이 없는 경우

message: Cloud DocumentAI P4SA doesn't have access to this Cloud Storage resource:

서비스 계정이 Cloud Storage에 객체를 만들 수 없음

Document AI 제품별 서비스 계정 (P4SA)에 Cloud Storage에 객체를 만들 권한이 없는 경우

message: Service account service-123@gcp-sa-prod-dai-core.iam.gserviceaccount.com
         does not have permission storage.objects.create to create
         Google Cloud Storage object in bucket gs://foo.

Document AI 서비스 계정에 Cloud Storage 버킷에 객체를 만들 권한이 없을 수 있습니다. 교차 프로젝트 파일 액세스 설정에 설명된 대로 Document AI 서비스 계정에 올바른 권한을 할당했는지 확인합니다.

Cloud Storage 버킷 이름을 잘못 입력했을 수도 있습니다. 액세스하려는 버킷이 있는지 확인합니다.

호출자가 Cloud Storage의 객체를 가져올 수 없음

Document AI API 호출자에게 Cloud Storage의 객체를 가져올 권한이 없는 경우

message: The caller does not have permission storage.objects.get to get Google
         Cloud Storage objects in bucket gs://foo.

API 호출자에게 Cloud Storage 버킷의 객체를 가져오는 데 필요한 올바른 권한이 없을 수 있습니다. 호출자에게 올바른 권한을 할당했는지 확인합니다.

Cloud Storage 버킷 이름을 잘못 입력했을 수도 있습니다. 액세스하려는 버킷이 있는지 확인합니다.

잘못된 인수

해결하려면 오류 메시지에 설명된 대로 몇 가지 단계를 실행해야 합니다.

지원되지 않는 API 버전

예: 작업을 지원하지 않는 API 버전에 요청이 이루어진 경우

message: "The requested operation is unsupported for the API version."

잘못된 요청

API 요청이 이루어졌지만 요청 필드에 위반사항이 하나 이상 있는 경우 각 위반사항은 google.rpc.BadRequest 세부정보에서 field_violations로 캡처됩니다.

message: "Request contains an invalid argument."
details {
  [type.googleapis.com/google.rpc.BadRequest] {
    field_violations { field: "foo" description: "bar" }
  }
}

모든 문서 일괄 처리에 실패함

일괄 처리 요청의 모든 문서를 처리할 수 없는 경우

message: "Failed to process all documents."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "FAILED_TO_PROCESS_ALL_DOCUMENTS"
    domain: "documentai.googleapis.com"
  }
}

문서 없음

문서가 필요하거나 예상되지만 제공되지 않은 경우(예: Cloud Storage URI로 문서를 가져올 때)

message: "No valid documents found in ${training|test} directory. Ensure files are in a supported MIME type. For details, see https://cloud.google.com/document-ai/docs/file-types."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "NO_DOCUMENTS"
    domain: "documentai.googleapis.com"
  }
}

gcsUriPrefix 및 gcsOutputConfig.gcsUri 매개변수는 gs://로 시작하고 후행 백슬래시 문자 (/)로 끝나야 합니다. 버킷 URI의 구성을 확인합니다.

예: gs://bucket/directory/

학습이 지원되지 않음

학습을 지원하지 않는 프로세서 유형에 학습 프로세서 버전 요청이 이루어진 경우

message: "Training is not supported on processor type: ${DOCUMENT_TYPE}_PROCESSOR."

선택한 문서 없음

데이터 라벨링 작업을 만들 때와 같이 문서가 예상되지만 데이터 세트에서 선택된 문서가 없는 경우

message: No documents selected. Please select at least one document."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "NO_DOCUMENTS_SELECTED"
    domain: "documentai.googleapis.com"
  }
}

문서 유형을 찾을 수 없음

문서 클래스 (예: 라이선스, 여권, 인보이스)가 처리자 유형에 필요한 분류와 일치하지 않는 경우 예를 들어 W2 파서에서 분류 단계가 인보이스에서 요소를 찾지 못하는 경우입니다.

Google Cloud 콘솔에서는 Couldn't preview the document: Unable to find a document of type: 'foo'로 표시될 수도 있습니다. 이 오류 메시지는 기존 프로세서에 적용됩니다.

message: "Unable to find a document of type: 'foo'"
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "DOCUMENT_OF_TYPE_NOT_FOUND"
    domain: "documentai.googleapis.com"
  }
}

문서 크기 제한을 초과했습니다.

데이터 세트를 가져오거나 예측을 실행하는 동안 문서의 파일 크기 상한이 초과된 경우

message: "Document size (2) exceeds limit: 1 (bytes)."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "DOCUMENT_SIZE_LIMIT_EXCEEDED"
    domain: "documentai.googleapis.com"
    metadata { key: "limit" value: "1" }
    metadata { key: "size" value: "2" }
  }
}

문서 한도 초과

문서 수의 상한이 초과된 경우

message: "Document count exceed the limit: 5 got 6"
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "DOCUMENT_LIMIT_EXCEEDED"
    domain: "documentai.googleapis.com"
    metadata { key: "document_limit" value: "5" }
    metadata { key: "documents" value: "6" }
  }
}

지원되지 않는 MIME 유형

지원되지 않는 MIME 유형이 제공된 경우 시스템은 데이터 세트를 가져올 때와 예측을 호출할 때 파일 형식(MIME 유형)을 확인합니다. 파일 형식이 지원되지 않으면 다음과 같은 오류 메시지가 표시됩니다.

message: "Unsupported mime type: 'foo'."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "UNSUPPORTED_MIME_TYPE"
    domain: "documentai.googleapis.com"
    metadata { key: "mime_type" value: "foo" }
  }
}

잘못된 문서 MIME 유형

문서 내용이 지정된 MIME 유형과 일치하지 않는 경우 시스템은 데이터 세트를 가져올 때와 예측을 호출할 때 파일 형식 (MIME 유형)을 확인합니다. 제공한 파일 형식이 예상 형식과 일치하지 않으면 다음과 같은 오류 메시지가 표시됩니다.

message: "Incorrect document content for mime_type: foo"
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "INCORRECT_DOCUMENT_MIME_TYPE"
    domain: "documentai.googleapis.com"
    metadata { key: "mime_type" value: "foo" }
  }
}

페이지 없음

페이지가 없는 문서가 제출되었지만 하나 이상의 페이지가 필요한 경우

message: "No pages were found in the document."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "NO_PAGES"
    domain: "documentai.googleapis.com"
  }
}

음수 페이지 번호

문서에 페이지 번호 중 하나에 음수 값이 표시된 경우

message: "Page number cannot be negative."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "NEGATIVE_PAGE_NUMBER"
    domain: "documentai.googleapis.com"
  }
}

중복된 페이지 번호

문서에 동일한 페이지 번호가 한 번 이상 표시되는 경우

message: "Duplicate page number detected (page numbers to indices): [{1, [1, 2]}, {4, [4, 5]}]."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "DUPLICATE_PAGE_NUMBERS"
    domain: "documentai.googleapis.com"
    metadata {
      key: "page_number_to_indices"
      value: "[{1, [1, 2]}, {4, [4, 5]}]"
    }
  }
}

페이지 한도 초과

문서의 총 페이지 수가 상한을 초과하는 경우 데이터 세트 내 문서의 페이지 수가 너무 많아 프로세서의 한도를 초과하면 데이터 세트 가져오기 또는 예측 중에 이 오류가 발생합니다.

message: "Document pages exceed the limit: 5 got 6"
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "PAGE_LIMIT_EXCEEDED"
    domain: "documentai.googleapis.com"
    metadata { key: "page_limit" value: "5" }
    metadata { key: "pages" value: "6" }
  }
}

사전 학습된 프로세서 버전 상태 변경

사전 학습된 프로세서 버전의 상태를 변경해 달라는 요청이 접수되었습니다. 사전 학습된 프로세서 버전을 삭제하려고 하면 이 오류가 발생합니다.

message: "ProcessorVersion with id 'xyz' is pretrained by Google and cannot change states."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "PRETRAINED_PROCESSOR_VERSION_STATE_CHANGE"
    domain: "documentai.googleapis.com"
    metadata { key: "processor_id" value: "abc" }
    metadata { key: "target_state" value: "DELETING" }
    metadata { key: "version_id" value: "xyz" }
  }
}

데이터 세트 검증

페이지 앵커 누락, 잘못된 데이터 또는 문서 프로토 객체의 일부 속성에 불완전한 세부정보가 포함되어 등과 같이 데이터 세트가 검증 기준을 충족하지 않는 경우

message: "Invalid dataset. See operation metadata for specific errors."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "INVALID_DATASET"
    domain: "documentai.googleapis.com"
  }
}

검토를 위해 인간 참여형(Human In The Loop)으로 인라인되지 않은 문서

인라인으로 정의되지 않은 문서에 대해 사람의 검토가 시작된 경우

message: "The document for review must be provided inline."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "HUMAN_REVIEW_NON_INLINED_DOCUMENT"
    domain: "documentai.googleapis.com"
  }
}

잘못된 서류 유형

지원되지 않거나 형식이 잘못된 파일 형식(예: .mp4.)의 문서가 참조될 때

message: "Invalid document type: 'foo'."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "INVALID_DOCUMENT_TYPE"
    domain: "documentai.googleapis.com"
    metadata { key: "type" value: "foo" }
  }
}

문서 범위가 범위를 벗어남

message: "Text span [1, 5) is out of bounds: [1, 3)."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "DOCUMENT_SPAN_OUT_OF_BOUNDS"
    domain: "documentai.googleapis.com"
    metadata { key: "bounds" value: "[1, 3)" }
    metadata { key: "span" value: "[1, 5)" }
    metadata { key: "type" value: "Text" }
  }
}

잘못된 문서 범위

시작이 끝보다 나중에 오는 등 잘못된 문서 범위가 제공된 경우

message: "Character span is invalid. Ensure the max is greater than the min."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "DOCUMENT_SPAN_INVALID"
    domain: "documentai.googleapis.com"
    metadata { key: "span" value: "Character" }
  }
}

잘못된 UTF-8 문서

잘못된 UTF-8이 포함된 문서가 제공된 경우

message: "Document contains invalid UTF-8 text."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "DOCUMENT_INVALID_UTF_8"
    domain: "documentai.googleapis.com"
    metadata { key: "bytes" value: "[2, 3)" }
  }
}

데이터 세트 스키마가 잘못됨

프로세서에 유효한 연합 스키마가 없거나 지정된 데이터 세트 스키마가 유효하지 않은 경우

message: "The processor has an empty or invalid schema: "
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "INVALID_SCHEMA_ERROR"
    domain: "documentai.googleapis.com"
  }
}

OcrConfig 지원되지 않음

OcrConfig를 지원하지 않는 프로세서에 대한 처리 요청이 실행되는 경우

message: "OcrConfig is not supported for processor type: 'foo'."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "OCR_CONFIG_UNSUPPORTED"
    domain: "documentai.googleapis.com"
  }
}

잘못된 가져오기 구성

가져오기 구성이 잘못된 경우

message: "The import config is invalid: foo"
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "INVALID_IMPORT_CONFIG"
    domain: "documentai.googleapis.com"
  }
}

소스 프로세서 버전이 잘못됨

프로세서 버전을 가져오려고 할 때 소스 프로세서 버전이 가져오기에 유효하지 않습니다.

message: "The source processor version is invalid in import processor version."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "INVALID_SOURCE_PROCESSOR_VERSION_ERROR"
    domain: "documentai.googleapis.com"
  }
}

실패함 전제조건

해결하려면 오류 메시지에 설명된 대로 몇 가지 단계를 실행해야 합니다.

KMS 키가 잘못됨

잘못된 키 (예: 사용 중지된 키)가 제공된 경우

message: "KMS key 'projects/1/keys/abc' is invalid (KEY_DISABLED)."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "KMS_KEY_INVALID"
    domain: "documentai.googleapis.com"
    metadata { key: "details" value: "KEY_DISABLED" }
    metadata { key: "kms_key_name" value: "projects/1/keys/abc" }
  }
}

프로세서 상태 변경

프로세서의 상태를 변경하기 위한 잘못된 요청이 제출된 경우

message: "Processor state cannot be changed to 'DISABLED' since it is 'DISABLED'."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "PROCESSOR_STATE_CHANGE_INVALID"
    domain: "documentai.googleapis.com"
    metadata { key: "current_state" value: "DISABLED" }
    metadata { key: "processor_id" value: "xyz" }
    metadata { key: "target_state" value: "DISABLED" }
  }
}

프로세서 버전 상태 변경

프로세서 버전의 상태를 변경하는 잘못된 요청이 제출된 경우

message: "ProcessorVersion state cannot be changed to 'DEPLOYING' since it is 'DEPLOYED'."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "PROCESSOR_VERSION_STATE_CHANGE_INVALID"
    domain: "documentai.googleapis.com"
    metadata { key: "current_state" value: "DEPLOYED" }
    metadata { key: "processor_id" value: "abc" }
    metadata { key: "target_state" value: "DEPLOYING" }
    metadata { key: "version_id" value: "xyz" }
  }
}

프로세서가 사용 설정되지 않음

특정 프로세서에 종속된 요청이 실행되었지만 프로세서가 사용 설정되지 않은 경우

message: "Processor 'xyz' is not enabled."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "PROCESSOR_NOT_ENABLED"
    domain: "documentai.googleapis.com"
    metadata { key: "processor_id" value: "xyz" }
    metadata { key: "state" value: "DISABLED" }
  }
}

프로세서 버전이 배포되지 않음

배포 중인 특정 프로세서 버전에 종속된 요청이 발행되었지만 프로세서가 배포되지 않은 경우

message: "ProcessorVersion 'abc' is not deployed."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "PROCESSOR_VERSION_NOT_DEPLOYED"
    domain: "documentai.googleapis.com"
    metadata { key: "processor_id" value: "xyz" }
    metadata { key: "state" value: "TRAINING" }
    metadata { key: "version_id" value: "abc" }
  }
}

프로세서 기본 버전

구성 중인 기본 버전에 종속된 요청이 발행되었지만 구성된 버전이 없는 경우

message: "Processor 'xyz' does not have a default version configured."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "PROCESSOR_DEFAULT_VERSION_UNSET"
    domain: "documentai.googleapis.com"
    metadata { key: "processor_id" value: "xyz" }
  }
}

프로세서에서 기본 버전 삭제

프로세서 버전 배포 취소 또는 삭제 요청이 제출되었지만 기본 버전으로 구성된 경우

message: "ProcessorVersion 'xyz' cannot be undeployed or deleted as it is the default version."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "PROCESSOR_REMOVE_DEFAULT_VERSION"
    domain: "documentai.googleapis.com"
    metadata { key: "processor_id" value: "abc" }
    metadata { key: "version_id" value: "xyz" }
  }
}

데이터 세트가 초기화되지 않음

데이터 세트를 초기화해야 하는 요청이 실행되었지만 데이터 세트가 초기화되지 않은 경우

message: "Dataset is not initialized."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "DATASET_NOT_INITIALIZED"
    domain: "documentai.googleapis.com"
  }
}

데이터 세트가 초기화되었거나 초기화 중입니다.

데이터 세트를 초기화하지 않아야 하는 요청이 실행되었지만 데이터 세트가 이미 초기화되었거나 초기화 중인 경우

message: "Dataset is already initialized or is initializing."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "DATASET_INITIALIZED_OR_INITIALIZING"
    domain: "documentai.googleapis.com"
  }
}

데이터 세트 위치가 비어 있지 않음 오류

요청에 데이터 세트 저장소 위치가 비어 있어야 하지만 폴더에 객체가 포함된 경우

message: "Given dataset location is not empty. Please select an empty folder."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "DATASET_LOCATION_NOT_EMPTY"
    domain: "documentai.googleapis.com"
  }
}

차단 작업 오류가 있음

필요한 작업을 차단하는 다른 작업이 실행 중인 경우

message: "The operation cannot be performed due to an ongoing 'EXAMPLE_OPERATION_TYPE' blocking operation. Try again after the operation finishes."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "HAS_BLOCKING_OPERATION_ERROR"
    domain: "documentai.googleapis.com"
  }
}

페이지 범위가 지원되지 않는 오류

일괄 프로세스와 같이 일부 작업에서 page_range 필드가 지원되지 않는 경우

message: "Page range is not supported."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "PAGE_RANGE_UNSUPPORTED"
    domain: "documentai.googleapis.com"
  }
}

Cloud Storage 폴더에 데이터 세트 오류가 포함됨

Cloud Storage 폴더에 이미 데이터 세트가 포함되어 있는 경우

message:  "The folder 'folder_uri' already has dataset 'dataset-id' under it."
details {
   [type.googleapis.com/google.rpc.ErrorInfo] {
     reason: "GCS_FOLDER_CONTAINS_DATASET_ERROR"
     domain: "documentai.googleapis.com"
   }
}

썸네일 없음 오류

데이터 세트 문서 썸네일을 가져올 수 없는 경우

message:  "Failed to get dataset document thumbnail, consider running re-sync on the dataset."
details {
   [type.googleapis.com/google.rpc.ErrorInfo] {
     reason: "THUMBNAIL_MISSING"
     domain: "documentai.googleapis.com"
   }
}

데이터 세트 페이지 한도 초과

데이터 세트의 총 페이지 한도가 초과된 경우

message: "Dataset page count exceeds the limit of 5. Got 6."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "DATASET_PAGE_LIMIT_EXCEEDED"
    domain: "documentai.googleapis.com"
  }
}

찾을 수 없음

해결하려면 오류 메시지에 설명된 대로 몇 가지 단계를 실행해야 합니다.

평가를 찾을 수 없음

프로세서 버전의 평가를 찾을 수 없는 경우

message: "Evaluation with ID 'qrs' not found."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "EVALUATION_NOT_FOUND"
    domain: "documentai.googleapis.com"
    metadata { key: "evaluation_id" value: "qrs" }
    metadata { key: "processor_id" value: "xyz" }
    metadata { key: "version_id" value: "abc" }
  }
}

문서를 찾을 수 없음

작업에 필요한 문서를 찾을 수 없는 경우

message: "Document not found: 'gs://foo'."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "DOCUMENT_NOT_FOUND"
    domain: "documentai.googleapis.com"
    metadata { key: "document" value: "gs://foo" }
  }
}

프로세서를 찾을 수 없음

작업에 필요한 프로세서를 찾을 수 없는 경우

message: "Processor with id 'xyz' not found."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "PROCESSOR_NOT_FOUND"
    domain: "documentai.googleapis.com"
    metadata { key: "processor_id" value: "xyz" }
  }
}

프로세서 버전을 찾을 수 없음

작업에 필요한 프로세서 버전을 찾을 수 없는 경우

message: "ProcessorVersion with id 'abc' not found."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "PROCESSOR_VERSION_NOT_FOUND"
    domain: "documentai.googleapis.com"
    metadata { key: "processor_id" value: "xyz" }
    metadata { key: "version_id" value: "abc" }
  }
}

데이터 라벨링 작업을 찾을 수 없음

데이터 라벨링 작업을 찾을 수 없는 경우

message: "Data labeling job with id 'EXAMPLE_DATA_LABELING_JOB' not found in processor EXAMPLE_PROCESSOR."

이미 존재함

해결하려면 오류 메시지에 설명된 대로 몇 가지 단계를 실행해야 합니다.

인간 참여형 라벨러가 이미 존재함

이미 존재하는 라벨러 풀을 만들 때

message: "The labeler pool already exists."

할당량 및 한도

해결하려면 오류 메시지에 설명된 대로 몇 가지 단계를 실행해야 합니다.

할당량 초과

다음과 같은 메시지가 표시될 경우:

RESOURCE_EXHAUSTED: Quota exceeded.

분당 또는 일일 할당량 한도에 도달했습니다. Document AI 사용에 대한 할당량 및 한도를 검토하세요.

Google Cloud Console에서 할당량 상향 조정을 요청할 수 있습니다.

서비스 중단 및 지연 시간

해결하려면 오류 메시지에 설명된 대로 몇 가지 단계를 실행해야 합니다.

제한 시간

지정된 시간 제한 내에 작업이 완료되지 않았습니다.

장기 실행 작업(LRO)을 폴링할 때 다음과 유사한 오류 메시지가 표시되면

google.api_core.future.polling._OperationNotComplete
...
google.api_core.exceptions.RetryError: Deadline of 0.0s exceeded while calling target function, last exception:
...
concurrent.futures._base.TimeoutError: Operation did not complete within the designated timeout.

그러면 작업 완료에 대한 사용자 설정 제한 시간 값이 처리 중인 문서에 비해 너무 낮게 설정됩니다. 이 오류는 일괄 프로세스 작업이 실패했음을 나타내지 않습니다. 작업은 사용자가 설정한 시간 제한 값과 관계없이 계속됩니다.

이전
지원 받기
다음
지원 중단