Google Search Console コネクタのトラブルシューティング
ベータ版
この機能はベータ版です。ワークスペース管理者は、 プレビュー ページからこの機能へのアクセスを制御できます。Databricksのプレビューを管理するを参照してください。
このページでは、管理されるGoogleサーチコンソールコネクタでよくあるエラーとその解決方法について説明します。
すべてのマネージド インジェスト パイプラインに適用される一般的なトラブルシューティングのガイダンスについては、「マネージド インジェスト パイプラインのトラブルシューティング」を参照してください。
Search アナリティクス の QPS クォータを超過しました
エラーメッセージ：
Google Search Console Search Analytics QPS quota exceeded. Retrying with backoff.
原因： パイプラインが短期間に Google Search Console Search アナリティクス API へリクエストを送信しすぎたため、Google のユーザー単位、秒単位の割り当て制限に達しました。
ソリューション:
このエラーが発生すると、コネクタはバックオフを使用して自動的に再試行します。パイプラインの失敗が続く場合は、単一のパイプラインで取り込まれるサイトURLまたはテーブルの数を減らすか、パイプラインのラン間のスケジュール間隔を長くして、APIリクエストの全体的なボリュームを削減してください。
アクセスが拒否されました (403)
エラーメッセージ：
パイプラインがHTTP 403応答で失敗し、そのエラーは設定エラーとして分類されます。
原因: 認証済みのアイデンティティ(サービスアカウントまたはOAuthユーザー)は、1つ以上のGoogleサーチコンソールプロパティに対して十分な権限を持っていません。これは、IDがプロパティの検証済み所有者または完全な権限を持つユーザーでない場合、あるいはドメイン全体の委任設定が誤っている場合に発生します。
ソリューション:
サービスアカウントのEメールまたはOAuthユーザーが、site_urlsで指定された各サイトURLに対して フル 権限を持っていることを確認してください。Google Search Consoleでアクセス権を付与する手順については、「Google Search Consoleへの認証を構成する」を参照してください。
ドメイン全体の委任が設定されたサービスアカウントを使用する場合は、以下を確認してください。
- 接続内の User Email to Impersonate (偽装するユーザーの E メール) フィールドでは、プロパティを所有しているか、プロパティへのフルアクセス権を持つアカウントを使用します。
https://www.googleapis.com/auth/webmasters.readonlyスコープは、サービスアカウントのクライアントIDに対して Google ワークスペース 管理コンソールで承認されています。
認証情報を更新するには、カタログエクスプローラ で接続を編集します。Google Search Console 接続の作成を参照してください。
アクセストークンの有効期限が切れました (401)
エラーメッセージ：
パイプラインがHTTP 401応答で失敗します。
原因: 接続で使用されたアクセストークンの有効期限が切れたか、取り消されました。
ソリューション:
コネクターは401応答を受信すると自動的にOAuthトークンを更新します。エラーが続く場合は、更新トークンが取り消された可能性があります。カタログエクスプローラーで接続を編集し、再度サインインフローを完了することで、再認証を行ってください。「 Google Search Console 接続を作成する」をご覧ください。
サービスアカウント接続の場合は、接続内のサービスアカウントキー JSON が有効であり、Google Cloud コンソールで削除されていないことを確認してください。必要に応じて新しいキーをdownloadし、接続を更新してください。
一時的なサーバーエラー (500、502、503、504)
エラーメッセージ：
パイプラインが HTTP 500、502、503、または 504 レスポンスで失敗します。
原因: Google Search Console API が一時的なサーバーエラーを返しました。これらのエラーは一時的なものであり、資格情報やパイプライン設定とは無関係です。
ソリューション:
コネクタは、一時的なエラーに対してエクスポネンシャル バックオフを使用して自動的に再試行します。再試行後もパイプラインが失敗し続ける場合は、Google ワークスペース ステータス ダッシュボードで Google Search Console の進行中のインシデントがないか確認してください。インシデントが報告されていない場合は、パイプラインを手動で再実行してください。