Fehlermeldungen
Hier erfahren Sie, wie Sie einige durch Document AI verursachte Fehler beheben können. In diesem Thema werden Fehler beschrieben, deren Lösung mehr Schritte erfordert, als in einer Fehlermeldung beschrieben werden können.
In der Cloud API-Dokumentation finden Sie empfohlene Verfahren zur Fehlerbehandlung.
Berechtigungen
Zur Behebung des Problems sind einige Schritte erforderlich, die in der Fehlermeldung beschrieben werden.
Standardanmeldedaten für Anwendungen sind nicht verfügbar
Sie erhalten diese Meldung:
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 verwendet für die Authentifizierung die Standardanmeldedaten für Anwendungen.
Sie müssen ein Dienstkonto für Ihr Projekt haben, den Schlüssel (die JSON-Datei) für das Dienstkonto in die Entwicklungsumgebung herunterladen und dann als Speicherort dieser JSON-Datei eine Umgebungsvariable mit dem Namen GOOGLE_APPLICATION_CREDENTIALS
festlegen.
Darüber hinaus muss die Umgebungsvariable GOOGLE_APPLICATION_CREDENTIALS
in dem Kontext verfügbar sein, in dem Sie die Document AI API aufrufen. Wenn Sie beispielsweise die Variable in einer Terminalsitzung festlegen, Ihren Code jedoch im Debugger Ihrer IDE ausführen, hat der Ausführungskontext Ihres Codes möglicherweise keinen Zugriff auf die Variable. In diesem Fall kann Ihre Anfrage an Document AI fehlschlagen, weil keine ordnungsgemäße Authentifizierung erfolgt.
Weitere Informationen dazu, wie Sie die Umgebungsvariable GOOGLE_APPLICATION_CREDENTIALS
festlegen, finden Sie in der Document AI-Schnellstartanleitung oder in der Dokumentation zur Verwendung der Standardanmeldedaten für Anwendungen.
Berechtigung verweigert
Sie erhalten diese Meldung:
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" } }
Bestätigen Sie, dass Sie eine gültige Dienstkonto-JSON-Datei an dem in der Umgebungsvariable GOOGLE_APPLICATION_CREDENTIALS
gespeicherten Ort haben und dass die Variable auf den richtigen Ort verweist.
Zur Diagnose dieses Fehlers öffnen Sie die Dienstkontoschlüsseldatei in dem Ordner, aus dem Sie die Document AI API aufrufen möchten.
cat $GOOGLE_APPLICATION_CREDENTIALS
Unzulässig: 403 POST API wurde nicht verwendet oder wurde deaktiviert
Sie erhalten die Meldung:
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.
- Rufen Sie den in der Fehlermeldung angegebenen Link auf und aktivieren Sie die Document AI API. Warten Sie einige Minuten und versuchen Sie es dann noch einmal.
- Prüfen Sie, ob Sie eine gültige JSON-Datei für den Dienstkontoschlüssel in der Umgebungsvariablen
GOOGLE_APPLICATION_CREDENTIALS
gespeichert haben. Zur Diagnose dieses Fehlers öffnen Sie die Dienstkontoschlüsseldatei in dem Ordner, aus dem Sie die Document AI API aufrufen möchten.cat $GOOGLE_APPLICATION_CREDENTIALS
Fehler beim Schreiben der endgültigen Ausgabe
Wenn Sie beim Empfang der Ergebnisse einer Batchverarbeitungsanfrage eine Meldung wie die folgende erhalten:
{ "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" } }
Ihr Dienstkonto hat möglicherweise nicht die richtigen Berechtigungen zum Erstellen von Objekten in Ihrem Cloud Storage-Bucket. Achten Sie darauf, dass Sie Ihrem Dienstkonto die richtigen Berechtigungen zugewiesen haben, wie in der Kurzanleitung beschrieben.
Möglicherweise haben Sie auch den Namen Ihres Cloud Storage-Buckets falsch geschrieben. Prüfen Sie, ob der Bucket, auf den Sie zugreifen möchten, vorhanden ist.
P4SA kein Zugriff auf Cloud Storage
Wenn das produktspezifische Dienstkonto (P4SA) von Document AI keine Berechtigung für den Zugriff auf einige Cloud Storage-Ressourcen hat.
message: Cloud DocumentAI P4SA doesn't have access to this Cloud Storage resource:
Dienstkonto kann kein Objekt in Cloud Storage erstellen
Wenn das produktspezifische Dienstkonto von Document AI (P4SA) keine Berechtigung zum Erstellen von Objekten in Cloud Storage hat.
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.
Das Dienstkonto für Document AI hat möglicherweise nicht die richtigen Berechtigungen zum Erstellen von Objekten in Ihrem Cloud Storage-Bucket. Achten Sie darauf, dem Document AI-Dienstkonto die richtigen Berechtigungen zuzuweisen, wie in der Einrichtung des projektübergreifenden Dateizugriffs beschrieben.
Möglicherweise haben Sie auch den Namen Ihres Cloud Storage-Buckets falsch geschrieben. Prüfen Sie, ob der Bucket, auf den Sie zugreifen möchten, vorhanden ist.
Der Aufrufer kann keine Objekte in Cloud Storage abrufen
Wenn der Aufrufer der Document AI API keine Berechtigung zum Abrufen von Objekten in Cloud Storage hat.
message: The caller does not have permission storage.objects.get to get Google
Cloud Storage objects in bucket gs://foo.
Der Aufrufer der API hat möglicherweise nicht die richtigen Berechtigungen, um Objekte in Ihrem Cloud Storage-Bucket abzurufen. Achten Sie darauf, dass Sie dem Anrufer die richtigen Berechtigungen zugewiesen haben.
Möglicherweise haben Sie auch den Namen Ihres Cloud Storage-Buckets falsch geschrieben. Prüfen Sie, ob der Bucket, auf den Sie zugreifen möchten, vorhanden ist.
Ungültige Argumente
Zur Behebung des Problems sind einige Schritte erforderlich, die in der Fehlermeldung beschrieben werden.
Nicht unterstützte API-Version
Beispiel: Wenn eine Anfrage an eine API-Version gesendet wird, die den Vorgang nicht unterstützt.
message: "The requested operation is unsupported for the API version."
Bad Request (Fehlerhafte Anfrage)
Wenn eine API-Anfrage gestellt wird, die Anfragefelder aber einen oder mehrere Verstöße aufweisen.
Jeder Verstoß wird in den google.rpc.BadRequest
-Details als field_violations
erfasst.
message: "Request contains an invalid argument."
details {
[type.googleapis.com/google.rpc.BadRequest] {
field_violations { field: "foo" description: "bar" }
}
}
Batchverarbeitung aller Dokumente fehlgeschlagen
Wenn die Verarbeitung aller Dokumente in einer Batchverarbeitungsanfrage fehlschlägt.
message: "Failed to process all documents."
details {
[type.googleapis.com/google.rpc.ErrorInfo] {
reason: "FAILED_TO_PROCESS_ALL_DOCUMENTS"
domain: "documentai.googleapis.com"
}
}
Keine Dokumente
Wenn Dokumente erforderlich oder zu erwarten sind, aber keine bereitgestellt werden, z. B. beim Importieren von Dokumenten über einen 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"
}
}
Die Parameter gcsUriPrefix
und gcsOutputConfig.gcsUri
müssen mit gs://
beginnen und mit einem umgekehrten Schrägstrich (/
) enden. Prüfen Sie die Konfiguration der Bucket-URIs.
Beispiel: gs://bucket/directory/
Training wird nicht unterstützt
Wenn eine Anfrage für eine trainierte Prozessorversion für einen Prozessortyp gestellt wird, der das Training nicht unterstützt.
message: "Training is not supported on processor type: ${DOCUMENT_TYPE}_PROCESSOR."
Keine Dokumente ausgewählt
Wenn Dokumente erwartet werden, im Dataset aber keine ausgewählt sind, z. B. beim Erstellen von Jobs zur Datenbeschriftung.
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"
}
}
Dokumenttyp nicht gefunden
Wenn die Klasse eines Dokuments (z. B. Führerschein, Reisepass oder Rechnung) nicht der für den Zahlungsabwickler erforderlichen Klassifizierung entspricht. Ein Beispiel ist, wenn der Klassifizierungsschritt im W2-Parser keine Elemente aus einer Rechnung findet.
In der Google Cloud Console wird diese Option möglicherweise auch als Couldn't preview the document: Unable to find a document of type: 'foo'
angezeigt.
Diese Fehlermeldung gilt für ältere Prozessoren.
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"
}
}
Maximale Dokumentgröße überschritten
Wenn beim Importieren des Datensatzes oder Ausführen der Vorhersage die Obergrenze für die Dateigröße eines Dokuments überschritten wurde.
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" }
}
}
Dokumentlimit überschritten
Wenn die Obergrenze für die Anzahl der Dokumente überschritten wurde.
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" }
}
}
Nicht unterstützter MIME-Typ
Wenn ein nicht unterstützter MIME-Typ angegeben wurde. Das System prüft das Dateiformat (MIME-Typ), wenn Sie einen Datensatz importieren und eine Vorhersage aufrufen. Wenn das Dateiformat nicht unterstützt wird, wird die folgende Fehlermeldung angezeigt:
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" }
}
}
Falscher MIME-Typ für das Dokument
Wenn der Inhalt des Dokuments nicht mit dem angegebenen MIME-Typ übereinstimmt. Das System überprüft das Dateiformat (MIME-Typ), wenn Sie einen Datensatz importieren und einen Vorhersageaufruf ausführen. Wenn das von Ihnen angegebene Dateiformat nicht dem erwarteten Format entspricht, wird die folgende Fehlermeldung angezeigt:
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" }
}
}
Keine Seiten
Wenn ein Dokument ohne Seiten eingereicht wurde, aber eine oder mehrere Seiten erforderlich sind.
message: "No pages were found in the document."
details {
[type.googleapis.com/google.rpc.ErrorInfo] {
reason: "NO_PAGES"
domain: "documentai.googleapis.com"
}
}
Negative Seitenzahl
Wenn in einem Dokument für eine Seitenzahl ein negativer Wert angegeben ist.
message: "Page number cannot be negative."
details {
[type.googleapis.com/google.rpc.ErrorInfo] {
reason: "NEGATIVE_PAGE_NUMBER"
domain: "documentai.googleapis.com"
}
}
Doppelte Seitennummern
Wenn in einem Dokument dieselbe Seitenzahl mehrmals aufgeführt ist.
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]}]"
}
}
}
Seitenlimit überschritten
Wenn die Obergrenze der Gesamtzahl der Seiten eines Dokuments überschritten wird. Dieser Fehler tritt beim Importieren oder bei der Vorhersage von Datasets auf, wenn ein Dokument im Dataset zu viele Seiten hat und die Limits des Prozessors überschreitet.
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" }
}
}
Statusänderung der Version des vortrainierten Prozessors
Wenn eine Anfrage zum Ändern des Status einer vorab trainierten Prozessorversion gesendet wurde. Dieser Fehler tritt auf, wenn Sie versuchen, eine vorab trainierte Prozessorversion zu löschen.
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" }
}
}
Dataset-Validierung
Wenn ein Datensatz die Validierungskriterien nicht erfüllt, z. B. aufgrund fehlender Seitenanker, falscher Daten oder unvollständiger Details in einigen Attributen des Dokument-Proto-Objekts.
message: "Invalid dataset. See operation metadata for specific errors."
details {
[type.googleapis.com/google.rpc.ErrorInfo] {
reason: "INVALID_DATASET"
domain: "documentai.googleapis.com"
}
}
Nicht eingeblendetes Human in the Loop-Dokument zur Überprüfung
Wenn eine manuelle Überprüfung für ein Dokument gestartet wurde, das nicht inline definiert wurde.
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"
}
}
Ungültiger Dokumenttyp
Wenn auf ein Dokument mit einem nicht unterstützten oder fehlerhaften Dateiformat verwiesen wird, z. B. .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" }
}
}
Dokument geht über das zulässige Format hinaus
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" }
}
}
Ungültiger Dokumentbereich
Wenn eine ungültige Dokumentspanne angegeben ist, z. B. wenn der Anfang nach dem Ende liegt.
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" }
}
}
Ungültiges UTF-8-Dokument
Wenn ein Dokument mit ungültigem UTF-8 bereitgestellt wird.
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)" }
}
}
Dataset-Schema ungültig
Wenn ein Prozessor kein gültiges Union-Schema hat oder das angegebene Dataset-Schema nicht gültig ist.
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 nicht unterstützt
Wenn eine Verarbeitungsanfrage für einen Prozessor gestellt wird, der OcrConfig nicht unterstützt.
message: "OcrConfig is not supported for processor type: 'foo'."
details {
[type.googleapis.com/google.rpc.ErrorInfo] {
reason: "OCR_CONFIG_UNSUPPORTED"
domain: "documentai.googleapis.com"
}
}
Ungültige Importkonfiguration
Wenn die Importkonfiguration ungültig ist.
message: "The import config is invalid: foo"
details {
[type.googleapis.com/google.rpc.ErrorInfo] {
reason: "INVALID_IMPORT_CONFIG"
domain: "documentai.googleapis.com"
}
}
Ungültige Quellprozessorversion
Beim Importieren einer Prozessorversion ist die Quellprozessorversion ungültig.
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"
}
}
Nicht erfüllte Voraussetzung
Zur Behebung des Problems sind einige Schritte erforderlich, die in der Fehlermeldung beschrieben werden.
Ungültiger KMS-Schlüssel
Wenn ein ungültiger Schlüssel angegeben wurde (z.B. deaktiviert).
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" }
}
}
Änderung des Prozessorstatus
Wenn eine ungültige Anfrage zum Ändern des Status eines Prozessors gestellt wird.
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" }
}
}
Änderung des Status der Prozessorversion
Wenn eine ungültige Anfrage zum Ändern des Status einer Prozessorversion gestellt wird.
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" }
}
}
Prozessor nicht aktiviert
Wenn eine Anfrage gestellt wird, die von einem bestimmten Prozessor abhängt, dieser Prozessor aber nicht aktiviert ist.
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" }
}
}
Prozessorversion nicht bereitgestellt
Wenn eine Anfrage gestellt wird, die von der Bereitstellung einer bestimmten Prozessorversion abhängt, der Prozessor aber nicht bereitgestellt wird.
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" }
}
}
Prozessorstandardversion
Wenn eine Anfrage gestellt wird, die von einer konfigurierten Standardversion abhängt, aber keine konfiguriert ist.
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" }
}
}
Prozessor – Standardversion entfernen
Wenn eine Anfrage zum Aufheben der Bereitstellung oder zum Löschen einer Prozessorversion gesendet wird, sie aber als Standardversion konfiguriert ist.
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" }
}
}
Dataset nicht initialisiert
Wenn eine Anfrage gestellt wird, für die ein Dataset initialisiert werden muss, das Dataset aber nicht initialisiert wurde.
message: "Dataset is not initialized."
details {
[type.googleapis.com/google.rpc.ErrorInfo] {
reason: "DATASET_NOT_INITIALIZED"
domain: "documentai.googleapis.com"
}
}
Dataset wurde initialisiert oder wird gerade initialisiert
Wenn eine Anfrage gestellt wird, für die ein Dataset nicht initialisiert sein darf, das Dataset aber bereits initialisiert wurde oder gerade initialisiert wird.
message: "Dataset is already initialized or is initializing."
details {
[type.googleapis.com/google.rpc.ErrorInfo] {
reason: "DATASET_INITIALIZED_OR_INITIALIZING"
domain: "documentai.googleapis.com"
}
}
Fehler: Dataset-Speicherort nicht leer
Wenn für eine Anfrage der Speicherort eines Datensatzes leer sein muss, der Ordner aber Objekte enthält.
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"
}
}
Fehler beim Blockieren aufgetreten
Wenn andere Vorgänge ausgeführt werden, die den erforderlichen Vorgang blockieren.
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"
}
}
Fehler: Seitenbereich wird nicht unterstützt
Wenn das Feld page_range
bei einem Vorgang nicht unterstützt wird, z. B. bei einem Batchprozess.
message: "Page range is not supported."
details {
[type.googleapis.com/google.rpc.ErrorInfo] {
reason: "PAGE_RANGE_UNSUPPORTED"
domain: "documentai.googleapis.com"
}
}
Cloud Storage-Ordner enthält Dataset-Fehler
Wenn ein Cloud Storage-Ordner bereits ein Dataset enthält.
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"
}
}
Fehler: Miniaturansicht fehlt
Wenn das Thumbnail eines Datensatzdokuments nicht abgerufen werden kann.
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"
}
}
Limit für Datensatzseiten überschritten
Wenn das Gesamtlimit für Seiten eines Datensatzes überschritten wurde.
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"
}
}
Nicht gefunden
Zur Behebung des Problems sind einige Schritte erforderlich, die in der Fehlermeldung beschrieben werden.
Bewertung nicht gefunden
Wenn keine Bewertung für eine Prozessorversion gefunden werden kann.
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" }
}
}
Dokument nicht gefunden
Wenn ein für einen Vorgang erforderliches Dokument nicht gefunden werden kann.
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" }
}
}
Prozessor nicht gefunden
Wenn ein für einen Vorgang erforderlicher Prozessor nicht gefunden werden kann.
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" }
}
}
Prozessorversion nicht gefunden
Wenn eine für einen Vorgang erforderliche Prozessorversion nicht gefunden werden kann.
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" }
}
}
Job zum Hinzufügen von Labels zu Daten nicht gefunden
Wenn ein Daten-Labeling-Job nicht gefunden werden kann.
message: "Data labeling job with id 'EXAMPLE_DATA_LABELING_JOB' not found in processor EXAMPLE_PROCESSOR."
Bereits vorhanden
Zur Behebung des Problems sind einige Schritte erforderlich, die in der Fehlermeldung beschrieben werden.
Human in the Loop-Labeler ist bereits vorhanden
Beim Erstellen eines Labeler-Pools, der bereits vorhanden ist.
message: "The labeler pool already exists."
Kontingente und Limits
Zur Behebung des Problems sind einige Schritte erforderlich, die in der Fehlermeldung beschrieben werden.
Kontingent überschritten
Sie erhalten diese Meldung:
RESOURCE_EXHAUSTED: Quota exceeded.
Sie haben das Limit Ihres Minuten- oder Tageskontingents erreicht. Sehen Sie sich die Kontingente und Limits für die Verwendung von Document AI an.
Sie können über die Google Cloud Console eine Erhöhung Ihrer Kontingente beantragen.
Ausfälle und Latenz
Zur Behebung des Problems sind einige Schritte erforderlich, die in der Fehlermeldung beschrieben werden.
Zeitlimits
- Bei der Onlineverarbeitung gibt es eine serverseitige Zeitüberschreitung von zwei Minuten für Anfragen.
- Für die Batchverarbeitung gibt es ein serverseitiges Zeitlimit von 2 Minuten für die Generierung des Vorgangs mit langer Ausführungszeit, aber kein Zeitlimit für den Abschluss des Batchjobs.
- Weitere Informationen finden Sie in der Dokumentation zu Vorgängen mit langer Laufzeit.
Der Vorgang wurde nicht innerhalb des angegebenen Zeitlimits abgeschlossen.
Wenn Sie beim Abfragen eines Vorgangs mit langer Ausführungszeit die folgende (oder eine ähnliche) Fehlermeldung erhalten:
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.
In diesem Fall ist das vom Nutzer festgelegte Zeitlimit für den Abschluss des Vorgangs für das verarbeitete Dokument zu niedrig. Dieser Fehler weist nicht darauf hin, dass der Batchprozess fehlgeschlagen ist. Der Vorgang wird unabhängig vom vom Nutzer festgelegten Zeitüberschreitungswert fortgesetzt.