Solucionar problemas do conector do Outlook

info

Beta

Este recurso está em versão Beta. Os administradores do espaço de trabalho podem controlar o acesso a este recurso na página de Pré-visualizações . Veja as prévias do Gerenciador Databricks.

Esta página descreve problemas comuns com o conector do Outlook 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.

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.

Autenticado, mas os dados do Outlook não estão visíveis.

Problema : A autenticação foi bem-sucedida, mas nenhum dado do Outlook aparece na tabela de destino.

Resolução :

• Confirme se o registro do aplicativo tem as permissões de aplicativo API gráfica Microsoft necessárias (User.Read.All ou Directory.Read.All e Mail.Read) e se o consentimento do administrador foi concedido.
• Confirme se as caixas de correio especificadas em include_mailboxes (se fornecidas) correspondem a caixas de correio ativas do Exchange Online.
• Confirme se a conexão foi criada com o ID do cliente, o segredo do cliente e o ID do locatário corretos. Edite a conexão no Explorador de Catálogo para verificar.

Erro de privilégios insuficientes

Problema : O pipeline falha devido a um erro de privilégios insuficientes.

Resolução :

• Confirme se o registro do aplicativo possui as permissões corretas da API gráfica Microsoft , e não permissões delegadas.
• Confirme se um administrador clicou em "Conceder consentimento de administrador" para as permissões necessárias no portal do Azure.

MailboxNotEnabledForRESTAPI erro

Problema : O conector reporta um erro MailboxNotEnabledForRESTAPI para uma ou mais caixas de correio.

Resolução :

• Este erro indica que a caixa de correio não está habilitada para a API REST Microsoft Gráfico. Isso geralmente ocorre com caixas de correio on-premises ou caixas de correio que não foram migradas para o Exchange Online. O conector ignora automaticamente essas caixas de correio com um aviso e continua a ingestão para as caixas de correio restantes.

Erro de tokens expirados ou segredo do cliente inválido

Problema : O pipeline falha com um erro de token expirado ou segredo do cliente inválido.

Resolução :

• Os segredos do cliente no Microsoft Entra ID têm uma data de expiração. Se o segredo expirou:
  1. Crie um segredo do cliente no registro do aplicativo em Certificados e segredos .
  2. Atualize a conexão no Databricks com o novo valor do segredo do cliente.

O conector tenta refresh automaticamente os tokens OAuth quando recebe uma resposta HTTP 401 da API gráfica Microsoft .

As pastas especificadas não estão sendo importadas.

Problema : e-mails de uma pasta especificada em include_folders não estão aparecendo na tabela de destino.

Resolução :

• A correspondência de pastas não diferencia maiúsculas de minúsculas, mas o nome da pasta deve corresponder exatamente ao nome de exibição conforme aparece no Outlook. Verifique o nome de exibição na caixa de correio de destino.
• Se uma pasta especificada não existir em uma caixa de correio, o conector a ignorará silenciosamente. Verifique os logs pipeline em busca de avisos de omissão.

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.