メインコンテンツまでスキップ
に最終更新

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

備考

ベータ版

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

このページでは、マネージド Google Workspace コネクタで発生する可能性のある一般的なエラーとその解決方法について説明します。

すべての管理対象インジェスト パイプラインに適用される一般的なトラブルシューティング ガイダンスについては、「管理対象インジェスト パイプラインのトラブルシューティング」を参照してください。

トークンの生成に失敗しました（エラー：invalid_scope） または unauthorized_client​

原因: OAuth トークンに対して要求されたスコープが、Google ワークスペース管理者コンソールまたは OAuth 同意画面で承認されたスコープと一致しません。Google は、invalid_scope または unauthorized_client によるトークンの発行を拒否します。

ソリューション:

  1. Google Workspace 管理コンソールで、 [セキュリティ] > [アクセスとデータ制御] > [API の制御] （または組織の対応する OAuth 管理インターフェイス）に移動します。
  2. 接続からの OAuth クライアントが https://www.googleapis.com/auth/admin.reports.audit.readonly スコープに対して承認されていることを確認します。
  3. Unity Catalog 接続の OAuth スコープ が許可されたスコープと完全に一致していることを確認します：https://www.googleapis.com/auth/admin.reports.audit.readonly。

詳しくは、Google Workspace への認証の構成を参照してください。

パイプラインの認証に失敗しました​

原因： Google ワークスペースが、レートリミット応答ではない HTTP 403 応答を返しました。通常、これは OAuth トークンが無効である、有効期限が切れている、またはスコープが適切に承認されていないことを意味します。コネクタはこれを設定エラーとして扱い、パイプラインを失敗させます。

ソリューション:

  1. Unity Catalog 接続内の Client ID 、 Client Secret 、 Authorization Endpoint 、および Token Endpoint が正しいこと、および Google Cloud プロジェクトで作成された OAuth クライアントと一致していることを確認します。
  2. OAuthスコープ が正確に https://www.googleapis.com/auth/admin.reports.audit.readonly であることを確認します。
  3. トークンの有効期限が切れている場合は、新しい認証フローをtriggerして新しいトークンを取得します。

詳しくは、Google Workspace への認証の構成を参照してください。

Google ワークスペース API のレート制限を超えました​

Cause： コネクタが短期間に多数のリクエストを送信したため、Google ワークスペース から HTTP 429 応答、または rateLimitExceeded または userRateLimitExceeded の理由を示す HTTP 403 応答が返されました。

ソリューション:

コネクタは Retry-After 応答ヘッダーを反映し、その後エクスポネンシャルバックオフにフォールバックして自動的に再試行します。これが繰り返し発生する場合は、パイプラインのスケジュールの頻度、または同じ Google ワークスペースアカウントを共有する並列パイプラインの数を減らしてください。

Google ワークスペース API は一時的に利用できません​

原因： Google ワークスペース が一時的なサーバーエラー（HTTP 500、502、503、または 504）を返しました。

ソリューション:

コネクタは、エクスポネンシャル バックオフを使用して自動的に再試行します。問題が解決しない場合は、しばらく待ってからパイプラインをもう一度実行してください。

このページの見出し