Workiva コネクターのトラブルシューティング
ベータ版
この機能はベータ版です。ワークスペース管理者は、 プレビュー ページからこの機能へのアクセスを制御できます。Databricksのプレビューを管理するを参照してください。
このページでは、Databricks LakeflowコネクトのマネージドWorkivaコネクタで発生する可能性のある一般的なエラーとその解決方法について説明します。
Workiva 資格情報に必要なスコープが不足しています
原因： OAuth2アプリケーションが要求されたリソースに対して承認されていないため、WorkivaがHTTP 403レスポンスを返しました。コネクタはこれを構成エラーとして扱い、パイプラインを失敗させます。一般的な原因として、アプリケーションに activity:read スコープ（activities に必要）または organization:read スコープ（users および roles に必要）が不足していることが挙げられます。
ソリューション:
- Workiva 組織で、OAuth2 アプリケーションに
activity:readとorganization:readの両方のスコープがあることを確認してください。 - スコープを追加する場合は、必要に応じて更新された資格情報を生成し、新しい クライアント ID と クライアント シークレット で Unity Catalog 接続を更新してください。
- パイプラインをもう一度実行してください。
詳細については、Workiva への認証の構成を参照してください。
Workivaアクセストークンが拒否されました
原因： Workiva が HTTP 401 応答を返しました。アクセストークンの有効期限が切れているか、クライアント資格情報が正しくありません。コネクタは自動的にトークンを更新し、1 回再試行します。再試行しても失敗する場合、パイプラインは無効な資格情報エラーで失敗します。
ソリューション:
- Unity Catalog接続内の クライアントID と クライアントシークレット が、現在アクティブなWorkiva OAuth2アプリケーションと一致していることを確認してください。
- Unity Catalog接続内の 組織ID が、お使いのWorkiva組織と一致していることを確認してください。
- 資格情報が正しくない、または取り消されている場合は、Workivaで新しい資格情報を作成し、接続を更新してから、パイプラインを再度実行してください。
詳細については、Workiva への認証の構成を参照してください。
Workiva APIのレート制限を超過しました
原因： リクエストレートがAPIの制限を超えたため、WorkivaがHTTP 429レスポンスを返しました。
ソリューション:
このコネクターは Retry-After 応答ヘッダーを尊重し、その後エクスポネンシャル バックオフにフォールバックして自動的に再試行します。これが繰り返し発生する場合は、パイプラインのスケジュール頻度、または同じ Workiva OAuth2 アプリケーションを共有する並列パイプラインの数を減らしてください。
Workiva APIは一時的に利用できません
原因: Workiva が一時的なサーバーエラー（HTTP 500、502、503、または504）を返しました。
ソリューション:
コネクタはエクスポネンシャル バックオフを使用して自動的に再試行します。問題が解決しない場合は、しばらく待ってからパイプラインを再度実行してください。