Glean コネクタのトラブルシューティング
ベータ版
この機能はベータ版です。ワークスペース管理者は、 プレビュー ページからこの機能へのアクセスを制御できます。Databricksのプレビューを管理するを参照してください。
このページでは、マネージド Glean コネクタで発生する可能性のある一般的なエラーとその解決方法について説明します。
すべてのマネージド インジェスト パイプラインに適用される一般的なトラブルシューティングのガイダンスについては、「マネージド インジェスト パイプラインのトラブルシューティング」を参照してください。
パイプラインの認証に失敗しました
原因： Glean が、レート制限レスポンスではない HTTP 401 または HTTP 403 レスポンスを返しました。これは通常、API トークンが無効であるか、トークンが取り込み対象のテーブルに対するスコープを持っていないか、あるいは Subdomain がトークンを発行したデプロイメントと一致していないことを意味します。コネクタはこれを構成エラーとして扱い、パイプラインを失敗させます。
ソリューション:
- Unity Catalog 接続内の API トークン が有効であり、取り消されていないことを確認してください。
- トークンに Insights スコープと Shortcuts スコープの両方が含まれていることを確認します。スコープが不足しているトークンは、そのスコープを必要とするテーブルに対してのみ失敗します。
- Unity Catalog接続内の Subdomain が、トークンを発行したデプロイメントと一致していることを確認してください。
詳細については、Glean への認証の構成を参照してください。
Glean APIのレート制限を超過しました
原因： コネクタが短期間に過剰なリクエストを送信したため、Glean が HTTP 429 レスポンスを返しました。
ソリューション:
このコネクターは Retry-After 応答ヘッダーを尊重し、その後エクスポネンシャル バックオフにフォールバックして自動的に再試行します。これが繰り返し発生する場合は、パイプラインのスケジュール頻度、または同じ Glean デプロイメントを共有する並列パイプラインの数を減らしてください。
Glean APIは一時的に利用できません
原因： Gleanが一時的なサーバーエラー（HTTP 500、502、503、または504）を返しました。
ソリューション:
コネクタはエクスポネンシャル バックオフを使用して自動的に再試行します。問題が解決しない場合は、しばらく待ってからパイプラインを再度実行してください。