Gmail インジェストのトラブルシューティング
このページでは、 Databricks Lakeflow Connect の Gmail インジェスト コネクタに関する一般的な問題とその解決方法について説明します。
ベータ版
この機能はベータ版です。ワークスペース管理者は、 プレビュー ページからこの機能へのアクセスを制御できます。Databricksのプレビューを管理するを参照してください。
すべてのマネージド インジェスト パイプラインに適用される一般的なトラブルシューティングのガイダンスについては、マネージド インジェスト パイプラインのトラブルシューティングを参照してください。
認証エラー (401)
401応答は、コネクタがサービスアカウントを使用してGmailに対して認証できなかったことを意味します。以下を確認してください：
- Unity Catalog 接続を作成した際に、完全で変更されていないサービスアカウントの JSON キーを貼り付けたことを確認してください。キーが切り詰められているか、形式が正しくない場合、認証は失敗します。
- Google管理コンソールで、サービスアカウントに対して
https://www.googleapis.com/auth/gmail.readonlyスコープのドメイン全体の委任が承認されていることを確認してください。ドメイン全体の委任の許可 を参照してください。 - なりすましているメールボックスが存在し、サービスアカウントが権限を委任するGoogle Workspaceドメイン内にあることを確認してください。
- サービスアカウントキーをローテーションまたは削除した場合は、新しいキーを作成して接続を更新してください。
クォータまたはレート制限エラー（429または403）
Gmailは、ユーザーごとおよびプロジェクトごとのAPIクォータを適用します。GmailがHTTP 403レスポンスを返すと、コネクタは Retry-After ヘッダーを読み取り（最小バックオフは1秒）、自動的にリクエストを再試行するため、一時的なレート制限は通常、操作なしで解決します。
パイプラインでクォータエラーが継続して発生する場合：
- APIの使用量を減らすには、パイプラインのスケジュール頻度を下げてください。
- Google Cloud コンソールの [ APIs & Services > Quotas ] で、Gmail API が有効になっていること、および Google Cloud プロジェクトの割り当てが十分であることを確認します。
historyIdの有効期限
messages テーブルと message_labels テーブルは、増分同期のために保存された historyId カーソルを使用します。パイプラインの実行頻度が Gmail の履歴保持期間よりも低い場合、Gmail はカーソルを期限切れにし、History API は 404 を返します。この場合、コネクタは影響を受けるテーブルのフル更新に自動的にフォールバックするため、操作は不要です。フルリフレッシュを回避するには、カーソルが Gmail の保持期間内に収まるよう、十分な頻度でパイプラインを実行するようにスケジュールしてください。
サポートを求める
これらのトラブルシューティングステップに従っても問題が解決しない場合は、サポートチケットを提出してください。