Fehler beheben

In diesem Dokument werden die sichtbaren Fehler aufgeführt, die von der IDE-Erweiterung des Data Agent Kit erfasst und angezeigt werden. Diese Fehler werden in der IDE in der Regel als Benachrichtigungen (Pop-ups) oder als Warnungen in der Statusleiste angezeigt. In diesem Leitfaden erfahren Sie, wie Sie Probleme erkennen und beheben.

Wenn Sie die Quelle eines Problems nach Überprüfung der hier aufgeführten möglichen Fehler nicht ermitteln können, melden Sie sich ab und wieder an.

Authentifizierungs- und gcloud CLI-Fehler

Diese Fehler wirken sich auf die grundlegende Konnektivität der Erweiterung aus.

Fehlermeldung

Mögliche Ursache

Korrektur

Google Cloud CLI is required... but was not found.

Die Binärdatei gcloud ist nicht im Systempfad.

Installieren Sie die Google Cloud CLI und starten Sie Ihre IDE neu.

You must be logged in to both the Google Cloud CLI and ADC...

gcloud auth login oder gcloud auth application-default login wurde nicht ausgeführt.

Klicken Sie auf die Statusleiste oder die Benachrichtigung, um den Anmeldevorgang im Terminal auszulösen.

In der Statusleiste wird neben Ihrem Kontonamen das Symbol $(warning) angezeigt.

Das angemeldete Erweiterungskonto unterscheidet sich vom aktiven gcloud CLI-Konto.

Führen Sie gcloud auth login und gcloud auth application-default login mit demselben Konto aus, mit dem Sie sich bei Google Cloudangemeldet haben.

In der Statusleiste wird das Symbol $(warning) angezeigt.

Erweiterungseinstellungen wie Projekt-ID, Region oder Abrechnungsprojekt-ID stimmen nicht mit den gcloud CLI-Einstellungen überein.

Klicken Sie in der Projektstatusleiste auf das Warnsymbol, um die Einstellungen zwischen der Erweiterung und der gcloud CLI zu synchronisieren. Alternativ können Sie die Konfigurationen in einem der beiden Tools manuell aktualisieren, damit sie übereinstimmen.

Cannot sync settings: gcloud CLI or ADC account does not match extension account.

Es wird versucht, Einstellungen zu synchronisieren, während die Konten inkonsistent sind.

Konten zwischen der gcloud CLI und der Erweiterung abstimmen Achten Sie darauf, dass sie dasselbe Nutzerkonto, Projekt, dieselbe Region und dasselbe Abrechnungsprojekt verwenden.

Cannot sync settings: Google Cloud CLI is not installed.

Sie versuchen, Einstellungen zu synchronisieren, während die gcloud CLI nicht installiert ist.

Installieren Sie die gcloud CLI.

Fehler beim Abrufen von Daten über Explorer und API

Die folgenden allgemeinen Fehler können auftreten, wenn Sie Cloud-Ressourcen in der Menüstruktur des Google Cloud Data Agent Kit durchsuchen.

Fehlermeldung

Mögliche Ursache

Korrektur

Failed to load ${itemKind}: ${error.message}

Der Server kann Ihre Anfrage nicht autorisieren (Statuscode HTTP 403 Forbidden), der Server kann die Ressourcen nicht finden (Statuscode HTTP 404 Not Found) oder die API ist nicht aktiviert.

Prüfen Sie die IAM-Berechtigungen (Identity and Access Management) und stellen Sie sicher, dass die entsprechende API, z. B. BigQuery, in den Einstellungen aktiviert ist.

No Google Cloud project selected.

Eine Funktion wurde ohne aktives Projekt ausgelöst.

Verwenden Sie die Projektauswahl in der Statusleiste, um ein Projekt auszuwählen.

Invalid table name format: ${tableName}

Falsche Namenskonvention (Projekt-ID oder Dataset-ID fehlt).

Verwenden Sie den voll qualifizierten Namen: project.dataset.table.

BigQuery- und Dataform-Fehler

Die folgenden Fehler beziehen sich speziell auf SQL-Transformationen und die Verwaltung von Dataform-Projekten.

Fehlermeldung

Mögliche Ursache

Korrektur

Dataform CLI is not installed. Dataform features will not work.

Das npm-Paket Dataform ist nicht global installiert.

