Oktaコネクタのトラブルシューティング
ベータ版
この機能はベータ版です。使用するには、ワークスペース管理者は プレビュー ページから Okta向けLakeflow Connect を有効にする必要があります。Databricksのプレビューを管理するを参照してください。
Lakeflow Connect のマネージド Okta コネクターで発生する認証、権限、レート制限、一時的なサービスエラーを解決します。
すべての管理されたインジェストパイプラインに適用される一般的なトラブルシューティング ガイダンスについては、管理されたインジェストパイプラインのトラブルシューティングをご覧ください。
パイプラインの認証が失敗する
原因 : OktaがHTTP 401応答を返しました。Unity Catalog接続のドメインまたはSSWS APIトークンが有効ではないか、トークンが取り消されたか、トークンを作成した管理者が無効になっています。
ソリューション ：
- Domain に、
company-name.okta.comなどのOkta組織ドメインが含まれていることを確認してください。 - Okta管理コンソールで、 Security > API > Tokens に移動します。
- トークンがアクティブであり、その所有者がアクティブな管理者であることを確認します。
- 必要に応じて、トークンを作成し、Unity Catalog接続の SSWSトークン の値を更新してください。
設定の詳細については、「Oktaの認証の設定」および「Okta接続の作成」を参照してください。
パイプラインで権限エラーが発生しました
原因 ：Oktaは、APIトークンを所有する管理者がパイプラインで取り込むリソースを読み取れないため、HTTP 403応答を返しました。
ソリューション ：
前提条件を満たす管理者アカウントでAPIトークンを作成し、Unity Catalog接続の SSWSトークン 値を更新します。あるいは、パイプラインから影響を受けるテーブルを削除してください。
Okta APIレート制限の上限を超えました
原因 ：リクエストが Okta APIレート制限を超えたため、OktaがHTTP 429レスポンスを返しました。
ソリューション ：
コネクタはレート制限がResetされるまで待機し、自動的に再試行します。レート制限が続く場合：
- Okta管理コンソールで、 Security > API > Tokens に移動します。
- Unity Catalog接続で使用するAPIトークンを選択します。
- トークンレート制限 で、 編集 をクリックします。
- 組織のポリシーで許可されている場合は、トークンに割り当てられた各APIレート制限のパーセンテージを増やします。
- 同じトークンを使用する並列パイプラインの数を減らします。
Okta APIは一時的に使用できません
原因 : Okta が HTTP 5xx サーバエラーを返しました。
ソリューション ：
コネクターは、一時的なサーバーエラーを自動的に再試行します。再試行が完了しても問題が解決しない場合は、待機してからパイプラインを再度ランしてください。