Solucionar problemas do conector Celigo
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 os erros comuns que você pode encontrar com o conector gerenciado do Celigo e como resolvê-los.
Para obter diretrizes gerais de solução de problemas aplicadas 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 token da API não é válido, foi revogado ou não tem acesso à API de log de auditoria. O Celigo retorna HTTP 401 ou 403, e o conector falha no pipeline como um erro de configuração.
soluções:
Regenere um token de API com acesso total no integrator.io e atualize a conexão. Consulte Configure authentication to Celigo para tokens e Create a Celigo connection para atualizar as credenciais. Confirme se a Data Region da conexão corresponde à conta que emitiu o token.
O pipeline atingiu o limite de taxa
Cause: o Celigo limita a API do integrator.io e retorna HTTP 429. O conector respeita o cabeçalho Retry-After e tenta novamente de forma automática, de modo que a limitação transitória é resolvida sozinha. Um pipeline falha apenas quando a limitação é mantida ao longo das tentativas.
Para obter os limites de solicitação de API publicados da Celigo e o limite de tamanho de resposta por página, consulte a documentação de API pagination da Celigo.
soluções:
Reduza a frequência de ingestão do pipeline para que as execuções se sobreponham menos a outro tráfego da API do integrator.io. Consulte Tarefas comuns de manutenção de pipeline para ajustar o programar.
O pipeline falha com um erro de solicitação
Causa: A Celigo rejeita o intervalo de tempo da solicitação ou o cursor e retorna HTTP 422. Isso geralmente significa que a opção de conector start_datetime não é uma data e hora UTC válida no formato ISO-8601.
soluções:
Defina start_datetime como um valor UTC no formato ISO-8601, como 2026-01-01T00:00:00.000Z, ou remova-o para usar o backfill default de 365 dias. Consulte Opções do conector.