Pular para o conteúdo principal

Solucionar problemas do conector Glean

info

Beta

Esse recurso está em Beta. Os administradores do workspace podem controlar o acesso a esse recurso na página Pré-visualizações . Consulte Gerenciar prévias do Databricks.

Esta página descreve erros comuns que o senhor pode encontrar com o conector Glean gerenciado e como resolvê-los.

Para obter orientações gerais de solução de problemas aplicáveis a todos os pipelines de ingestão gerenciados, consulte Solucionar problemas de pipelines de ingestão gerenciados.

Falha na autenticação do pipeline

Causa: O Glean retornou uma resposta HTTP 401 ou HTTP 403 que não é uma resposta de limite de taxa. Isso geralmente significa que o token da API é inválido, o token não possui o escopo para a tabela que está sendo ingerida ou o Subdomínio não corresponde à implantação que emitiu o token. O conector trata isso como um erro de configuração e falha no pipeline.

soluções:

  1. Confirme se o token de API na conexão do Unity Catalog é válido e não foi revogado.
  2. Confirme se o token contém os escopos percepções e Shortcuts. Um token sem um escopo falha apenas para a tabela que precisa dele.
  3. Confirme se o Subdomain na conexão do Unity Catalog corresponde à implantação que emitiu o token.

Para obter detalhes, consulte Configurar autenticação para o Glean.

Limite de taxa da API Glean excedido

Causa: O Glean retornou uma resposta HTTP 429 porque o conector enviou muitas solicitações em um curto período.

soluções:

O conector respeita o cabeçalho de resposta Retry-After, então recorre ao backoff exponencial e tenta novamente de forma automática. Se isso acontecer repetidamente, reduza a frequência de agendamento do pipeline ou o número de pipelines concorrentes que compartilham a mesma implantação do Glean.

A API Glean está temporariamente indisponível

Causa: O Glean retornou um erro de servidor transitório (HTTP 500, 502, 503 ou 504).

soluções:

O conector realiza novas tentativas automaticamente com backoff exponencial. Se o problema persistir, aguarde e, em seguida, execute o pipeline novamente.