OpenAI コネクタのトラブルシューティング
備考
ベータ版
この機能はベータ版です。ワークスペース管理者は、 プレビュー ページからこの機能へのアクセスを制御できます。Databricksのプレビューを管理するを参照してください。
このページでは、マネージド OpenAI コネクタで発生する可能性のある一般的なエラーとその解決方法について説明します。
パイプラインの認証に失敗しました
原因: OpenAI が HTTP 401 または 403 レスポンスを返しました。これは通常、次のいずれかを意味します：管理者 API キーが無効である、キーが取り消された、またはそのキーが組織の管理者 API キーではなく、必要な読み取りスコープを持つプロジェクトキーやサービスアカウントキーである。
ソリューション:
- Unity Catalog 接続内の Admin API Key が、OpenAI 組織の Admin keys ページにある現在アクティブなキーと一致していることを確認してください。
- そのキーがプロジェクトAPIキーやサービスアカウントキーではなく、組織レベルの Admin API key であることを確認してください。Admin API Endpointには、組織レベルのキーが必要です。
- キーにコネクタが必要とする読み取りスコープがあることを確認してください。OpenAI への認証の構成を参照してください。
キーがローテーションされた場合は、新しいキーで接続を更新してください。OpenAI接続の作成を参照してください。
パイプラインがレート制限されています
原因: OpenAIがHTTP 429応答を返しました。組織が管理APIのレート制限に達しました。
ソリューション： コネクタは待機し、自動的に再試行します。複数のパイプラインのランでエラーが続く場合は、パイプラインのスケジュール頻度を下げるか、同じ OpenAI 管理者 API キーを共有する並列パイプラインの数を減らしてください。
OpenAI API は一時的に利用できません
原因: OpenAIが一時的なサーバーエラー（HTTP 500、502、503、または504）を返しました。
ソリューション: コネクタはバックオフを使用して自動的に再試行します。問題が解決しない場合は、OpenAIのサービスステータスを確認してから、パイプラインを再実行してください。