Resolver problemas

Este documento lista os erros visíveis capturados e exibidos pela extensão do Data Agent Kit para Antigravity. Esses erros normalmente são mostrados como Notificações (pop-ups) ou como Avisos na barra de status no ambiente de desenvolvimento integrado. Use este guia para identificar e resolver problemas.

Se você não conseguir identificar a origem de um problema depois de analisar o possível erro listado aqui, tente sair e fazer login novamente.

Erros de autenticação e da CLI gcloud

Esses erros afetam a conectividade básica da extensão.

Mensagem de erro

Possível causa

Correção

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

O binário gcloud não está no caminho do sistema.

Instale a Google Cloud CLI e reinicie o Antigravity.

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

gcloud auth login ou gcloud auth application-default login não foi executado.

Clique na barra de status ou na notificação para acionar o fluxo de login no terminal.

A barra de status mostra um ícone $(warning) ao lado do nome da sua conta.

A conta de extensão conectada é diferente da conta ativa da CLI gcloud.

Execute gcloud auth login e gcloud auth application-default login com a mesma conta usada para fazer login Google Cloud.

A barra de status mostra um ícone $(warning).

As configurações de extensão, como ID do projeto, região ou ID do projeto de faturamento, não correspondem às configurações da CLI gcloud.

Clique no ícone de aviso na barra de status do projeto para sincronizar as configurações entre a extensão e a CLI gcloud. Como alternativa, atualize manualmente as configurações em qualquer uma das ferramentas para garantir que elas correspondam.

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

Tentativa de sincronizar as configurações enquanto as contas são inconsistentes.

Alinhe as contas entre a CLI gcloud e a extensão. Verifique se elas estão usando a mesma conta de usuário, projeto, região e projeto de faturamento.

Cannot sync settings: Google Cloud CLI is not installed.

Tentativa de sincronizar as configurações enquanto a CLI gcloud não está instalada.

Instale a CLI gcloud.

Erros de busca de API e do Explorer

A seguir, apresentamos erros gerais encontrados ao navegar pelos recursos do Cloud na árvore de menus do Google Cloud Data Agent Kit.

Mensagem de erro

Possível causa

Correção

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

O servidor não pode autorizar sua solicitação (HTTP 403 Forbidden código de status), não consegue encontrar os recursos (HTTP 404 Not Found código de status) ou a API não está ativada.

Verifique as permissões do Identity and Access Management (IAM) e se a API relevante como o BigQuery, está ativada nas configurações.

No Google Cloud project selected.

Um recurso foi acionado sem um projeto ativo.

Use o seletor de projetos na barra de status para selecionar um projeto.

Invalid table name format: ${tableName}

Convenção de nomenclatura incorreta (ID do projeto ou do conjunto de dados ausente).

Use o nome totalmente qualificado: project.dataset.table.

Erros do BigQuery e do Dataform

Os erros a seguir são específicos para transformações de SQL e gerenciamento de projetos do Dataform.

Mensagem de erro

Possível causa

Correção

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

O pacote npm Dataform não está instalado globalmente.

Clique em Install Dataform CLI na caixa de diálogo para automatizar a instalação.

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

Erros de sintaxe em arquivos .sqlx ou workflow_settings.yaml inválido.

Verifique a visualização Compiled Query do Dataform para erros de sintaxe específicos.

Failed to run Dataform project: ${message}

Falha na execução do job do BigQuery.

Analise o histórico de jobs do BigQuery para registros de execução detalhados.

No content found for saved query: ${label}

A entrada do Knowledge Catalog ou do BigQuery existe, mas não tem conteúdo NoSQL.

Verifique o conteúdo da consulta executando-a no Google Cloud console.

Erros do Serviço Gerenciado para Apache Spark e do Spark

Os erros a seguir estão relacionados ao gerenciamento de clusters e à execução do Spark.

Mensagem de erro

Possível causa

Correção

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

Permissões do IAM insuficientes ou cluster em transição.

Verifique se você tem o papel roles/dataproc.editor e se o status do cluster já é UPDATING.

Error: No cluster name found.

Erro de referência interna na visualização em árvore.

Atualize a visualização Spark Resource Explorer.

Failed to redirect to Spark UI: ${message}

O cluster está parado ou o gateway de componentes está desativado.

Inicie o cluster e verifique se o gateway de componentes está ativado na configuração do cluster.

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

Erro de API

Atualize a visualização Spark Resource Explorer.

Failed to start Jupyter process / Pip install failed.

Falha na inicialização do servidor Jupyter local ou na instalação dos pacotes necessários.

Abra um novo notebook do Spark com o kernel remoto.

No sample notebooks found for the selected kernel type.

Os notebooks de amostra para o tipo de kernel selecionado (local ou remoto) não estão disponíveis.

Não relevante

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

Isso é específico para usuários do Windows quando caminhos longos não estão ativados na máquina.

Ative caminhos longos consultando o link na notificação.

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

Isso aparece quando o usuário tenta usar um kernel remoto pela primeira vez.

