Resolver problemas

Neste documento, listamos os erros visíveis capturados e apresentados pela extensão Data Agent Kit para VS Code. Esses erros geralmente aparecem 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

Remediaçã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 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ã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 no Google Cloud.

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

As configurações da 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. Ou 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 configurações enquanto as contas estão inconsistentes.

Alinhe as contas entre a CLI gcloud e a extensão. Verifique se eles 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 configurações sem a CLI gcloud instalada.

Instale a CLI gcloud.

Erros do Explorer e de busca de API

Confira a seguir erros gerais encontrados ao navegar pelos recursos da nuvem na árvore de menus do kit de agente de dados do Google Cloud.

Mensagem de erro

Possível causa

Remediação

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

O servidor não pode autorizar sua solicitação (código de status HTTP 403 Forbidden), não consegue encontrar os recursos (código de status HTTP 404 Not Found) 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 escolher 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 das transformações de SQL e do gerenciamento de projetos do Dataform.

Mensagem de erro

Possível causa

Remediação

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

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

Clique em Instalar a CLI do Dataform 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 encontrar erros de sintaxe específicos.

Failed to run Dataform project: ${message}

Falha na execução do job do BigQuery.

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

No content found for saved query: ${label}

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

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

Managed Service for Apache Spark e erros do Spark

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

Mensagem de erro

Possível causa

Remediação

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

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

Verifique se você tem o papel de 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 do Explorador de recursos do Spark.

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 na API

Atualize a visualização do Explorador de recursos do Spark.

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 exemplo 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 VS Code to work with Spark Notebooks on remote kernels. Learn More

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

Ative os 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.

Clique na notificação e selecione Sim na caixa de diálogo de confirmação para instalar as dependências.

Requires package installation

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

Clique na notificação e selecione Sim na caixa de diálogo de confirmação para instalar as dependências.

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

Mostrada na descrição do seletor de kernel quando o usuário executa um notebook existente em Kernel remoto

Clique na notificação e selecione Sim na caixa de diálogo de confirmação para instalar as dependências.

Erros do Cloud Storage

Os seguintes erros aparecem ao gerenciar buckets e objetos.

Mensagem de erro

Possível causa

Remediação

A folder with the name... already exists.

Conflito de nomes no bucket.

Escolha um nome exclusivo para a pasta.

Upload/Download failed: ${message}

Permissão negada ou tempo limite da rede.

Verifique os papéis Storage Object Admin ou Creator.

Failed to create bucket: ${message}

Nome já usado globalmente ou caracteres inválidos.

Siga as regras de nomenclatura de buckets do Cloud Storage.

Erros genéricos de interface

Esses erros indicam falhas no nível da UI.

Mensagem de erro

Possível causa

Remediação

No workspace folder open.

O usuário está no modo Sem pasta no VS Code.

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 seguintes erros são retornados ao consultar bancos de dados Google Cloud .

AlloyDB

Mensagem de erro

Possível causa

Remediaçã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 Remediaçã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 na 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 no 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 Data não está ativado. Ative o acesso à API Data nas configurações de consulta ou consulte Executar instruções SQL usando a API Data do Cloud SQL para ativar no console Google Cloud 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 ativar no console Google Cloud ou na CLI gcloud.

Cloud SQL para PostgreSQL

Mensagem de erro Possível causa Remediaçã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 Data não está ativado. Ative o acesso à API Data nas configurações de consulta ou consulte Executar instruções SQL usando a API Data do Cloud SQL para ativar no console Google Cloud 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 ativar no console Google Cloud 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 na 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 no banco de dados.

Spanner

Mensagem de erro

Possível causa

Remediação

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

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

Consulte executeSql.

A seguir