Google Drive Audit Logs コネクタのトラブルシューティング
ベータ版
この機能はベータ版です。ワークスペース管理者は、 プレビュー ページからこの機能へのアクセスを制御できます。Databricksのプレビューを管理するを参照してください。
このページでは、マネージド Google Drive Audit Logs コネクタで発生する可能性のある一般的なエラーとその解決方法について説明します。
すべてのマネージド インジェスト パイプラインに適用される一般的なトラブルシューティングのガイダンスについては、「マネージド インジェスト パイプラインのトラブルシューティング」を参照してください。
トークンの発行が失敗する原因: unauthorized_client
原因： 発行されたトークンに対して要求されたスコープが、 「ドメイン全体の委任の管理」 においてサービスアカウントのクライアントIDに対して承認されたスコープと一致しません。Googleは unauthorized_client を使用したトークンの発行を拒否します。
ソリューション:
- Google Workspace管理コンソールで、 セキュリティ > アクセスとデータ管理 > APIの制御 > ドメイン全体の委任を管理 に移動します。
- サービスアカウントのクライアントIDが
https://www.googleapis.com/auth/admin.reports.audit.readonlyスコープに対して承認されていることを確認してください。 - Unity Catalog 接続内の サービスアカウント JSON キー が同じサービスアカウントに属していることを確認します。
詳しくは、Google ワークスペース 認証の構成をご覧ください。
パイプラインの認証に失敗しました
原因： Google Workspace が、レート制限応答ではない HTTP 403 応答を返しました。これは通常、権限を借用した管理者に Reports 権限がないか、サービスアカウントに対してドメイン全体の委任が構成されていないことを意味します。コネクタはこれを構成エラーとして扱い、パイプラインを失敗させます。
ソリューション:
- Unity Catalog 接続内の Admin Eメール to Impersonate が、 Reports 権限を持つ管理者アカウントであることを確認します。
- サービスアカウントのクライアントIDに対して、audit-readonly スコープでのドメイン全体の委任が承認されていることを確認してください。
詳しくは、Google ワークスペース 認証の構成をご覧ください。
Google Workspace APIのレート制限を超過しました
原因： コネクタが短期間に過剰なリクエストを送信したため、Google ワークスペースがHTTP 429応答、またはrateLimitExceededもしくはuserRateLimitExceededの理由を含むHTTP 403応答を返しました。
ソリューション:
このコネクターは Retry-After 応答ヘッダーを尊重し、その後エクスポネンシャル バックオフにフォールバックして自動的に再試行します。これが繰り返し発生する場合は、パイプラインのスケジュール頻度、または同じ Google ワークスペース アカウントを共有する並列パイプラインの数を減らしてください。
Google ワークスペース API は一時的に使用できません
原因: Google ワークスペースが一時的なサーバーエラー（HTTP 500、502、503、または 504）を返しました。
ソリューション:
コネクタはエクスポネンシャル バックオフを使用して自動的に再試行します。問題が解決しない場合は、しばらく待ってからパイプラインを再度実行してください。