Fehler beheben

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

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 dann 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 gcloud-Binärdatei befindet sich nicht im Systempfad.

Installieren Sie die Google Cloud CLI und starten Sie VS Code 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 zu starten.

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 in Google Cloudangemeldet haben.

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

Die 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.

Sie versuchen, Einstellungen zu synchronisieren, während die Konten nicht übereinstimmen.

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 den Explorer und die API

Die folgenden allgemeinen Fehler können beim Durchsuchen von Cloud-Ressourcen in der Menüstruktur des Google Cloud Data Agent Kit auftreten.

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.

Wählen Sie in der Statusleiste ein Projekt aus.

Invalid table name format: ${tableName}

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

Verwenden Sie den vollständig 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.

Sehen Sie sich den BigQuery-Jobverlauf an, um detaillierte Ausführungsprotokolle zu erhalten.

No content found for saved query: ${label}

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

Prüfen Sie den Abfrageinhalt, indem Sie die Abfrage 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 angehalten oder das Component Gateway ist deaktiviert.

Starten Sie den Cluster und achten Sie darauf, dass das 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 lokale Jupyter-Server konnte nicht gestartet werden 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 VS Code 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}

Die Berechtigung wurde verweigert oder es ist eine Zeitüberschreitung des Netzwerks aufgetreten.

Storage Object Admin- oder Creator-Rollen bestätigen

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 Cloud Storage-Bucket-Namen.

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 VS Code 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 der Instanz nicht als IAM-Nutzer 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 der Berechtigung 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). Der Nutzer, der sich in der Erweiterung angemeldet hat, wurde der Instanz nicht als IAM-Nutzer hinzugefügt. Informationen zum Hinzufügen des Nutzers als IAM-Nutzer für die Instanz finden Sie unter IAM-Authentifizierung.
Invalid request: Some of your SQL statements failed to execute. Details: Error 1044 (42000): Access denied for user '[USER]'@'%' to database '[DB_NAME]'. Der IAM-Nutzer ist nicht berechtigt, auf die Datenbank zuzugreifen. Informationen zum Erteilen von Berechtigungen für IAM-Nutzer für die Datenbank finden Sie unter Einzelnen IAM-Nutzern oder Dienstkonten Datenbankberechtigungen erteilen.
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 über die Google Cloud Konsole oder die 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 Data API-Zugriff 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 über die Google Cloud Console oder die gcloud CLI zu aktivieren.
Invalid request: Some of your SQL statements failed to execute. Details: pq: password authentication failed for user "[USER_EMAIL]". Der Nutzer, der sich in der Erweiterung angemeldet hat, wurde der Instanz nicht als IAM-Nutzer hinzugefügt. Weitere Informationen zum Hinzufügen des Nutzers als IAM-Nutzer für die Instanz finden Sie unter IAM-Authentifizierung.
Execution failed. All statements are aborted. Details: pq: permission denied for table [TABLE_NAME] Der IAM-Nutzer hat keine Berechtigung für den Zugriff auf das Objekt. Informationen zum Erteilen von Berechtigungen für IAM-Nutzer für die Datenbank finden Sie unter Nutzer mit IAM-Datenbankauthentifizierung verwalten.

Spanner

Fehlermeldung

Mögliche Ursache

Korrektur

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

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

Weitere Informationen finden Sie unter executeSql.

Nächste Schritte