Dépannage

Ce document répertorie les erreurs visibles capturées et présentées par l'extension Data Agent Kit pour VS Code. Ces erreurs s'affichent généralement sous forme de notifications (pop-up) ou d'avertissements dans la barre d'état dans l'IDE. Consultez ce guide pour identifier et résoudre les problèmes.

Si vous ne parvenez pas à identifier la source d'un problème après avoir examiné les erreurs possibles listées ici, essayez de vous déconnecter, puis de vous reconnecter.

Erreurs d'authentification et de gcloud CLI

Ces erreurs ont un impact sur la connectivité de base de l'extension.

Message d'erreur

Cause possible

Résolution

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

Le binaire gcloud ne se trouve pas dans le chemin d'accès du système.

Installez Google Cloud CLI et redémarrez VS Code.

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

gcloud auth login ou gcloud auth application-default login n'a pas été exécuté.

Cliquez sur la barre d'état ou sur la notification pour déclencher le flux de connexion dans le terminal.

La barre d'état affiche une icône $(warning) à côté du nom de votre compte.

Le compte de l'extension connecté est différent du compte gcloud CLI actif.

Exécutez gcloud auth login et gcloud auth application-default login avec le même compte que celui utilisé pour vous connecter à Google Cloud.

La barre d'état affiche une icône $(warning).

Les paramètres de l'extension, tels que l'ID du projet, la région ou l'ID du projet de facturation, ne correspondent pas aux paramètres de gcloud CLI.

Cliquez sur l'icône d'avertissement dans la barre d'état du projet pour synchroniser les paramètres entre l'extension et gcloud CLI. Vous pouvez également mettre à jour manuellement les configurations dans l'un des outils pour vous assurer qu'elles correspondent.

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

Tentative de synchronisation des paramètres alors que les comptes sont incohérents.

Alignez les comptes entre gcloud CLI et l'extension. Assurez-vous qu'ils utilisent le même compte utilisateur, le même projet, la même région et le même projet de facturation.

Cannot sync settings: Google Cloud CLI is not installed.

Tentative de synchronisation des paramètres alors que gcloud CLI n'est pas installé.

Installez gcloud CLI.

Erreurs d'exploration et de récupération d'API

Les erreurs suivantes sont générales et se produisent lorsque vous parcourez des ressources cloud dans l'arborescence du menu Google Cloud Data Agent Kit.

Message d'erreur

Cause possible

Résolution

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

Le serveur ne peut pas autoriser votre requête (HTTP 403 Forbidden code d'état), il ne trouve pas les ressources (HTTP 404 Not Found code d'état) ou l'API n'est pas activée.

Vérifiez les autorisations Identity and Access Management (IAM) et assurez-vous que l'API concernée, telle que BigQuery, est activée dans les paramètres.

No Google Cloud project selected.

Une fonctionnalité a été déclenchée sans projet actif.

Utilisez le sélecteur de projet dans la barre d'état pour sélectionner un projet.

Invalid table name format: ${tableName}

Convention d'attribution de noms incorrecte (ID de projet ou ID d'ensemble de données manquant).

Utilisez le nom complet : project.dataset.table.

Erreurs BigQuery et Dataform

Les erreurs suivantes sont spécifiques aux transformations SQL et à la gestion des projets Dataform.

Message d'erreur

Cause possible

Résolution

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

Le package npm Dataform n'est pas installé globalement.

Cliquez sur Install Dataform CLI (Installer Dataform CLI) dans la boîte de dialogue pour automatiser l'installation.

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

Erreurs de syntaxe dans les fichiers .sqlx ou workflow_settings.yaml non valide.

Recherchez les erreurs de syntaxe spécifiques dans la vue Compiled Query (Requête compilée) de Dataform.

Failed to run Dataform project: ${message}

Échec de l'exécution de la tâche BigQuery.

Consultez l'historique des tâches BigQuery pour obtenir des journaux d'exécution détaillés.

No content found for saved query: ${label}

L'entrée Knowledge Catalog ou BigQuery existe, mais ne contient pas de contenu NoSQL.

Vérifiez le contenu de la requête en l'exécutant dans la Google Cloud console.

Erreurs Managed Service pour Apache Spark et Spark

Les erreurs suivantes sont liées à la gestion des clusters et à l'exécution de Spark.

Message d'erreur

Cause possible

Résolution

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

Autorisations IAM insuffisantes ou cluster en cours de transition.

Assurez-vous de disposer du rôle roles/dataproc.editor et vérifiez si l'état du cluster est déjà UPDATING (EN COURS DE MISE À JOUR).

Error: No cluster name found.

Erreur de référence interne dans l'arborescence.

Actualisez la vue Spark Resource Explorer (Explorateur de ressources Spark).

Failed to redirect to Spark UI: ${message}

Le cluster est arrêté ou la passerelle de composants est désactivée.

Démarrez le cluster et assurez-vous que la passerelle de composants est activée dans la configuration du cluster.

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

Erreur d'API

Actualisez la vue Spark Resource Explorer (Explorateur de ressources Spark).

Failed to start Jupyter process / Pip install failed.

Échec du démarrage du serveur Jupyter local ou de l'installation des packages requis.

Ouvrez un notebook Spark avec le noyau distant.

No sample notebooks found for the selected kernel type.

Les notebooks d'exemple pour le type de noyau sélectionné (local ou distant) ne sont pas disponibles.

Non applicable

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

Cette erreur s'affiche spécifiquement pour les utilisateurs Windows lorsque les chemins d'accès longs ne sont pas activés sur leur machine.

Activez les chemins d'accès longs en cliquant sur le lien dans la notification.

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

Cette erreur s'affiche lorsque l'utilisateur tente d'utiliser un noyau distant pour la première fois.

