Dépannage

Ce document liste les erreurs visibles capturées et affichées par l'extension Data Agent Kit pour VS Code. Ces erreurs sont généralement affichées sous forme de notifications (pop-ups) ou d'avertissements dans la barre d'état de 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 une incidence 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 fichier binaire gcloud ne figure pas dans le chemin d'accès du système.

Installez la Google Cloud CLI, puis 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.

Une icône $(warning) s'affiche dans la barre d'état à côté du nom de votre compte.

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

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

Une icône $(warning) s'affiche dans la barre d'état.

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 la gcloud CLI. Vous pouvez également mettre à jour manuellement les configurations dans l'un ou l'autre outil 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 ne sont pas cohérents.

Alignez les comptes entre la gcloud CLI et l'extension. Assurez-vous qu'il utilise 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 de l'API

Vous trouverez ci-dessous les erreurs générales rencontrées lors de la navigation dans les 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 (code d'état HTTP 403 Forbidden), il ne trouve pas les ressources (code d'état HTTP 404 Not Found) ou l'API n'est pas activée.

Vérifiez les autorisations IAM (Identity and Access Management) 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}

La convention de nommage est incorrecte (ID de projet ou ID d'ensemble de données manquants).

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 la CLI Dataform) 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 valides.

Recherchez les erreurs de syntaxe spécifiques dans la vue Compiled Query de Dataform.

Failed to run Dataform project: ${message}

Échec de l'exécution du job 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 contient du contenu NoSQL.

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

Erreurs Managed Service pour Apache Spark et Spark

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

Message d'erreur

Cause possible

Résolution

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

Autorisations IAM insuffisantes ou cluster en transition.

Assurez-vous de disposer du rôle roles/dataproc.editor et vérifiez si l'état du cluster est déjà UPDATING.

Error: No cluster name found.

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

Actualisez la vue de l'explorateur de ressources Spark.

Failed to redirect to Spark UI: ${message}

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

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

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

Erreur d'API

Actualisez la vue de l'explorateur de ressources Spark.

Failed to start Jupyter process / Pip install failed.

Le démarrage du serveur Jupyter local ou l'installation des packages requis ont échoué.

Ouvrez un notebook Spark avec le noyau distant.

No sample notebooks found for the selected kernel type.

Les notebooks exemples 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 procédure s'adresse spécifiquement aux utilisateurs de Windows lorsque les chemins d'accès longs ne sont pas activés sur leur machine.

Activez les chemins d'accès longs en suivant 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?

Ce message 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 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 Noyau distant si des dépendances Jupyter sont manquantes.

Installez les dépendances en cliquant sur la notification et en sélectionnant 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 Noyau distant

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

Erreurs Cloud Storage

Les erreurs suivantes s'affichent lorsque vous gérez 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 ou Creator.

Failed to create bucket: ${message}

Nom déjà utilisé au niveau mondial ou caractères non valides.

Suivez les règles de dénomination des buckets Cloud Storage.

Erreurs d'interface génériques

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

Message d'erreur

Cause possible

Résolution

No workspace folder open.

L'utilisateur est en mode Aucun dossier dans VS Code.

Ouvrez un dossier à l'aide de File > Open Folder.

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 qui possède une représentation de chaîne NoSQL.

Seules les tables, les vues et les colonnes peuvent être insérées dans les éditeurs.

Erreurs de base de données

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

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 ne dispose pas des autorisations nécessaires pour l'objet.

Consultez Accorder les autorisations de base de données approprié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 Authentification IAM 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 console Google Cloud 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 console Google Cloud 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 console Google Cloud 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 console Google Cloud 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 résultats de plus de 10 Mio ne sont pas acceptés.

Consultez executeSql.

Étapes suivantes