メインコンテンツまでスキップ

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

備考

ベータ版

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

このページでは、管理されているStracコネクタで発生する可能性のある一般的なエラーと、それらを解決する方法について説明します。

Strac APIキーが無効であるか、認証されていません

原因: Strac が HTTP 401 または 403 応答を返しました。APIキーが見つからないか、正しくないか、または監査イベント Endpoint の承認がされていません。コネクタはこれを構成エラーとして処理し、パイプラインを失敗させます。

ソリューション:

  1. Unity Catalog接続の**APIキー**が現在のStrac APIキーと一致し、お使いの環境に合った適切なsk_ プレフィックス(sk_test_ またはsk_live_ )を使用していることを確認してください。
  2. Unity Catalog接続の API Endpoint が、同じ環境のホストとステージと一致していることを確認してください。
  3. キーが無効であるか、または権限がない場合は、Stracから新しいキーを要求し、新しい値で接続を更新して、再度パイプラインを実行してください。

詳細については、Stracへの認証を構成するを参照してください。

Strac API レート制限を超過しました

原因: リクエスト レートがAPIの制限を超えたため、Strac は HTTP 429 応答を返しました。

ソリューション:

コネクタは Retry-After レスポンスヘッダーを受け入れ、その後、指数関数的バックオフにフォールバックして自動的に再試行します。これが繰り返し発生する場合は、パイプラインのスケジュール頻度を減らすか、同じStrac APIキーを共有する並列パイプラインの数を減らしてください。

Strac APIは一時的に利用できません

**原因**: Stracは一時的なサーバーエラー (HTTP 500、502、503、または504) を返しました。

ソリューション:

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