Installez les dépendances en cliquant sur la notification et en sélectionnant Yes (Oui) dans la boîte de dialogue de confirmation.

Requires package installation

S'affiche dans la description du sélecteur de noyau à côté de Remote Kernel (Noyau distant) si des dépendances Jupyter sont manquantes.

Installez les dépendances en cliquant sur la notification et en sélectionnant Yes (Oui) dans la boîte de dialogue de confirmation.

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

S'affiche dans la description du sélecteur de noyau lorsque l'utilisateur exécute un notebook existant sur Remote Kernel (Noyau distant).

Installez les dépendances en cliquant sur la notification et en sélectionnant Yes (Oui) dans la boîte de dialogue de confirmation.

Erreurs Cloud Storage

Les erreurs suivantes s'affichent lors de la gestion des buckets et des objets.

Message d'erreur

Cause possible

Résolution

A folder with the name... already exists.

Conflit de noms dans le bucket.

Choisissez un nom de dossier unique.

Upload/Download failed: ${message}

Autorisation refusée ou délai d'attente du réseau expiré.

Vérifiez les rôles Storage Object Admin (Administrateur d'objets Storage) ou Creator (Créateur).

Failed to create bucket: ${message}

Nom déjà utilisé globalement ou caractères non valides.

Suivez les règles d'attribution de noms aux buckets Cloud Storage.

Erreurs d'interface génériques

Ces erreurs indiquent des échecs au niveau de l'interface utilisateur.

Message d'erreur

Cause possible

Résolution

No workspace folder open.

L'utilisateur est en mode No Folder (Aucun dossier) dans VS Code.

Ouvrez un dossier à l'aide de File > Open Folder (Fichier > Ouvrir un dossier).

No active notebook editor found.

Vous exécutez des commandes Spark ou SQL sans notebook ouvert.

Ouvrez un fichier .ipynb ou .sql.

Cannot insert item: unsupported resource type.

Tentative de glisser-déposer une ressource dont la représentation de chaîne est NoSQL.

Seuls les tables, les vues et les colonnes peuvent être insérés dans les éditeurs.

Erreurs de base de données

Les erreurs suivantes sont renvoyées lors de l'interrogation des Google Cloud bases de données.

AlloyDB

Message d'erreur

Cause possible

Résolution

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

L'utilisateur connecté à l'extension n'a pas été ajouté en tant qu' utilisateur IAM à l'instance.

Consultez Gérer l'authentification IAM pour ajouter l'utilisateur en tant qu' utilisateur IAM.

postgresql error: permission denied for table [TABLE_NAME]

L'utilisateur IAM n'est pas autorisé à accéder à l' objet.

Consultez Accorder des droits appropriés sur une base de données aux utilisateurs IAM pour accorder l'autorisation à l'utilisateur IAM pour l'objet.

Cloud SQL pour MySQL

Message d'erreur Cause possible Résolution
Invalid request: Some of your SQL statements failed to execute. Details: Error 1045 (28000): Access denied for user '[USER]'@'localhost' (using password: YES). L'utilisateur connecté à l'extension n'a pas été ajouté en tant qu' utilisateur IAM à l'instance. Consultez IAM authentification pour ajouter l'utilisateur en tant qu'utilisateur IAM pour l' instance.
Invalid request: Some of your SQL statements failed to execute. Details: Error 1044 (42000): Access denied for user '[USER]'@'%' to database '[DB_NAME]'. L'utilisateur IAM n'est pas autorisé à accéder à la base de données. Consultez Accorder des droits sur une base de données à un utilisateur ou à un compte de service IAM individuel pour accorder des droits aux utilisateurs IAM pour la base de données.
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" }}. L'accès à l'API Data n'est pas activé. Activez l'accès à l'API Data à partir des paramètres de requête ou consultez Exécuter des instructions SQL à l'aide de l'API Cloud SQL Data pour l'activer à partir de la Google Cloud console ou de gcloud CLI.
Invalid request: IAM authentication is not enabled for the instance [PROJECT_ID]:[INSTANCE_NAME]. Le flag d'authentification IAM n'est pas activé. Activez le flag d'authentification IAM à partir des paramètres de requête ou consultez Authentification IAM pour l'activer à partir de la Google Cloud console ou de gcloud CLI.

Cloud SQL pour PostgreSQL

Message d'erreur Cause possible Résolution
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" }}. L'accès à l'API Data n'est pas activé. Activez l'accès à l'API Data à partir des paramètres de requête ou consultez Exécuter des instructions SQL à l'aide de l' API Cloud SQL Data pour l'activer à partir de la Google Cloud console ou de gcloud CLI.
Invalid request: IAM authentication is not enabled for the instance [PROJECT_ID]:[INSTANCE_NAME]. Le flag d'authentification IAM n'est pas activé. Activez le flag d'authentification IAM à partir des paramètres de requête ou consultez Authentification IAM pour l'activer à partir de la Google Cloud console ou de gcloud CLI.
Invalid request: Some of your SQL statements failed to execute. Details: pq: password authentication failed for user "[USER_EMAIL]". L'utilisateur connecté à l'extension n'a pas été ajouté en tant qu' utilisateur IAM à l'instance. Consultez Authentification IAM pour ajouter l'utilisateur en tant qu'utilisateur IAM pour l'instance.
Execution failed. All statements are aborted. Details: pq: permission denied for table [TABLE_NAME] L'utilisateur IAM n'est pas autorisé à accéder à l'objet. Consultez Gérer les utilisateurs avec l'authentification IAM pour les bases de données pour accorder des droits aux utilisateurs IAM pour la base de données.

Spanner

Message d'erreur

Cause possible

Résolution

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

Les tailles de résultat supérieures à 10,00 Mio ne sont pas acceptées.

Consultez executeSql.

Étape suivante