Fehlermeldungen

Auf dieser Seite werden häufige Fehlermeldungen erläutert, die Sie bei der Verwendung von Dataproc Metastore erhalten können. Jeder Abschnitt enthält weitere Informationen zur Bedeutung der Nachrichten und den empfohlenen Maßnahmen zum Beheben der Fehler.

Allgemeine Fehler:

  • Ungültige Clienteingaben:

    • „ResourceName-Fehlerpfad [RESOURCE_NAME] entspricht nicht der Vorlage [RESOURCE_TEMPLATE].“
    • „Ungültige Überschreibung des Warehouse-Verzeichnisses: [GCS_URI].“
    • „Das angegebene krb5.conf-Objekt krb5Config war ungültig.“

  • Ungültiger API-Ressourcenstatus:

    • „Aktueller Status der Ressource [RESOURCE_NAME] ist für diesen Vorgang nicht gültig. Gültige Statuswerte sind [RESOURCE_STATE].“
    • Sie haben versucht, einen Dataproc Metastore-Dienst zu aktualisieren, zu importieren, zu exportieren, zu sichern oder wiederherzustellen, der Dienst war jedoch nicht ACTIVE.
    • „Sicherung [BACKUP–ID] nicht bereit.“

  • API-Zugriffsberechtigung:

    • Sie hatten nicht die erforderliche Berechtigung zum Aufrufen der Dataproc Metastore APIs.

  • Unzureichende Dienst-Agent-Berechtigungen:

    • „Der Dataproc Metastore-Dienst-Agent [SERVICE_AGENT] verfügt nicht über ausreichende IAM-Berechtigungen für den Zugriff auf das Netzwerk [NETWORK]. Prüfen Sie, ob dem Dienst-Agent roles/metastore.serviceAgent im Projekt [PROJECT_NUMBER] gewährt wird.“

    • „Dataproc Metastore-Dienst-Agent kann nicht auf den Cloud Storage-URI [GCS_URI] mit den Berechtigungen [SERVICE_AGENT_PERMISSIONS] zugreifen. Prüfen Sie die Berechtigungen oder den VPC Service Controls-Dienstperimeter.“

    • „Der bereitgestellte Cloud Storage-Bucket [GCS_URI] des Warehouse-Verzeichnisses kann vom Dataproc Metastore-Dienst-Agent nicht gelesen und geschrieben werden.“

Fehler beim Import und Export:

Fehler im Zusammenhang mit Sicherung und Wiederherstellung:

Allgemeine Fehler

In diesem Abschnitt werden allgemeine Fehler erläutert.

Ungültige Clienteingaben

Dies ist ein allgemeiner Fehler, der besagt, dass ein Teil Ihrer Anfrage unabhängig vom Serverstatus ungültig war. Dieser Fehler kann durch viele verschiedene Umstände ausgelöst werden, zum Beispiel:

  • Bei der Verwendung der REST API haben Sie den Namen eines Netzwerks in einem ungültigen Format angegeben.

    ResourceName-Fehlerpfad [RESOURCE_NAME] entspricht nicht der Vorlage [RESOURCE_TEMPLATE].

  • Das Warehouse-Verzeichnis war kein gültiger Cloud Storage-Pfad. Weitere Informationen finden Sie unter Hive Metastore.

    Ungültige Überschreibung des Warehouse-Verzeichnisses: [GCS_URI].

  • Sie haben ungültige Kerberos-Konfigurationen angegeben (siehe Kerberos für einen Dienst konfigurieren).

    Das angegebene Objekt krb5.conf krb5Config war ungültig.

Empfohlene Maßnahme: Korrigieren Sie Ihre Anfrage.

Ungültiger API-Ressourcenstatus

Dies ist ein allgemeiner Fehler, der darauf hinweist, dass ein Teil Ihrer Anfrage mit dem aktuellen Status der Serverressource nicht kompatibel ist.

Aktueller Status der Ressource [RESOURCE_NAME] ist für diesen Vorgang nicht gültig. Gültige Statuswerte sind [RESOURCE_STATE].

Dies kann passieren, wenn die API-Ressource (Dataproc Metastore-Dienst, -Import, -Export, -Back-up oder -Wiederherstellung) nicht den richtigen Status hat, um die Aktion auszuführen. Beispiel:

  • Sie haben versucht, einen Dataproc Metastore-Dienst zu aktualisieren, zu importieren, zu exportieren, zu sichern oder wiederherzustellen, der Dienst war jedoch nicht ACTIVE.

  • Sie haben versucht, ein Back-up wiederherzustellen. Der Dataproc Metastore-Dienst war ACTIVE, aber das Back-up war nicht ACTIVE.

    Sicherung [BACKUP-ID] nicht bereit.

Empfohlene Maßnahme: Prüfen Sie, ob Ihre API-Ressource den richtigen Status hat, bevor Sie die Anfrage wiederholen.

API-Zugriffsberechtigung

Ihre Berechtigungen reichen zum Aufrufen der Dataproc Metastore APIs nicht aus.

Empfohlene Maßnahme: Gewähren Sie dem Nutzer die richtigen Dataproc Metastore-IAM-Berechtigungen.