Instale as dependências clicando na notificação e selecionando Sim na caixa de diálogo de confirmação.

Requires package installation

Mostrado na descrição do seletor de kernel ao lado de Kernel remoto se as dependências do Jupyter estiverem ausentes.

Instale as dependências clicando na notificação e selecionando Sim na caixa de diálogo de confirmação.

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

Mostrado na descrição do seletor de kernel quando o usuário executa um notebook existente no Kernel remoto.

Instale as dependências clicando na notificação e selecionando Sim na caixa de diálogo de confirmação.

Erros do Cloud Storage

Os erros a seguir são exibidos ao gerenciar buckets e objetos.

Mensagem de erro

Possível causa

Correção

A folder with the name... already exists.

Conflito de nomenclatura no bucket.

Escolha um nome de pasta exclusivo.

Upload/Download failed: ${message}

Permissão negada ou tempo limite de rede.

Verifique os papéis Storage Object Admin ou Creator.

Failed to create bucket: ${message}

O nome já foi usado globalmente ou contém caracteres inválidos.

Siga as regras de nomenclatura de bucket do Cloud Storage.

Erros genéricos de interface

Esses erros indicam falhas no nível da UI.

Mensagem de erro

Possível causa

Correção

No workspace folder open.

O usuário está no modo Sem pasta no Antigravity.

Abra uma pasta usando File > Open Folder.

No active notebook editor found.

Você está executando comandos do Spark ou SQL sem um notebook aberto.

Abra um arquivo .ipynb ou .sql.

Cannot insert item: unsupported resource type.

Tentativa de arrastar e soltar um recurso que tem representação de string NoSQL.

Somente tabelas, visualizações e colunas podem ser inseridas em editores.

Erros de banco de dados

Os erros a seguir são retornados ao consultar Google Cloud bancos de dados.

AlloyDB

Mensagem de erro

Possível causa

Correção

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

O usuário conectado à extensão não foi adicionado como um usuário do IAM à instância.

Consulte Gerenciar a autenticação do IAM para adicionar o usuário como um usuário do IAM.

postgresql error: permission denied for table [TABLE_NAME]

O usuário do IAM não tem permissão para o objeto.

Consulte Conceder permissões de banco de dados adequadas aos usuários do IAM para conceder permissão ao usuário do IAM para o objeto.

Cloud SQL para MySQL

Mensagem de erro Possível causa Correção
Invalid request: Some of your SQL statements failed to execute. Details: Error 1045 (28000): Access denied for user '[USER]'@'localhost' (using password: YES). O usuário conectado à extensão não foi adicionado como um usuário do IAM à instância. Consulte Autenticação do IAM para adicionar o usuário como um usuário do IAM para a instância.
Invalid request: Some of your SQL statements failed to execute. Details: Error 1044 (42000): Access denied for user '[USER]'@'%' to database '[DB_NAME]'. O usuário do IAM não tem permissão para acessar o banco de dados. Consulte Conceder privilégios de banco de dados a um usuário individual do IAM ou a uma conta de serviço para conceder privilégios aos usuários do IAM para o banco de dados .
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" }}. O acesso à API de dados não está ativado. Ative o acesso à API de dados nas configurações de consulta ou consulte Executar instruções SQL usando a API de dados do Cloud SQL para ativá-lo no Google Cloud console ou na CLI gcloud.
Invalid request: IAM authentication is not enabled for the instance [PROJECT_ID]:[INSTANCE_NAME]. A flag de autenticação do IAM não está ativada. Ative a flag de autenticação do IAM nas configurações de consulta ou consulte Autenticação do IAM para ativá-la no Google Cloud console ou na CLI gcloud.

Cloud SQL para PostgreSQL

Mensagem de erro Possível causa Correção
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" }}. O acesso à API de dados não está ativado. Ative o acesso à API de dados nas configurações de consulta ou consulte Executar instruções SQL usando a API de dados do Cloud SQL para ativá-lo no Google Cloud console ou na CLI gcloud.
Invalid request: IAM authentication is not enabled for the instance [PROJECT_ID]:[INSTANCE_NAME]. A flag de autenticação do IAM não está ativada. Ative a flag de autenticação do IAM nas configurações de consulta ou consulte Autenticação do IAM para ativá-la no Google Cloud console ou na CLI gcloud.
Invalid request: Some of your SQL statements failed to execute. Details: pq: password authentication failed for user "[USER_EMAIL]". O usuário conectado à extensão não foi adicionado como um usuário do IAM à instância. Consulte Autenticação do IAM para adicionar o usuário como um usuário do IAM para a instância.
Execution failed. All statements are aborted. Details: pq: permission denied for table [TABLE_NAME] O usuário do IAM não tem permissão para acessar o objeto. Consulte Gerenciar usuários com a autenticação de banco de dados do IAM para conceder privilégios aos usuários do IAM para o banco de dados.

Spanner

Mensagem de erro

Possível causa

Correção

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

Tamanhos de resultado maiores que 10,00 MiB não são aceitos.

Consulte executeSql.

A seguir