Klicken Sie im Dialogfeld auf Dataform CLI installieren, um die Installation zu automatisieren.

Failed to compile project in folder...: ${stderr}

Syntaxfehler in .sqlx-Dateien oder ungültige workflow_settings.yaml.

Suchen Sie in der Dataform-Ansicht Compiled Query nach bestimmten Syntaxfehlern.

Failed to run Dataform project: ${message}

Fehler bei der Ausführung des BigQuery-Jobs.

Detaillierte Ausführungslogs finden Sie im BigQuery-Jobverlauf.

No content found for saved query: ${label}

Der Knowledge Catalog- oder BigQuery-Eintrag ist vorhanden, enthält aber NoSQL-Inhalte.

Prüfen Sie den Inhalt der Abfrage, indem Sie sie in der Google Cloud -Konsole ausführen.

Managed Service for Apache Spark und Spark-Fehler

Die folgenden Fehler beziehen sich auf die Clusterverwaltung und die Spark-Ausführung.

Fehlermeldung

Mögliche Ursache

Korrektur

Error starting/stopping/restarting cluster ${name}: ${message}

Unzureichende IAM-Berechtigungen oder Cluster in der Übergangsphase.

Prüfen Sie, ob Sie die Rolle roles/dataproc.editor haben, und ob der Clusterstatus bereits UPDATING ist.

Error: No cluster name found.

Interner Referenzfehler in der Baumansicht.

Aktualisieren Sie die Ansicht Spark Resource Explorer.

Failed to redirect to Spark UI: ${message}

Der Cluster wurde beendet oder das Component Gateway ist deaktiviert.

Starten Sie den Cluster und achten Sie darauf, dass Component Gateway in der Clusterkonfiguration aktiviert ist.

Failed to load [clusters/jobs/sessions/session templates]: [message]

API-Fehler

Aktualisieren Sie die Ansicht Spark Resource Explorer.

Failed to start Jupyter process / Pip install failed.

Der Start des lokalen Jupyter-Servers ist fehlgeschlagen oder die Installation der erforderlichen Pakete ist fehlgeschlagen.

Öffnen Sie ein neues Spark-Notebook mit dem Remote-Kernel.

No sample notebooks found for the selected kernel type.

Für den ausgewählten Kerneltyp (lokal oder remote) sind keine Beispiel-Notebooks verfügbar.

Nicht zutreffend

This system does not have Windows Long Path support enabled. Please enable long paths and restart your IDE to work with Spark Notebooks on remote kernels. Learn More

Dies gilt speziell für Windows-Nutzer, wenn lange Pfade auf Ihrem Computer nicht aktiviert sind.

Aktivieren Sie lange Pfade über den Link in der Benachrichtigung.

google-cloud-jupyter-config and jupyter_server are required to connect to remote kernels on Managed Service for Apache Spark. Install them?

Diese Meldung wird angezeigt, wenn der Nutzer zum ersten Mal versucht, einen Remote-Kernel zu verwenden.

Installieren Sie die Abhängigkeiten, indem Sie auf die Benachrichtigung klicken und im Bestätigungsdialogfeld Ja auswählen.

Requires package installation

Wird in der Beschreibung der Kernel-Auswahl neben Remote-Kernel angezeigt, wenn Jupyter-Abhängigkeiten fehlen.

Installieren Sie die Abhängigkeiten, indem Sie auf die Benachrichtigung klicken und im Bestätigungsdialogfeld Ja auswählen.

Install dependencies for remote Spark kernels. Require google-cloud-jupyter-config and jupyter_server

Wird in der Beschreibung der Kernel-Auswahl angezeigt, wenn ein Nutzer ein vorhandenes Notebook mit Remote Kernel ausführt.

Installieren Sie die Abhängigkeiten, indem Sie auf die Benachrichtigung klicken und im Bestätigungsdialogfeld Ja auswählen.

Cloud Storage-Fehler

Die folgenden Fehler können beim Verwalten von Buckets und Objekten auftreten.

Fehlermeldung

Mögliche Ursache

Korrektur

A folder with the name... already exists.

Namenskonflikt im Bucket.

Wählen Sie einen eindeutigen Ordnernamen aus.

Upload/Download failed: ${message}

