Pesan error
Pelajari cara menyelesaikan beberapa error yang dilaporkan oleh Dokumentasi AI. Topik ini membahas error yang penyelesaiannya memerlukan lebih banyak langkah daripada yang dapat dijelaskan dalam pesan error.
Lihat dokumentasi Cloud API untuk praktik penanganan error yang direkomendasikan.
Izin
Penyelesaiannya memerlukan beberapa langkah yang harus dilakukan seperti yang diuraikan dalam pesan error.
Kredensial default aplikasi tidak tersedia
Jika Anda menerima pesan ini:
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 menggunakan Kredensial Default Aplikasi untuk autentikasi.
Anda harus memiliki akun layanan untuk project Anda, download kunci (file JSON) untuk akun layanan ke lingkungan pengembangan Anda, lalu tetapkan lokasi file JSON tersebut ke variabel lingkungan bernamaGOOGLE_APPLICATION_CREDENTIALS
.
Selain itu, variabel lingkungan GOOGLE_APPLICATION_CREDENTIALS
harus tersedia dalam konteks di mana Anda memanggil Document AI API. Misalnya, jika Anda menetapkan variabel dari dalam sesi terminal, tetapi menjalankan kode di debugger IDE, konteks eksekusi kode Anda mungkin tidak memiliki akses ke variabel tersebut. Dalam situasi tersebut, permintaan Anda ke Document AI mungkin gagal karena tidak memiliki autentikasi yang tepat.
Untuk mengetahui informasi selengkapnya tentang cara menetapkan variabel lingkungan GOOGLE_APPLICATION_CREDENTIALS
, lihat panduan memulai Document AI atau dokumentasi tentang menggunakan Kredensial Default Aplikasi.
Izin ditolak
Jika Anda menerima pesan ini:
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" } }
Pastikan Anda memiliki file JSON kunci akun layanan yang valid di lokasi yang disimpan dalam variabel lingkungan GOOGLE_APPLICATION_CREDENTIALS
dan bahwa variabel tersebut menunjuk ke tempat yang benar.
Untuk mendiagnosis error ini, coba buka file kunci akun layanan dari folder tempat Anda mencoba memanggil Document AI API.
cat $GOOGLE_APPLICATION_CREDENTIALS
Forbidden: 403 POST API belum digunakan atau dinonaktifkan
Jika Anda menerima pesan ini:
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.
- Buka link yang ditentukan dalam pesan error dan aktifkan Document AI API. Tunggu beberapa menit, lalu coba lagi.
- Pastikan Anda memiliki file JSON kunci akun layanan valid yang tersimpan di variabel lingkungan
GOOGLE_APPLICATION_CREDENTIALS
. Untuk mendiagnosis error ini, coba buka file kunci akun layanan dari folder tempat Anda mencoba memanggil Document AI API.cat $GOOGLE_APPLICATION_CREDENTIALS
Terjadi error saat menulis output akhir
Jika Anda menerima pesan seperti berikut saat menerima hasil permintaan pemrosesan batch:
{ "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" } }
Akun layanan Anda mungkin tidak memiliki izin yang benar untuk membuat objek di bucket Cloud Storage. Pastikan Anda telah menetapkan izin yang benar ke akun layanan, seperti yang dijelaskan dalam panduan memulai.
Anda mungkin juga salah mengeja nama bucket Cloud Storage Anda. Pastikan bucket yang Anda coba akses ada.
P4SA tidak memiliki akses ke Cloud Storage
Jika Akun Layanan Per Produk (P4SA) Document AI tidak memiliki izin untuk mengakses beberapa resource Cloud Storage.
message: Cloud DocumentAI P4SA doesn't have access to this Cloud Storage resource:
Akun Layanan tidak dapat membuat objek di Cloud Storage
Jika Akun Layanan Per Produk (P4SA) Document AI tidak memiliki izin untuk membuat objek di 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.
Akun layanan Document AI mungkin tidak memiliki izin yang benar untuk membuat objek di bucket Cloud Storage Anda. Pastikan Anda telah menetapkan izin yang benar ke akun layanan Document AI, seperti yang dijelaskan dalam penyiapan akses file lintas project.
Anda mungkin juga salah mengeja nama bucket Cloud Storage Anda. Pastikan bucket yang Anda coba akses ada.
Pemanggil tidak dapat mendapatkan objek di Cloud Storage
Jika pemanggil Document AI API tidak memiliki izin untuk mendapatkan objek di Cloud Storage.
message: The caller does not have permission storage.objects.get to get Google
Cloud Storage objects in bucket gs://foo.
Pemanggil API mungkin tidak memiliki izin yang benar untuk mendapatkan objek di bucket Cloud Storage Anda. Pastikan Anda telah menetapkan izin yang benar kepada pemanggil.
Anda mungkin juga salah mengeja nama bucket Cloud Storage Anda. Pastikan bucket yang Anda coba akses ada.
Argumen tidak valid
Penyelesaiannya memerlukan beberapa langkah yang harus dilakukan seperti yang diuraikan dalam pesan error.
Versi API tidak didukung
Contoh: saat permintaan dibuat ke versi API yang tidak mendukung operasi.
message: "The requested operation is unsupported for the API version."
Permintaan Tidak Valid
Saat permintaan API dibuat, tetapi kolom permintaan memiliki satu atau beberapa pelanggaran.
Setiap pelanggaran dicatat sebagai field_violations
dalam detail
google.rpc.BadRequest
.
message: "Request contains an invalid argument."
details {
[type.googleapis.com/google.rpc.BadRequest] {
field_violations { field: "foo" description: "bar" }
}
}
Pemrosesan batch semua dokumen gagal
Jika setiap dokumen dalam permintaan pemrosesan batch gagal diproses.
message: "Failed to process all documents."
details {
[type.googleapis.com/google.rpc.ErrorInfo] {
reason: "FAILED_TO_PROCESS_ALL_DOCUMENTS"
domain: "documentai.googleapis.com"
}
}
Tidak ada dokumen
Jika dokumen diperlukan atau diharapkan, tetapi tidak ada yang diberikan, seperti saat mengimpor dokumen dengan URI Cloud Storage.
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"
}
}
Parameter gcsUriPrefix
dan gcsOutputConfig.gcsUri
harus diawali dengan gs://
dan diakhiri dengan karakter garis miring terbalik di akhir (/
). Periksa konfigurasi untuk URI bucket.
Contoh: gs://bucket/directory/
Pelatihan tidak didukung
Saat permintaan versi pemroses pelatihan dibuat pada jenis pemroses yang tidak mendukung pelatihan.
message: "Training is not supported on processor type: ${DOCUMENT_TYPE}_PROCESSOR."
Tidak ada dokumen yang dipilih
Jika dokumen diharapkan, tetapi tidak ada yang dipilih dalam set data, seperti saat membuat tugas pemberian label data.
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"
}
}
Jenis dokumen tidak ditemukan
Jika class dokumen (seperti lisensi, paspor, atau invoice) tidak cocok dengan klasifikasi yang diperlukan untuk jenis pemroses. Contohnya adalah saat langkah pengklasifikasi dalam parser W2 tidak menemukan elemen dari invoice.
Ini juga dapat muncul sebagai Couldn't preview the document: Unable to find a document of type: 'foo'
di konsol Google Cloud.
Pesan error ini berlaku untuk prosesor lama.
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"
}
}
Batas ukuran dokumen terlampaui
Jika batas atas untuk ukuran file dokumen telah terlampaui saat mengimpor set data atau saat menjalankan prediksi.
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" }
}
}
Batas dokumen terlampaui
Jika batas atas untuk jumlah dokumen telah terlampaui.
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" }
}
}
Jenis MIME tidak didukung
Saat jenis MIME yang tidak didukung diberikan. Sistem memverifikasi format file (jenis MIME) saat Anda mengimpor set data dan saat Anda melakukan panggilan prediksi. Jika format file tidak didukung, Anda akan melihat pesan error berikut:
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" }
}
}
Jenis MIME dokumen salah
Jika konten dokumen tidak cocok dengan jenis MIME yang ditentukan. Sistem memverifikasi format file (jenis MIME) saat Anda mengimpor set data dan saat Anda melakukan panggilan prediksi. Jika format file yang Anda berikan tidak cocok dengan format yang diharapkan, Anda akan melihat pesan error berikut:
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" }
}
}
Tidak ada halaman
Jika dokumen tanpa halaman diberikan, tetapi satu atau beberapa halaman diperlukan.
message: "No pages were found in the document."
details {
[type.googleapis.com/google.rpc.ErrorInfo] {
reason: "NO_PAGES"
domain: "documentai.googleapis.com"
}
}
Nomor halaman negatif
Saat dokumen mencantumkan nilai negatif untuk salah satu nomor halamannya.
message: "Page number cannot be negative."
details {
[type.googleapis.com/google.rpc.ErrorInfo] {
reason: "NEGATIVE_PAGE_NUMBER"
domain: "documentai.googleapis.com"
}
}
Nomor halaman duplikat
Saat dokumen mencantumkan nomor halaman yang sama satu atau beberapa kali.
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]}]"
}
}
}
Batas halaman terlampaui
Jika batas atas jumlah total halaman dokumen terlampaui. Anda akan mengalami error ini selama impor atau prediksi set data saat dokumen dalam set data memiliki terlalu banyak halaman, melebihi batas prosesor.
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" }
}
}
Perubahan status versi pemroses terlatih
Saat permintaan untuk mengubah status versi pemroses terlatih dikeluarkan. Anda mengalami error ini saat mencoba menghapus versi pemroses terlatih.
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" }
}
}
Validasi set data
Jika set data gagal memenuhi kriteria validasi, misalnya, karena anchor halaman tidak ada, data salah, atau detail tidak lengkap di beberapa atribut objek proto dokumen.
message: "Invalid dataset. See operation metadata for specific errors."
details {
[type.googleapis.com/google.rpc.ErrorInfo] {
reason: "INVALID_DATASET"
domain: "documentai.googleapis.com"
}
}
Dokumen non-inline yang memerlukan interaksi manusia untuk ditinjau
Saat peninjauan manual dimulai untuk dokumen yang tidak ditentukan secara inline.
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"
}
}
Jenis Dokumen Tidak Valid
Saat dokumen dengan format file yang tidak didukung atau salah format dirujuk, seperti
.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" }
}
}
Rentang dokumen di luar batas
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" }
}
}
Rentang dokumen tidak valid
Saat rentang dokumen yang tidak valid, seperti awal setelah akhir, diberikan.
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" }
}
}
Dokumen UTF-8 tidak valid
Jika dokumen yang menyertakan UTF-8 yang tidak valid diberikan.
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)" }
}
}
Skema set data tidak valid
Jika pemroses tidak memiliki skema gabungan yang valid atau skema set data yang diberikan tidak valid.
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 Tidak Didukung
Saat permintaan pemrosesan dikeluarkan untuk pemroses yang tidak mendukung 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"
}
}
Konfigurasi Impor Tidak Valid
Jika konfigurasi impor tidak valid.
message: "The import config is invalid: foo"
details {
[type.googleapis.com/google.rpc.ErrorInfo] {
reason: "INVALID_IMPORT_CONFIG"
domain: "documentai.googleapis.com"
}
}
Versi pemroses sumber tidak valid
Saat mencoba mengimpor versi pemroses, versi pemroses sumber tidak valid untuk diimpor.
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"
}
}
Prasyarat yang gagal
Penyelesaiannya memerlukan beberapa langkah yang harus dilakukan seperti yang diuraikan dalam pesan error.
Kunci KMS tidak valid
Jika kunci yang tidak valid (misalnya dinonaktifkan) diberikan.
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" }
}
}
Perubahan status pemroses
Saat permintaan yang tidak valid untuk mengubah status prosesor dikeluarkan.
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" }
}
}
Perubahan status versi pemroses
Saat permintaan yang tidak valid untuk mengubah status versi prosesor dikeluarkan.
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" }
}
}
Pemroses tidak diaktifkan
Saat permintaan yang bergantung pada prosesor tertentu dikeluarkan, tetapi prosesor tidak diaktifkan.
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" }
}
}
Versi pemroses tidak di-deploy
Saat permintaan yang bergantung pada versi pemroses tertentu yang di-deploy diterbitkan, tetapi pemroses tidak di-deploy.
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" }
}
}
Versi default pemroses
Saat permintaan yang bergantung pada versi default yang sedang dikonfigurasi dikeluarkan, tetapi tidak ada yang dikonfigurasi.
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" }
}
}
Pemroses menghapus versi default
Saat permintaan untuk membatalkan deployment atau menghapus versi pemroses dikeluarkan, tetapi dikonfigurasi sebagai versi default.
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" }
}
}
Set data tidak diinisialisasi
Saat permintaan yang memerlukan inisialisasi set data dikeluarkan, tetapi set data tidak diinisialisasi.
message: "Dataset is not initialized."
details {
[type.googleapis.com/google.rpc.ErrorInfo] {
reason: "DATASET_NOT_INITIALIZED"
domain: "documentai.googleapis.com"
}
}
Set data diinisialisasi atau sedang melakukan inisialisasi
Saat permintaan yang memerlukan set data untuk tidak diinisialisasi dikeluarkan, tetapi set data sudah diinisialisasi atau sedang melakukan inisialisasi.
message: "Dataset is already initialized or is initializing."
details {
[type.googleapis.com/google.rpc.ErrorInfo] {
reason: "DATASET_INITIALIZED_OR_INITIALIZING"
domain: "documentai.googleapis.com"
}
}
Error Lokasi Set Data Tidak Kosong
Saat permintaan mewajibkan lokasi penyimpanan set data kosong, tetapi folder berisi objek.
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"
}
}
Memiliki Error Operasi Pemblokiran
Jika ada operasi lain yang berjalan dan memblokir operasi yang diperlukan.
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"
}
}
Error rentang halaman tidak didukung
Jika kolom page_range
tidak didukung dalam beberapa operasi, seperti dalam
proses batch.
message: "Page range is not supported."
details {
[type.googleapis.com/google.rpc.ErrorInfo] {
reason: "PAGE_RANGE_UNSUPPORTED"
domain: "documentai.googleapis.com"
}
}
Folder Cloud Storage berisi error set data
Jika folder Cloud Storage sudah berisi set data.
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"
}
}
Error Thumbnail Tidak Ada
Saat thumbnail dokumen set data gagal diambil.
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"
}
}
Batas halaman set data terlampaui
Jika total batas halaman set data telah terlampaui.
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"
}
}
Tidak ditemukan
Penyelesaiannya memerlukan beberapa langkah yang harus dilakukan seperti yang diuraikan dalam pesan error.
Evaluasi tidak ditemukan
Jika evaluasi untuk versi pemroses tidak dapat ditemukan.
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" }
}
}
Dokumen tidak ditemukan
Jika dokumen yang diperlukan untuk operasi tidak dapat ditemukan.
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" }
}
}
Prosesor tidak ditemukan
Jika prosesor yang diperlukan untuk operasi tidak dapat ditemukan.
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" }
}
}
Versi pemroses tidak ditemukan
Jika versi prosesor yang diperlukan untuk operasi tidak dapat ditemukan.
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" }
}
}
Tugas Pelabelan Data Tidak Ditemukan
Jika tugas pelabelan data tidak dapat ditemukan.
message: "Data labeling job with id 'EXAMPLE_DATA_LABELING_JOB' not found in processor EXAMPLE_PROCESSOR."
Sudah Ada
Penyelesaiannya memerlukan beberapa langkah yang harus dilakukan seperti yang diuraikan dalam pesan error.
Pemberi label human in the loop sudah ada
Saat membuat kumpulan pelabel yang sudah ada.
message: "The labeler pool already exists."
Kuota dan batas
Penyelesaiannya memerlukan beberapa langkah yang harus dilakukan seperti yang diuraikan dalam pesan error.
Melebihi kuota
Jika Anda menerima pesan ini:
RESOURCE_EXHAUSTED: Quota exceeded.
Anda telah mencapai batas kuota per menit atau harian. Tinjau kuota & batas untuk menggunakan Document AI.
Anda dapat meminta penambahan kuota dari Google Cloud Platform Console.
Gangguan & Latensi
Penyelesaiannya memerlukan beberapa langkah yang harus dilakukan seperti yang diuraikan dalam pesan error.
Waktu tunggu
- Untuk Pemrosesan Online, ada waktu tunggu 2 menit sisi server untuk permintaan.
- Untuk Pemrosesan Batch, ada waktu tunggu 2 menit sisi server untuk membuat Operasi yang Berjalan Lama, tetapi tidak ada waktu tunggu untuk penyelesaian tugas batch.
- Untuk mengetahui informasi selengkapnya, lihat dokumentasi Operasi yang Berjalan Lama.
Operasi tidak selesai dalam waktu tunggu yang ditentukan.
Jika Anda menerima pesan error berikut (atau yang serupa) saat melakukan polling Operasi yang Berjalan Lama (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.
Kemudian, nilai waktu tunggu yang ditetapkan pengguna untuk menyelesaikan operasi ditetapkan terlalu rendah untuk dokumen yang sedang diproses. Error ini tidak menunjukkan bahwa operasi proses batch gagal, operasi akan berlanjut terlepas dari nilai waktu tunggu yang ditetapkan pengguna.