Fehlermeldungen

Auf dieser Seite werden häufige Fehlermeldungen beschrieben, die bei der Verwendung von Dataproc Metastore angezeigt werden. Die einzelnen Abschnitte enthalten weitere Informationen zur Bedeutung der Meldungen und zu den empfohlenen Maßnahmen zur Behebung der Fehler.

Allgemeine Fehler:

  • Ungültige Eingaben von Kunden:

    • „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, aber der Dienst war nicht ACTIVE.
    • „Sicherung [BACKUP–ID] nicht bereit.“

  • API-Zugriffsberechtigung

    • Sie haben nicht genügend Berechtigungen, um die Dataproc Metastore APIs aufzurufen.

  • Unzureichende Berechtigungen für Dienst-Agents:

    • „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 Importieren und Exportieren:

Fehler im Zusammenhang mit Sicherung und Wiederherstellung:

Allgemeine Fehler

In diesem Abschnitt werden allgemeine Fehler beschrieben.

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. Weitere Informationen finden Sie unter Kerberos für einen Dienst konfigurieren.

    Das angegebene krb5.conf-Objekt 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, aber der Dienst war 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.

Berechtigung für den API-Zugriff

Sie haben nicht genügend Berechtigungen, um die Dataproc Metastore APIs aufzurufen.

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 benutzerdefinierten Cloud Storage-Bucket für das Data Warehouse bereitgestellt, dem Dataproc Metastore-Dienst-Agent aber keine Zugriffsberechtigung erteilt. Weitere Informationen finden Sie unter Hive-Lagerverzeichnis.

    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.

Möglicherweise konnte Dataproc Metastore 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 im Zusammenhang mit Import und Export

In diesem Abschnitt werden Fehler beim Importieren und Exportieren erläutert.

Cloud Storage-Berechtigungen importieren und exportieren

Der Dataproc Metastore-Dienst-Agent hat nicht genügend Berechtigungen für den Import oder Export.

„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 in 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:Informationen zur aktuellsten unterstützten Hive-Version finden Sie in der Versionsrichtlinie. Aktualisieren Sie Ihre Datenbankdateien auf eine unterstützte Version.

Fehlende Importtabellen

  • 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 Sicherung und Wiederherstellung erläutert.

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.

Sicherung kann im Status [RESOURCE_STATE] 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.