Pular para o conteúdo principal
Última atualização em

Solução de problemas de ingestão do Confluence

info

Visualização

O conector do Confluence está em versão Beta.

Esta página descreve problemas comuns com o conector do Confluence no Databricks LakeFlow Connect e como resolvê-los.

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.

Visualizar o registro de eventos pipeline na interface do usuário.

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.

Visualize os detalhes da atualização pipeline na interface do usuário.

Erros de autenticação​

Erro :

The user does not have access to the specified site 'https://your-domain.atlassian.net' with the given token, or the URL is incorrect. Please verify the URL and the OAuth token's permissions.

Resolução :

  1. Verifique os escopos OAuth concedidos no aplicativo OAuth.
  2. Verifique se o URL da sua instância do Confluence está correto e inclui o domínio completo (por exemplo, https://your-domain.atlassian.net).

erros de limite de taxa​

Erro :

Confluence API rate limit exceeded.

Resolução :

  1. O conector Confluence tenta novamente automaticamente com recuo exponencial quando os limites de taxa são atingidos.
  2. Se os erros de limite de taxa persistirem, considere a execução pipeline programático fora dos horários de pico.
  3. Para instâncias grandes do Confluence, pode ser necessário aumentar o intervalo de tempo entre as execuções pipeline .
  4. Entre em contato com o suporte da Atlassian se precisar aumentar seus limites de taxa da API. Erros de espaço não encontrado

Páginas em falta ou dados incompletos​

Problema : Algumas páginas não estão aparecendo nos dados importados, ou os dados aparecem incompletos.

Resolução :

  1. Verifique se as páginas existem no espaço Confluence de origem e se não estão arquivadas. Páginas arquivadas não são suportadas.
  2. Verifique se as páginas não estão em estado de rascunho. Somente as páginas publicadas são consideradas.
  3. Confirme se a account de usuário tem acesso de leitura a todas as páginas do espaço.
  4. Verifique os logs de eventos pipeline em busca de avisos ou erros relacionados a páginas específicas.

desempenho de ingestão lenta​

Emitir :

A execução dos pipelines está demorando mais do que o esperado.

Resolução :

  1. A execução inicial pipeline (instantâneo completo) normalmente leva mais tempo do que a execução incremental.
  2. Páginas grandes com conteúdo extenso ou muitos anexos podem tornar o carregamento mais lento.
  3. Verifique se você está atingindo os limites de taxa API do Confluence revisando os logs pipeline .
  4. Se os problemas de desempenho persistirem, crie um ticket de suporte.

expiração dos tokens de atualização​

Emitir :

O pipeline estava funcionando, mas de repente começou a falhar com erros de autenticação.

Resolução :

  1. Verifique os escopos OAuth concedidos no aplicativo OAuth.
  2. Atualize a conexão.
  3. 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.