Berechtigung verweigert oder Zeitüberschreitung des Netzwerks.

Storage Object Admin- oder Creator-Rollen prüfen

Failed to create bucket: ${message}

Der Name ist bereits global vergeben oder enthält ungültige Zeichen.

Halten Sie sich an die Regeln für die Benennung von Cloud Storage-Buckets.

Allgemeine Schnittstellenfehler

Diese Fehler weisen auf Fehler auf Benutzeroberflächenebene hin.

Fehlermeldung

Mögliche Ursache

Korrektur

No workspace folder open.

Der Nutzer befindet sich in der IDE im Modus Kein Ordner.

Öffnen Sie einen Ordner mit File > Open Folder.

No active notebook editor found.

Sie führen Spark- oder SQL-Befehle ohne geöffnetes Notebook aus.

Öffnen Sie eine .ipynb- oder .sql-Datei.

Cannot insert item: unsupported resource type.

Es wird versucht, eine Ressource per Drag-and-drop zu verschieben, die eine NoSQL-Stringdarstellung hat.

Nur Tabellen, Ansichten und Spalten können in Editoren eingefügt werden.

Datenbankfehler

Beim Abfragen von Google Cloud Datenbanken werden die folgenden Fehler zurückgegeben.

AlloyDB

Fehlermeldung

Mögliche Ursache

Korrektur

postgresql error: role "[USER_EMAIL]" does not exist

Der Nutzer, der sich in der Erweiterung angemeldet hat, wurde nicht als IAM-Nutzer für die Instanz hinzugefügt.

Informationen zum Hinzufügen des Nutzers als IAM-Nutzer finden Sie unter IAM-Authentifizierung verwalten.

postgresql error: permission denied for table [TABLE_NAME]

Der IAM-Nutzer hat keine Berechtigung für das Objekt.

Informationen zum Erteilen von Berechtigungen für das Objekt finden Sie unter IAM-Nutzern die entsprechenden Datenbankberechtigungen erteilen.

Cloud SQL for MySQL

Fehlermeldung Mögliche Ursache Korrektur
Invalid request: Some of your SQL statements failed to execute. Details: Error 1045 (28000): Access denied for user '[USER]'@'localhost' (using password: YES).
  • IAM-Datenbankauthentifizierung: Der Nutzer, der sich in der Erweiterung angemeldet hat, wurde der Instanz nicht als IAM-Nutzer hinzugefügt.
  • Bei der integrierten Datenbankauthentifizierung: Das ausgewählte regionale Secret oder die ausgewählte Secret-Version in Secret Manager stimmt nicht mit dem Passwort des Datenbanknutzers überein.
Invalid request: Some of your SQL statements failed to execute. Details: Error 1044 (42000): Access denied for user '[USER]'@'%' to database '[DB_NAME]'. Der Datenbanknutzer ist nicht berechtigt, auf die Datenbank zuzugreifen. Informationen zum Gewähren von Datenbankberechtigungen finden Sie unter Einzelnen IAM-Nutzern oder Dienstkonten Datenbankberechtigungen erteilen oder Datenbanknutzer konfigurieren.
Invalid request: Failed to access secret '[SECRET_VERSION]': generic::PERMISSION_DENIED: Permission 'secretmanager.versions.access' denied for resource '[SECRET_VERSION]' (or it may not exist). Das Konto, mit dem Sie in der Erweiterung angemeldet sind, hat keine Berechtigung für den Zugriff auf die regionale Secret-Version in Secret Manager oder die Secret-Version ist nicht vorhanden. Prüfen Sie, ob das regionale Secret und die Secret-Version, die in den Abfrageeinstellungen ausgewählt sind, vorhanden sind. Weisen Sie Ihrem Konto dann die Rolle Secret Manager Secret Accessor (roles/secretmanager.secretAccessor) zu. Weitere Informationen finden Sie in der Cloud SQL Data API-Dokumentation unter Erforderliche Rollen oder Berechtigungen.
Invalid request: Secret fetched from Secret Manager is empty Die ausgewählte regionale Secret-Version enthält kein Passwort. Fügen Sie eine neue Secret-Version hinzu, die das Passwort des Datenbanknutzers enthält, und wählen Sie sie dann in den Abfrageeinstellungen aus.
Invalid request: The instance doesn't allow using ExecuteSql to access this instance. You can allow it by patching the instance with {settings: { dataApiAccess: "ALLOW_DATA_API" }} Der Zugriff auf die Data API ist nicht aktiviert. Aktivieren Sie den Data API-Zugriff über die Abfrageeinstellungen oder lesen Sie den Abschnitt SQL-Anweisungen mit der Cloud SQL Data API ausführen, um ihn über die Google Cloud Console oder die gcloud CLI zu aktivieren.
Invalid request: IAM authentication is not enabled for the instance [PROJECT_ID]:[INSTANCE_NAME] Das Flag für die IAM-Authentifizierung ist nicht aktiviert. Aktivieren Sie das Flag für die IAM-Authentifizierung in den Abfrageeinstellungen oder lesen Sie den Abschnitt IAM-Authentifizierung, um es in der Google Cloud Console oder der gcloud CLI zu aktivieren.