Unzureichenden Berechtigungen für Dienst-Agent

Beim Erstellen von Ressourcen in Ihrem Projekt wurde ein Berechtigungsfehler empfangen. Der Fehler wird normalerweise durch ein gelöschtes Dienstkonto oder geänderte Berechtigungen für das Dienstkonto verursacht. Beispiel:

  • Sie haben ein Netzwerk verwendet, das zu einem anderen Projekt gehört, dem Dataproc Metastore-Dienst-Agent aber keine Berechtigung zum Zugriff erteilt. Weitere Informationen finden Sie unter Projektübergreifende Bereitstellung.

    Der Dataproc Metastore-Dienst-Agent [SERVICE_AGENT] verfügt nicht über ausreichende IAM-Berechtigungen für den Zugriff auf das Netzwerk [NETWORK]. Prüfen Sie, ob dem Dienst-Agent roles/metastore.serviceAgent im Projekt [PROJECT_NUMBER] gewährt wird.

  • Sie haben einen Cloud Storage-Bucket für ein benutzerdefiniertes Data Warehouse angegeben, dem Dataproc Metastore-Dienst-Agent jedoch keine Zugriffsberechtigung dafür gewährt. Weitere Informationen finden Sie im Hive-Warehouse-Verzeichnis.

    Dataproc Metastore-Dienst-Agent kann nicht auf den Cloud Storage-URI [GCS_URI] mit den Berechtigungen [SERVICE_AGENT_PERMISSIONS] zugreifen. Prüfen Sie die Berechtigungen oder den VPC Service Controls-Dienstperimeter.

Oder Dataproc Metastore konnte nicht auf den Cloud Storage-Pfad des Warehouse-Verzeichnisses zugreifen.

Der bereitgestellte Cloud Storage-Bucket [GCS_URI] des Warehouse-Verzeichnisses kann vom Dataproc Metastore-Dienst-Agent nicht gelesen und geschrieben werden.

Empfohlene Maßnahme: Prüfen Sie Ihre Dienstkontoberechtigungen oder den VPC Service Controls-Dienstperimeter.

Fehler beim Import und Export

In diesem Abschnitt werden Fehler beim Import und Export erläutert.

Cloud Storage-Berechtigungen importieren und exportieren

Ihr Dataproc Metastore-Dienst-Agent hatte nicht genügend Berechtigungen, um den Import oder Export auszuführen.

„Dataproc Metastore-Dienst-Agent“ oder „Aufrufer“ hat nicht genügend Berechtigungen vom Cloud Storage-URI für Import/Export ([SERVICE_AGENT] kann nicht auf Cloud Storage-URI [GCS_URI] mit Berechtigungen [SERVICE_AGENT_PERMISSIONS] zugreifen).

Empfohlene Maßnahme: Prüfen Sie Ihre Dienstkontoberechtigungen oder den VPC Service Controls-Dienstperimeter.

Avro-Import oder -Export mit einer nicht unterstützten Hive-Version ausführen

Das Importieren von Avro-Dateien wird für die Hive-Version [HIVE_METASTORE_VERSION] nicht unterstützt. Die unterstützten Versionen sind [SUPPORT_HIVE_VERSIONS].

Empfohlene Maßnahme:In der Versionsrichtlinie finden Sie die aktuelle Unterstützung für Hive-Versionen. Aktualisieren Sie Ihre Datenbankdateien auf eine unterstützte Version.

Importtabellen fehlen

  • Für Avro-Import

    Avro-Quelldateien wurden für die Tabellen [MISSING_TABLE_LIST] nicht gefunden.

  • Für SQL-Import

    Die Hive-Schemavalidierung ist fehlgeschlagen. Fehlende Tabellen: [MISSING_TABLE_LIST].

Empfohlene Maßnahme: Verwenden Sie das Dataproc Metastore-Toolkit als Referenz, um die richtigen Hive-Metadatenschemas Ihrer Datenbankdateien zu prüfen.

Fehler im Zusammenhang mit Sicherung und Wiederherstellung

In diesem Abschnitt werden Fehler im Zusammenhang mit der Sicherung und Wiederherstellung beschrieben.

Sicherung für die Wiederherstellung nicht gefunden

Beim Wiederherstellen eines Back-up in einem Dienst konnte Dataproc Metastore die bereitgestellte Sicherungsressource nicht finden.

Sicherung [BACKUP_ID] wurde nicht gefunden.

Empfohlene Maßnahme: Prüfen Sie, ob die Sicherung in Ihrem Dataproc Metastore-Dienst vorhanden ist.

Back-up kann nicht gelöscht werden

Sie konnten ein Back-up nicht löschen, während es zur Wiederherstellung eines Dienstes verwendet wurde.

Eine Sicherung mit dem Status [RESOURCE_STATE] kann nicht gelöscht werden.

Empfohlene Maßnahme: Warten Sie, bis der Wiederherstellungsjob abgeschlossen ist, bevor Sie versuchen, die Sicherung zu löschen.

Nächste Schritte

  • Informationen zu Lösungen für häufige Probleme, die bei der Verwendung von Dataproc Metastore auftreten können, finden Sie unter Fehlerbehebung.