Solución de problemas

En este documento, se enumeran los errores visibles que captura y muestra la extensión Data Agent Kit para Antigravity. 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 el posible error que se indica 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 la Google Cloud CLI y reinicia Antigravity.

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 $(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 $(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 de forma manual las configuraciones en cualquiera de las herramientas para asegurarte de que coincidan.

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

Se intenta sincronizar la configuración mientras las cuentas son incoherentes.

Alinea las cuentas entre gcloud CLI y la extensión. Asegúrate de que usen la misma cuenta de usuario, proyecto, región y proyecto de facturación.

Cannot sync settings: Google Cloud CLI is not installed.

Se intenta sincronizar la configuración mientras la gcloud CLI no está instalada.

Instala gcloud CLI.

Errores del Explorador y de recuperación de la API

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

Mensaje de error

Causa posible

Corrección

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

El servidor no puede autorizar tu solicitud (HTTP 403 Forbidden código de estado), no puede encontrar los recursos (HTTP 404 Not Found código de estado) 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}

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}

Existe la entrada de Knowledge Catalog o BigQuery, pero no tiene contenido de NoSQL.

Para verificar el contenido de la consulta, ejecútala en la Google Cloud consola.

Errores de Managed Service para Apache Spark y 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. Verifica si el estado del clúster ya es UPDATING.

Error: No cluster name found.

Error de referencia interna en la vista de árbol.

Actualiza la vista del Explorador de recursos de Spark.

Failed to redirect to Spark UI: ${message}

El clúster se detuvo 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 API

Actualiza la vista del Explorador de recursos de Spark.

Failed to start Jupyter process / Pip install failed.

No se pudo iniciar el servidor Jupyter local o no se pudieron instalar los paquetes necesarios.

Abre un nuevo notebook de Spark con el kernel remoto.

No sample notebooks found for the selected kernel type.

No hay notebooks de muestra 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 Antigravity to work with Spark Notebooks on remote kernels. Learn More

Esto es específicamente para usuarios de Windows cuando no están habilitadas las rutas de acceso largas en tu máquina.

Para habilitar las rutas de acceso largas, consulta el vínculo 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 mientras se administran buckets y objetos.

Mensaje de error

Causa posible

Corrección

A folder with the name... already exists.

Conflicto de nombres en el bucket.

Elige un nombre de carpeta único.

Upload/Download failed: ${message}

Se denegó el permiso o se agotó el tiempo de espera de la red.

Verifica los roles Storage Object Admin o Creator.

Failed to create bucket: ${message}

El nombre ya se usó de forma global o contiene caracteres no válidos.

Sigue las reglas de nombres de 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 Antigravity.

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 intenta arrastrar y soltar un recurso que tiene una representación de cadena de 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 Google Cloud bases de datos.

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 un 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 los 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 un usuario de IAM a la instancia. Consulta IAM autenticación para agregar al 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 de IAM o una cuenta de servicio individual 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" }}. El acceso a la API de datos no está habilitado. Habilita el acceso a la API de datos desde la configuración de la consulta o consulta Ejecuta instrucciones de SQL con la API de datos de Cloud SQL para habilitarlo desde la Google Cloud consola o gcloud CLI.
Invalid request: IAM authentication is not enabled for the instance [PROJECT_ID]:[INSTANCE_NAME]. No está habilitada la marca de autenticación de IAM. 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 Google Cloud consola 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 datos desde la configuración de la consulta o consulta Ejecuta instrucciones de SQL con la API de datos de Cloud SQL para habilitarlo desde la Google Cloud consola o la gcloud CLI.
Invalid request: IAM authentication is not enabled for the instance [PROJECT_ID]:[INSTANCE_NAME]. No está habilitada la marca de autenticación de IAM. 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 Google Cloud consola o 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 un usuario de IAM a la instancia. Consulta Autenticación de IAM para agregar al 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 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.

See executeSql.

¿Qué sigue?