Dépannage

Ce document liste les erreurs visibles capturées et affichées par l'extension IDE Data Agent Kit. 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. Utilisez 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 binaire gcloud ne figure pas dans le chemin d'accès du système.

Installez la Google Cloud CLI et redémarrez votre IDE.

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 processus de connexion dans le terminal.

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

Le compte d'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.

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 sont incohé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 la gcloud CLI n'est pas installée.

Installez la 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 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}

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.

Dans la boîte de dialogue, cliquez sur Installer la CLI Dataform pour automatiser l'installation.

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

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

Consultez la vue Compiled Query de Dataform pour identifier les erreurs de syntaxe spécifiques.

Failed to run Dataform project: ${message}

Échec de l'exécution du job BigQuery.

Consultez l'historique des jobs 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 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 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 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 your IDE to work with Spark Notebooks on remote kernels. Learn More

Cette procédure s'adresse spécifiquement aux utilisateurs de Windows lorsque les chemins 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 essaie d'utiliser un noyau à distance 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

Affiché dans la description du sélecteur de noyau lorsque l'utilisateur exécute un notebook existant sur Remote Kernel

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 lors de la gestion des buckets et des objets.

Message d'erreur

Cause possible

Résolution

A folder with the name... already exists.

Collision 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 l'IDE.

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 dont la représentation de chaîne NoSQL est manquante.

Seuls les tableaux, 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 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).
  • Pour l'authentification IAM pour les bases de données : l'utilisateur connecté à l'extension n'a pas été ajouté en tant qu'utilisateur IAM à l'instance.
  • Pour l'authentification intégrée à la base de données : le secret régional ou la version du secret sélectionnés dans Secret Manager ne correspondent pas au mot de passe de l'utilisateur de la base de données.
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 de la base de données n'est pas autorisé à y accéder. Consultez Accorder des droits sur une base de données à un utilisateur ou à un compte de service IAM individuel ou Configurer l'utilisateur de la base de données pour accorder des droits sur la base de données.
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). Le compte connecté à l'extension n'est pas autorisé à accéder à la version du secret régional dans Secret Manager, ou la version du secret n'existe pas. Vérifiez que le secret régional et la version du secret sélectionnés dans les paramètres de la requête existent. Attribuez ensuite le rôle Secret Manager Secret Accessor (roles/secretmanager.secretAccessor) à votre compte. Consultez la section Rôles ou autorisations requis de la documentation de l'API Cloud SQL Data.
Invalid request: Secret fetched from Secret Manager is empty La version du secret régional sélectionnée ne contient pas de mot de passe. Ajoutez une version secrète contenant le mot de passe de l'utilisateur de la base de données, puis sélectionnez-la dans les paramètres de la requête.
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 dans les paramètres de requête ou consultez Authentification IAM pour l'activer dans la console Google Cloud ou 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 dans les paramètres de requête ou consultez Authentification IAM pour l'activer dans la console Google Cloud ou gcloud CLI.
Invalid request: Some of your SQL statements failed to execute. Details: pq: password authentication failed for user "[USER]".
  • Pour l'authentification IAM pour les bases de données : l'utilisateur connecté à l'extension n'a pas été ajouté en tant qu'utilisateur IAM à l'instance.
  • Pour l'authentification intégrée à la base de données : le secret régional ou la version du secret sélectionnés dans Secret Manager ne correspondent pas au mot de passe de l'utilisateur de la base de données.
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). Le compte connecté à l'extension n'est pas autorisé à accéder à la version du secret régional dans Secret Manager, ou la version du secret n'existe pas. Vérifiez que le secret régional et la version du secret sélectionnés dans les paramètres de la requête existent. Attribuez ensuite le rôle Secret Manager Secret Accessor (roles/secretmanager.secretAccessor) à votre compte. Consultez la section Rôles ou autorisations requis de la documentation de l'API Cloud SQL Data.
Invalid request: Secret fetched from Secret Manager is empty La version du secret régional sélectionnée ne contient pas de mot de passe. Ajoutez une version secrète contenant le mot de passe de l'utilisateur de la base de données, puis sélectionnez-la dans les paramètres de la requête.
Execution failed. All statements are aborted. Details: pq: permission denied for table [TABLE_NAME] L'utilisateur de la base de données n'est pas autorisé à accéder à l'objet. Consultez Gérer les utilisateurs avec l'authentification IAM pour les bases de données ou Configurer l'utilisateur de la base de données pour accorder des droits d'accès à 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