Resolver problemas

Este documento lista os erros visíveis capturados e apresentados pela extensão do IDE do Data Agent Kit. Esses erros geralmente são mostrados como Notificações (pop-ups) ou como Avisos da 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 fundamental 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 ambiente de desenvolvimento integrado.

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 o gcloud auth login e o 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. 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 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 as configurações sem a CLI gcloud instalada.

Instale a CLI gcloud.

Erros do Explorer e de busca da API

Confira abaixo alguns erros gerais encontrados ao navegar pelos recursos da nuvem na árvore de menus do Google Cloud Data Agent Kit.

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 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 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 ver 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 .

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

Remediação

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

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

Verifique se você tem a função 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 componente 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.

A inicialização do servidor Jupyter local ou a instalação dos pacotes necessários falhou.

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 your IDE 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 caminhos longos usando 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

Mostrado na descrição do seletor de kernel quando o usuário executa um notebook 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.

Colisão 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}

O nome já foi usado globalmente ou tem 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 ambiente de desenvolvimento integrado.

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).
  • Para a autenticação de banco de dados do IAM: o usuário conectado à extensão não foi adicionado como usuário do IAM à instância.
  • Para autenticação integrada do banco de dados: o secret regional ou a versão do secret selecionada no Secret Manager não corresponde à senha do usuário do banco de dados.
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 banco de dados 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 ou Configurar o usuário do banco de dados para conceder privilégios ao banco de dados.
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). A conta conectada à extensão não tem permissão para acessar a versão do secret regional no Secret Manager ou a versão do secret não existe. Verifique se o secret regional e a versão do secret selecionados nas configurações de consulta existem. Em seguida, conceda o papel Secret Manager Secret Accessor (roles/secretmanager.secretAccessor) à sua conta. Consulte Papéis ou permissões necessários na documentação da API de dados do Cloud SQL.
Invalid request: Secret fetched from Secret Manager is empty A versão do secret regional selecionada não contém uma senha. Adicione uma nova versão do Secret que contenha a senha do usuário do banco de dados e selecione-a nas configurações de consulta.
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]".
  • Para a autenticação de banco de dados do IAM: o usuário conectado à extensão não foi adicionado como usuário do IAM à instância.
  • Para autenticação integrada do banco de dados: o secret regional ou a versão do secret selecionada no Secret Manager não corresponde à senha do usuário do banco de dados.
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). A conta conectada à extensão não tem permissão para acessar a versão do secret regional no Secret Manager ou a versão do secret não existe. Verifique se o secret regional e a versão do secret selecionados nas configurações de consulta existem. Em seguida, conceda o papel Secret Manager Secret Accessor (roles/secretmanager.secretAccessor) à sua conta. Consulte Papéis ou permissões necessários na documentação da API de dados do Cloud SQL.
Invalid request: Secret fetched from Secret Manager is empty A versão do secret regional selecionada não contém uma senha. Adicione uma nova versão do Secret que contenha a senha do usuário do banco de dados e selecione-a nas configurações de consulta.
Execution failed. All statements are aborted. Details: pq: permission denied for table [TABLE_NAME] O usuário do banco de dados não tem permissão para acessar o objeto. Consulte Gerenciar usuários com a autenticação de banco de dados do IAM ou Configurar o usuário do banco de dados para conceder privilégios ao 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.

Não é possível usar resultados maiores que 10 MiB.

Consulte executeSql.

A seguir