Solución de problemas

En este documento, se enumeran los errores visibles que captura y muestra la extensión Data Agent Kit para VS Code. Por lo general, estos errores se muestran como Notificaciones (ventanas emergentes) o como Advertencias de la barra de estado en el IDE. Usa esta guía para identificar y resolver problemas.

Si no puedes identificar la fuente de un problema después de revisar los posibles errores que se indican aquí, intenta salir y volver a acceder.

Errores de autenticación y de gcloud CLI

Estos errores afectan la conectividad fundamental de la extensión.

Mensaje de error	Causa posible	Corrección
Google Cloud CLI is required... but was not found.	El objeto binario gcloud no está en la ruta de acceso del sistema.	Instala Google Cloud CLI y reinicia VS Code.
You must be logged in to both the Google Cloud CLI and ADC...	No se ejecutó gcloud auth login ni gcloud auth application-default login.	Haz clic en la barra de estado o en la notificación para activar el flujo de acceso en la terminal.
La barra de estado muestra un ícono de $(warning) junto al nombre de tu cuenta.	La cuenta de extensión con la que se accedió difiere de la cuenta activa de gcloud CLI.	Ejecuta gcloud auth login y gcloud auth application-default login con la misma cuenta que usaste para acceder a Google Cloud.
La barra de estado muestra un ícono de $(warning).	La configuración de la extensión, como el ID del proyecto, la región o el ID del proyecto de facturación, no coincide con la configuración de gcloud CLI.	Haz clic en el ícono de advertencia en la barra de estado del proyecto para sincronizar la configuración entre la extensión y gcloud CLI. Como alternativa, actualiza manualmente los parámetros de configuración en cualquiera de las herramientas para asegurarte de que coincidan.
Cannot sync settings: gcloud CLI or ADC account does not match extension account	Se intentó sincronizar la configuración mientras las cuentas eran incoherentes.	Alinea las cuentas entre gcloud CLI y la extensión. Asegúrate de que usen la misma cuenta de usuario, el mismo proyecto, la misma región y el mismo proyecto de facturación.
Cannot sync settings: Google Cloud CLI is not installed.	Se intentó sincronizar la configuración mientras gcloud CLI no estaba instalada.	Instala gcloud CLI.

Errores de recuperación de la API y del Explorador

Los siguientes son errores generales que se encuentran cuando se exploran recursos de la nube en el árbol de menú del kit de herramientas de Google Cloud Data Agent.

Mensaje de error	Causa posible	Corrección
Failed to load ${itemKind}: ${error.message}	El servidor no puede autorizar tu solicitud (código de estado HTTP 403 Forbidden), no puede encontrar los recursos (código de estado HTTP 404 Not Found) o la API no está habilitada.	Verifica los permisos de Identity and Access Management (IAM) y asegúrate de que la API pertinente, como BigQuery, esté habilitada en la configuración.
No Google Cloud project selected.	Se activó una función sin un proyecto activo.	Usa el selector de proyectos en la barra de estado para seleccionar un proyecto.
Invalid table name format: ${tableName}	Convención de nombres incorrecta (falta el ID del proyecto o el ID del conjunto de datos).	Usa el nombre completamente calificado: project.dataset.table.

Errores de BigQuery y Dataform

Los siguientes errores son específicos de las transformaciones de SQL y la administración de proyectos de Dataform.

Mensaje de error	Causa posible	Corrección
Dataform CLI is not installed. Dataform features will not work.	El paquete Dataform de npm no está instalado de forma global.	Haz clic en Install Dataform CLI en el diálogo para automatizar la instalación.
Failed to compile project in folder...: ${stderr}	Errores de sintaxis en archivos .sqlx o workflow_settings.yaml no válidos	Consulta la vista Compiled Query de Dataform para ver errores de sintaxis específicos.
Failed to run Dataform project: ${message}	Se produjo una falla en la ejecución del trabajo de BigQuery.	Revisa el historial de trabajos de BigQuery para obtener registros de ejecución detallados.
No content found for saved query: ${label}	La entrada de Knowledge Catalog o BigQuery existe, pero no tiene contenido de NoSQL.	Verifica el contenido de la consulta ejecutándola en la consola de Google Cloud .

Servicio administrado para Apache Spark y errores de Spark

Los siguientes errores se relacionan con la administración de clústeres y la ejecución de Spark.

Mensaje de error	Causa posible	Corrección
Error starting/stopping/restarting cluster ${name}: ${message}	Permisos de IAM insuficientes o clúster en transición.	Asegúrate de tener el rol roles/dataproc.editor y verifica si el estado del clúster ya es UPDATING.
Error: No cluster name found.	Error de referencia interno en la vista de árbol.	Actualiza la vista del Explorador de recursos de Spark.
Failed to redirect to Spark UI: ${message}	El clúster está detenido o la puerta de enlace de componentes está inhabilitada.	Inicia el clúster y asegúrate de que la puerta de enlace de componentes esté habilitada en la configuración del clúster.
Failed to load [clusters/jobs/sessions/session templates]: [message]	Error de la API	Actualiza la vista del Explorador de recursos de Spark.
Failed to start Jupyter process / Pip install failed.	No se pudo iniciar el servidor local de Jupyter o no se pudieron instalar los paquetes requeridos.	Abre un nuevo notebook de Spark con el kernel remoto.
No sample notebooks found for the selected kernel type.	No hay notebooks de ejemplo disponibles para el tipo de kernel seleccionado (local o remoto).	No aplicable
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	Esto es específicamente para los usuarios de Windows cuando las rutas de acceso largas no están habilitadas en tu máquina.	Para habilitar las rutas largas, consulta el vínculo que se incluye en la notificación.
google-cloud-jupyter-config and jupyter_server are required to connect to remote kernels on Managed Service for Apache Spark. Install them?	Esto aparece cuando el usuario intenta usar un kernel remoto por primera vez.	Para instalar las dependencias, haz clic en la notificación y selecciona Sí en el diálogo de confirmación.
Requires package installation	Se muestra en la descripción del selector de kernel junto a Kernel remoto si faltan dependencias de Jupyter.	Para instalar las dependencias, haz clic en la notificación y selecciona Sí en el diálogo de confirmación.
Install dependencies for remote Spark kernels. Require google-cloud-jupyter-config and jupyter_server	Se muestra en la descripción del selector de kernel cuando el usuario ejecuta un notebook existente en Kernel remoto	Para instalar las dependencias, haz clic en la notificación y selecciona Sí en el diálogo de confirmación.

