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.

Para obter orientação geral sobre solução de problemas que se aplica a todos os pipelines de ingestão gerenciados, consulte Solucionar problemas de pipelines de ingestão gerenciados.

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.
• Para sincronizar uma subpasta aninhada, especifique seu caminho completo a partir da raiz da caixa de correio usando / como separador, por exemplo Inbox/Projects/2026. Cada segmento deve corresponder a um nome de exibição de pasta nesse nível da hierarquia. Se um nome de pasta contiver um /, faça o escape dele como \/.
• Se uma pasta especificada ou qualquer segmento de um caminho aninhado não existir em uma caixa de correio, o conector ignorará silenciosamente essa entrada. Verifique os logs do pipeline para 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.