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

Google アナリティクス集計コネクターのトラブルシューティング

備考

ベータ版

この機能はベータ版です。使用するには、ワークスペース管理者は、 プレビューページ から Google アナリティクス Aggregated向けLakeflow Connect を有効にする必要があります。Databricksのプレビューを管理するを参照してください。

Lakeflow Connectのマネージド Google アナリティクス 集計 コネクタからの権限(403)、要求(400)、有効期限切れのトークン(401)、クォータ(429)、および一時的なサーバー エラーを解決します。

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

アクセスが拒否されました (403)​

エラーメッセージ:

パイプラインがHTTP 403応答で失敗し、エラーが設定エラーとして分類されます。

原因： 認証された ID が Google アナリティクス 4 (GA4) プロパティにアクセスできないか、認証情報を所有する Google Cloud プロジェクトで Google アナリティクス Data API が有効になっていません。

ソリューション：

  1. Google Cloud プロジェクトで Google アナリティクス Data API が有効になっていることを確認します。Google アナリティクス Data API を有効にするを参照してください。
  2. IDにproperty_idsまたはproperty_idの各プロパティに対する少なくとも 閲覧者 ロールがあることを確認してください。
    • 独自のIDを使用するサービスアカウントの場合、サービスアカウントのEメールアドレスを各プロパティに追加します。サービス アカウントにプロパティへのアクセス権を付与するを参照してください。
    • ドメイン全体の委任を使用するサービスアカウントの場合、 なりすますユーザーのEメール ユーザーが各プロパティにアクセスできること、および https://www.googleapis.com/auth/analytics.readonly スコープがサービスアカウントのクライアントIDに対して承認されていることを確認します。
    • OAuthユーザー対マシン（U2M）認証では、サインインしたユーザーが各プロパティにアクセスできることを確認してください。

資格情報を更新するには、カタログエクスプローラ で接続を編集します。「Google アナリティクス 集計接続を作成する」を参照してください。

無効なリクエスト（400）​

エラーメッセージ:

パイプラインがHTTP 400応答で失敗し、エラーが設定エラーとして分類されます。

原因: Google アナリティクス Data API がレポート要求を拒否しました。一般的な原因としては、数値ではないプロパティ ID、または dimensions と metrics に不明な API 名や互換性のない組み合わせが含まれているカスタム レポートがあります。

ソリューション：

  • 各プロパティ ID が数値の GA4 プロパティ ID であることを確認します。Google ドキュメントの「 プロパティ ID 」を参照してください。
  • custom_report オブジェクトの場合、dimensions と metrics の各値が API ディメンションとメトリクス にリストされている有効な API 名であることを確認します。メソッド: properties.checkCompatibility で組み合わせを確認します。
  • dimensions、metrics、および property_ids が JSON 配列文字列であること（例: '["country"]'）を確認します。例を参照してください。

アクセストークンの有効期限が切れました（401）​

エラーメッセージ:

パイプラインが失敗しました。HTTP 401レスポンスが返されました。

原因: 接続で使用しているアクセストークンが期限切れになっているか、取り消されています。

ソリューション：

コネクタは、401レスポンスを受け取ると、アクセストークンを自動的に更新し、再試行します。エラーが続く場合：

  • OAuth U2M接続の場合は、カタログエクスプローラーで接続を編集し、サインインフローをもう一度完了して再認証します。OAuthアプリが 外部 ユーザータイプと テスト 公開ステータスを使用している場合、Google更新トークンは7日後に期限切れになります。OAuth同意画面の設定を参照してください。
  • サービス アカウント接続の場合は、接続内のサービス アカウント キーが Google Cloud コンソールに存在することを確認してください。キーが削除されている場合は、キーを作成して接続を更新してください。

クォータの枯渇（429）​

エラーメッセージ:

パイプラインは、Google アナリティクス Data API からの HTTP 429 応答をレポートします。

原因： パイプラインが、1時間あたりのトークン数や並列リクエスト数など、プロパティのData APIクォータのいずれかを使用しきりました。

ソリューション：

コネクタは、レート制限のあるリクエストを自動的にバックオフして再試行します。パイプラインの失敗が続く場合は、単一のパイプライン内のテーブルまたはプロパティの数を減らす、より遅い start_date を設定する、またはパイプラインのランを頻繁にスケジュールしないようにします。クォータの制限については、 Google ドキュメントの 「制限とクォータ」を参照してください。

一時的なサーバー エラー (500, 502, 503, 504)​

エラーメッセージ:

パイプラインが HTTP 500、502、503、または 504 応答で失敗しました。

原因: Google アナリティクス データ API が、認証情報やパイプライン構成に関連のない一時的なサーバーエラーを返しました。

ソリューション：

コネクタは、一時的なエラーをエクスポネンシャル バックオフで自動的に再試行します。再試行後もパイプラインが失敗し続ける場合は、後でパイプラインを再実行してください。

このページの見出し