Amplitudeコネクターのトラブルシューティング
ベータ版
この機能はベータ版です。ワークスペース管理者は、 プレビュー ページからこの機能へのアクセスを制御できます。Databricksのプレビューを管理するを参照してください。
このページでは、マネージド Amplitude コネクタで発生する可能性のある一般的なエラーとその解決方法について説明します。
すべてのマネージド インジェスト パイプラインに適用される一般的なトラブルシューティングのガイダンスについては、「マネージド インジェスト パイプラインのトラブルシューティング」を参照してください。
エクスポートウィンドウが大きすぎます
エラーメッセージ：
The Amplitude export window is too large (exceeded the 4GB limit or timed out). If you set request_time_range, lower it toward the PT2H minimum; if a single window still exceeds 4GB, export that data via the Amazon S3 destination instead.
原因: 単一の events エクスポートウィンドウが 4 GB を超えるデータを返したか、タイムアウトしました。エクスポートサイズが 4 GB を超えると、Amplitude は HTTP 400 を返します。
ソリューション:
各エクスポートウィンドウを縮小するには、eventsテーブルのrequest_time_rangeオプションをPT2Hの最小値に向けて下げます。コネクタオプションを参照してください。単一のウィンドウが依然として4 GBを超える場合は、代わりにAmplitude Amazon S3送信先を通じてそのデータをエクスポートしてください。
パイプラインの認証に失敗しました
原因： 接続に保存されている API キーまたはシークレットキーが無効であるか、そのキーに要求された Endpoint を呼び出す権限がありません。
ソリューション:
接続内のAPIキーとシークレットキーがアクティブなプロジェクトキーと一致していること、およびマネージャーまたは管理者がそれらを生成したことを確認してください。Amplitudeへの認証の構成を参照してください。Amplitudeはシークレットキーを保存しないため、キーをローテーションする場合は、新しいシークレットキーを生成して接続を更新してください。APIキーとシークレットキーの管理を参照してください。
コホートの取り込みがリクエスト制限に達しました
原因: Growth プランおよび Enterprise プランでは、Amplitude Behavioral Cohorts Download API は月間 500 リクエストに制限されています。cohorts テーブルを頻繁に更新すると、この制限に達する可能性があります。
ソリューション:
cohorts テーブルに対するパイプラインの更新頻度を減らします。Behavioral Cohorts APIを参照してください。