Outlookコネクタのトラブルシューティング

備考

ベータ版

この機能はベータ版です。ワークスペース管理者は、 プレビュー ページからこの機能へのアクセスを制御できます。Databricksのプレビューを管理するを参照してください。

このページでは、 Databricks LakeFlow Connectの Outlook コネクタでよく発生する問題とその解決方法について説明します。

パイプラインの一般的なトラブルシューティング

パイプラインの実行中にエラーが発生した場合は、エラーが発生したステップをクリックし、エラーメッセージがエラーの内容について十分な情報を提供しているかどうかを確認してください。

右側のペインで [詳細の更新] をクリックし、 [ログ] を クリックして、パイプラインの詳細ページからクラスターログを確認してダウンロードすることもできます。ログをスキャンしてエラーや例外がないか確認してください。

問題：認証は成功しましたが、宛先テーブルにOutlookデータが表示されません。

解決：

アプリ登録に必要な Microsoft Graph API アプリケーション 権限 ( User.Read.AllまたはDirectory.Read.AllおよびMail.Read ) が付与されていること、および管理者の同意が得られていることを確認してください。
include_mailboxesで指定されているメールボックス（指定されている場合）が、アクティブなExchange Onlineメールボックスに対応していることを確認してください。
接続が正しいクライアントID、クライアントシークレット、およびクライアントIDで作成されたことを確認してください。カタログエクスプローラーで接続を編集して確認してください。

問題：パイプラインが権限不足エラーで失敗します。

解決：

アプリ登録時に、委任されたアクセス許可ではなく、適切な Microsoft Graph API アプリケーションアクセス 許可が付与されていることを確認してください。
Azure ポータルで、管理者が必要な権限に対して 「管理者の同意を付与する」 をクリックしたことを確認してください。

問題：コネクタが1つ以上のメールボックスに対してMailboxNotEnabledForRESTAPIエラーを報告します。

解決：

このエラーは、メールボックスがMicrosoft Graph REST APIに対応していないことを示しています。これは通常、オンプレミスのメールボックス、またはExchange Onlineに移行されていないメールボックスで発生します。コネクタはこれらのメールボックスを自動的に警告付きでスキップし、残りのメールボックスの取り込みを続行します。

問題：パイプラインがトークンの有効期限切れまたは無効なクライアントシークレットエラーで失敗します。

解決：

Microsoft Entra ID のクライアントシークレットには有効期限があります。秘密の有効期限が切れた場合：
1. アプリ登録の 「証明書とシークレット」 でクライアントシークレットを作成します。
2. Databricks の接続情報を新しいクライアントシークレット値で更新してください。

コネクタは、Microsoft Graph API から HTTP 401 レスポンスを受信すると、OAuth トークンの更新を自動的に試みます。

問題： include_foldersで指定されたフォルダからのメールが宛先テーブルに表示されません。

解決：

フォルダーのマッチングでは大文字と小文字は区別されませんが、フォルダー名はOutlookに表示される名前と完全に一致している必要があります。対象のメールボックスの表示名を確認してください。
指定されたフォルダがメールボックス内に存在しない場合、コネクタはそれを黙ってスキップします。パイプラインログでスキップ警告を確認してください。

このトラブルシューティングガイドに記載されていない問題が発生した場合は、サポートチケットを作成してください。