Cloud SQL for PostgreSQL

Fehlermeldung Mögliche Ursache Korrektur
Invalid request: The instance doesn't allow using ExecuteSql to access this instance. You can allow it by patching the instance with {settings: { dataApiAccess: "ALLOW_DATA_API" }} Der Zugriff auf die Data API ist nicht aktiviert. Aktivieren Sie den Data API-Zugriff über die Abfrageeinstellungen oder lesen Sie den Abschnitt SQL-Anweisungen mit der Cloud SQL Data API ausführen, um ihn über die Google Cloud Console oder die gcloud CLI zu aktivieren.
Invalid request: IAM authentication is not enabled for the instance [PROJECT_ID]:[INSTANCE_NAME] Das Flag für die IAM-Authentifizierung ist nicht aktiviert. Aktivieren Sie das Flag für die IAM-Authentifizierung in den Abfrageeinstellungen oder lesen Sie den Abschnitt IAM-Authentifizierung, um es in der Google Cloud Console oder der gcloud CLI zu aktivieren.
Invalid request: Some of your SQL statements failed to execute. Details: pq: password authentication failed for user "[USER]".
  • IAM-Datenbankauthentifizierung: Der Nutzer, der sich in der Erweiterung angemeldet hat, wurde der Instanz nicht als IAM-Nutzer hinzugefügt.
  • Bei der integrierten Datenbankauthentifizierung: Das ausgewählte regionale Secret oder die ausgewählte Secret-Version in Secret Manager stimmt nicht mit dem Passwort des Datenbanknutzers überein.
Invalid request: Failed to access secret '[SECRET_VERSION]': generic::PERMISSION_DENIED: Permission 'secretmanager.versions.access' denied for resource '[SECRET_VERSION]' (or it may not exist). Das Konto, mit dem Sie in der Erweiterung angemeldet sind, hat keine Berechtigung für den Zugriff auf die regionale Secret-Version in Secret Manager oder die Secret-Version ist nicht vorhanden. Prüfen Sie, ob das regionale Secret und die Secret-Version, die in den Abfrageeinstellungen ausgewählt sind, vorhanden sind. Weisen Sie Ihrem Konto dann die Rolle Secret Manager Secret Accessor (roles/secretmanager.secretAccessor) zu. Weitere Informationen finden Sie in der Cloud SQL Data API-Dokumentation unter Erforderliche Rollen oder Berechtigungen.
Invalid request: Secret fetched from Secret Manager is empty Die ausgewählte regionale Secret-Version enthält kein Passwort. Fügen Sie eine neue Secret-Version hinzu, die das Passwort des Datenbanknutzers enthält, und wählen Sie sie dann in den Abfrageeinstellungen aus.
Execution failed. All statements are aborted. Details: pq: permission denied for table [TABLE_NAME] Der Datenbanknutzer ist nicht berechtigt, auf das Objekt zuzugreifen. Informationen zum Erteilen von Berechtigungen für die Datenbank finden Sie unter Nutzer mit IAM-Datenbankauthentifizierung verwalten oder Datenbanknutzer konfigurieren.

Spanner

Fehlermeldung

Mögliche Ursache

Korrektur

Result set too large. Result sets larger than 10.00M can only be yielded through the streaming API.

Ergebnisgrößen, die größer als 10,00 MiB sind, werden nicht unterstützt.

Weitere Informationen finden Sie unter executeSql.

Nächste Schritte