Errores de Cloud Storage

Los siguientes errores aparecen cuando se administran buckets y objetos.

Mensaje de error	Causa posible	Corrección
A folder with the name... already exists.	Se produjo una colisión de nombres en el bucket.	Elige un nombre único para la carpeta.
Upload/Download failed: ${message}	Se denegó el permiso o se agotó el tiempo de espera de la red.	Verifica los roles de Storage Object Admin o Creator.
Failed to create bucket: ${message}	El nombre ya se usó a nivel global o contiene caracteres no válidos.	Sigue las reglas para asignar nombres a los buckets de Cloud Storage.

Errores genéricos de la interfaz

Estos errores indican fallas a nivel de la IU.

Mensaje de error	Causa posible	Corrección
No workspace folder open.	El usuario está en el modo Sin carpeta en VS Code.	Abre una carpeta con File > Open Folder.
No active notebook editor found.	Estás ejecutando comandos de Spark o SQL sin un notebook abierto.	Abre un archivo .ipynb o .sql.
Cannot insert item: unsupported resource type.	Se intentó arrastrar y soltar un recurso que tiene una representación de cadena NoSQL.	Solo se pueden insertar tablas, vistas y columnas en los editores.

Errores de la base de datos

Los siguientes errores se muestran cuando se consultan bases de datos de Google Cloud .

AlloyDB

Mensaje de error	Causa posible	Corrección
postgresql error: role "[USER_EMAIL]" does not exist	El usuario que accedió a la extensión no se agregó como usuario de IAM a la instancia.	Consulta Administra la autenticación de IAM para agregar al usuario como usuario de IAM.
postgresql error: permission denied for table [TABLE_NAME]	El usuario de IAM no tiene permiso para el objeto.	Consulta Otorga permisos de base de datos adecuados a los usuarios de IAM para otorgar permiso al usuario de IAM para el objeto.

Cloud SQL para MySQL

Mensaje de error	Causa posible	Corrección
Invalid request: Some of your SQL statements failed to execute. Details: Error 1045 (28000): Access denied for user '[USER]'@'localhost' (using password: YES).	El usuario que accedió a la extensión no se agregó como usuario de IAM a la instancia.	Consulta Autenticación de IAM para agregar el usuario como usuario de IAM para la instancia.
Invalid request: Some of your SQL statements failed to execute. Details: Error 1044 (42000): Access denied for user '[USER]'@'%' to database '[DB_NAME]'.	El usuario de IAM no tiene permiso para acceder a la base de datos.	Consulta Otorga privilegios de base de datos a un usuario o una cuenta de servicio de IAM individuales para otorgar privilegios a los usuarios de IAM para la base de datos.
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" }}.	No está habilitado el acceso a la API de Data.	Habilita el acceso a la API de Data desde la configuración de la consulta o consulta Cómo ejecutar sentencias SQL con la API de Cloud SQL Data para habilitarlo desde la consola de Google Cloud o la gcloud CLI.
Invalid request: IAM authentication is not enabled for the instance [PROJECT_ID]:[INSTANCE_NAME].	La marca de autenticación de IAM no está habilitada.	Habilita la marca de autenticación de IAM desde la configuración de la consulta o consulta Autenticación de IAM para habilitarla desde la consola de Google Cloud o la gcloud CLI.

Cloud SQL para PostgreSQL

Mensaje de error	Causa posible	Corrección
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" }}.	El acceso a la API de datos no está habilitado.	Habilita el acceso a la API de Data desde la configuración de la consulta o consulta Cómo ejecutar sentencias SQL con la API de Cloud SQL Data para habilitarlo desde la consola de Google Cloud o gcloud CLI.
Invalid request: IAM authentication is not enabled for the instance [PROJECT_ID]:[INSTANCE_NAME].	La marca de autenticación de IAM no está habilitada.	Habilita la marca de autenticación de IAM desde la configuración de la consulta o consulta Autenticación de IAM para habilitarla desde la consola de Google Cloud o la gcloud CLI.
Invalid request: Some of your SQL statements failed to execute. Details: pq: password authentication failed for user "[USER_EMAIL]".	El usuario que accedió a la extensión no se agregó como usuario de IAM a la instancia.	Consulta Autenticación de IAM para agregar el usuario como usuario de IAM para la instancia.
Execution failed. All statements are aborted. Details: pq: permission denied for table [TABLE_NAME]	El usuario de IAM no tiene permiso para acceder al objeto.	Consulta Administra usuarios con autenticación de la base de datos de IAM para otorgar privilegios a los usuarios de IAM para la base de datos.

Spanner

Mensaje de error	Causa posible	Corrección
Result set too large. Result sets larger than 10.00M can only be yielded through the streaming API.	No se admiten tamaños de resultados superiores a 10.00 MiB.	Consulta executeSql.

¿Qué sigue?

• Compila canalizaciones de ingeniería de datos