Solução de problemas de ingestão do Jira
Beta
O conector Jira está em versão Beta.
Esta página descreve problemas comuns com o conector Jira no Databricks LakeFlow Connect e como resolvê-los.
falhas de conexão locais
Se a sua conexão on-premises falhar ou a ingestão de dados falhar com um erro de endereço inacessível, certifique-se de que os endereços IP Databricks estejam na lista de permissões do seu firewall.
Solução de problemas pipeline em dutos
Se um pipeline falhar durante a execução, clique na etapa que falhou e confirme se a mensagem de erro fornece informações suficientes sobre a natureza do erro.
Você também pode verificar e download os logs cluster na página de detalhes pipeline , clicando em Atualizar detalhes no painel direito e, em seguida, em Logs . Analise os logs em busca de erros ou exceções.
Códigos de erro comuns
403 Não autorizado
Resolução :
Verifique novamente os escopos do seu aplicativo OAuth. Certifique-se de que seu aplicativo OAuth inclua todos os escopos necessários para as tabelas que você está tentando importar dados. Consulte as tabelas de origem suportadas para obter uma lista completa dos escopos necessários.
401 Não autenticado
Resolução :
Reautentique sua conexão Unity Catalog . Suas credenciais OAuth podem ter expirado ou sido revogadas.
Após autenticar-se no Jira, você verá a tela "Tente fazer login novamente".
Após autenticar com o Jira, você vê uma tela "Tente fazer login novamente", que logs no Jira com sucesso, mas nunca redireciona de volta para Databricks.
Resolução :
- Verifique se o URI de redirecionamento configurado no aplicativo Jira OAuth corresponde exatamente ao caminho de redirecionamento workspace :
https://<databricks_workspace_URL>/login/oauth/lakehousefederation.html - Não clique em "Tentar iniciar sessão novamente" . Isso logs você acesse a interface do Jira em vez de ser redirecionado para o Databricks. Em vez disso, feche a janela e reinicie o fluxo OAuth na interface do usuário do Databricks após corrigir o URI de redirecionamento.
- Se o problema persistir, confirme se o aplicativo Jira tem os escopos necessários:
read:jira-work,read:jira-user, além dos escopos de leitura granulares listados em Configurar o Jira para ingestão.
Erros de permissão
Erro :
Access denied to Jira project or issue.
Resolução :
- Confirme se a account de usuário tem permissão para navegar em projetos para os projetos que você está tentando importar.
- Verifique as permissões do projeto no Jira acessando Configurações do projeto > Permissões .
- Se você estiver usando uma account de serviço, verifique se ela possui as permissões adequadas.
- Algumas questões podem ter restrições de segurança. Verifique as permissões de cada tarefa na interface do Jira.
erros de limite de taxa
Erro :
Jira API rate limit exceeded.
Resolução :
- O conector Jira tenta novamente automaticamente com recuo exponencial quando os limites de taxa são atingidos.
- Se os erros de limite de taxa persistirem, considere a execução pipeline programático fora dos horários de pico.
- Para instâncias grandes do Jira, pode ser necessário aumentar o intervalo de tempo entre as execuções pipeline .
- Entre em contato com o suporte da Atlassian se precisar aumentar seus limites de taxa de API.
Problemas não resolvidos ou dados incompletos
Emitir :
Alguns problemas não estão aparecendo nos dados ingeridos, ou os dados parecem incompletos.
Resolução :
- Verifique se os problemas existem no projeto Jira de origem e se não estão arquivados.
- Confirme se a account de usuário tem acesso a todas as tarefas do projeto.
- Verifique se os campos personalizados estão configurados corretamente em sua instância do Jira.
- Verifique os logs de eventos pipeline em busca de avisos ou erros relacionados a problemas específicos.
Erros de projeto não encontrado
Erro :
Jira project not found: <PROJECT_KEY>
Resolução :
- Verifique se a key do projeto está correta. A chave do projeto diferencia maiúsculas de minúsculas.
- Verifique se o projeto existe e está ativo (não arquivado) em sua instância do Jira.
- Confirme se a account de usuário tem acesso ao projeto.
- Tente acessar o projeto diretamente no seu navegador:
https://your-domain.atlassian.net/browse/<PROJECT_KEY>
desempenho de ingestão lenta
Emitir :
A execução dos pipelines está demorando mais do que o esperado.
Resolução :
- A execução inicial pipeline (instantâneo completo) normalmente leva mais tempo do que a execução incremental.
- Projetos com extenso fluxo de trabalho história ou muitos campos personalizados podem retardar a ingestão.
- Verifique se você está atingindo os limites de taxa API do Jira revisando os logs pipeline .
- Considere importar projetos específicos em vez de todos os projetos para reduzir o volume de dados.
- Se os problemas de desempenho persistirem, crie um ticket de suporte.
erros de autenticação OAuth
Emitir :
O pipeline estava funcionando, mas de repente começou a falhar com erros de autenticação.
Resolução :
- O conector atualiza automaticamente tokens OAuth quando eles estão próximos do vencimento. Se os erros de autenticação persistirem, o problema pode estar relacionado à configuração ou revogação do aplicativo OAuth.
- Verifique se seu aplicativo OAuth ainda está ativo e não foi revogado no Console do Desenvolvedor da Atlassian.
- Se necessário, autentique novamente a conexão do Unity Catalog refazendo o fluxo OAuth.
- Tente novamente o pipeline.
Seleção de colunas usando Databricks Ativo Bundles
Emitir :
Não é possível usar o recurso de seleção de coluna ao criar um pipeline de ingestão gerenciada usando Databricks Ativo Bundles.
Resolução :
Verifique a versão do Databricks CLI. Se a versão for inferior a v0.251.0, Reinstale a CLI.
Precisa de mais ajuda?
Se você encontrar um problema que não esteja abordado neste guia de solução de problemas, crie um ticket de suporte.