メインコンテンツまでスキップ
に最終更新

Jira 取り込みのトラブルシューティング

備考

ベータ版

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

このページでは、 Databricks LakeFlow Connectの Jira コネクタに関する一般的な問題とその解決方法について説明します。

オンプレミスの接続障害​

オンプレミス接続が失敗するか、到達不能エラーでデータ取り込みが失敗する場合は、 Databricks IP アドレスがファイアウォールの許可リストに登録されていることを確認してください。

一般的なパイプラインのトラブルシューティング​

実行中にパイプラインが失敗した場合は、失敗したステップをクリックし、エラー メッセージにエラーの性質に関する十分な情報が示されているかどうかを確認します。

UI でパイプライン イベント ログを表示する

右側のパネルで [詳細の更新] をクリックし、 [ログ] を クリックして、パイプラインの詳細ページからクラスター ログを確認してダウンロードすることもできます。ログをスキャンしてエラーまたは例外がないか確認します。

UI でパイプラインの更新の詳細を表示する

一般的なエラーコード​

403 権限がありません​

解決 ：

OAuth アプリのスコープを再確認してください。OAuth アプリケーションに、取り込もうとしているテーブルに必要なすべてのスコープが含まれていることを確認します。必要なスコープの完全なリストについては、サポートされているソース テーブルを参照してください。

401 認証されていません​

解決 ：

Unity Catalog接続を再認証します。 OAuth 認証情報の有効期限が切れているか、取り消されている可能性があります。

Jiraで認証した後、「もう一度ログインしてください」という画面が表示されます​

Jira で認証すると、「もう一度ログインしてください」という画面が表示されます。この画面では Jira へのログインは成功しますが、Databricks にリダイレクトされません。

解決 ：

  1. Jira OAuth アプリで設定されたリダイレクト URI がワークスペースのリダイレクト パスと正確に一致していることを確認します。 https://<databricks_workspace_URL>/login/oauth/lakehousefederation.html
  2. 「再度ログインする」を クリックしないでください。これにより、Databricks にリダイレクトされるのではなく、Jira UI にログインします。代わりに、ウィンドウを閉じて、リダイレクト URI を修正した後、Databricks UI から OAuth フローを再起動します。
  3. 問題が解決しない場合は、Jira アプリに必要なスコープ ( read:jira-work 、 read:jira-user 、および「取り込み用に Jira を構成する」にリストされている詳細な読み取りスコープ) があることを確認してください。

権限エラー​

エラー ：

Access denied to Jira project or issue.

解決 ：

  1. ユーザー アカウントに、取り込もうとしているプロジェクトに対する プロジェクトの参照 権限があることを確認します。
  2. プロジェクト設定 > 権限 に移動して、Jira のプロジェクト権限を確認します。
  3. サービス アカウントを使用している場合は、適切な権限が付与されていることを確認してください。
  4. 一部の問題にはセキュリティ制限がある可能性があります。Jira インターフェースで個々の課題の権限を確認します。

レート制限エラー​

エラー ：

Jira API rate limit exceeded.

解決 ：

レート制限に達すると、Jiraコネクタは指数バックオフを使用して自動的に再試行します。レート制限エラーが続く場合は、以下を検討してください。

  • パイプラインの実行は、ピーク時以外の時間帯にスケジュールしてください。
  • 大規模なJiraインスタンスの場合は、パイプラインの実行間隔を長くしてください。
  • 大量のエンティティ（例： issues 、 issue_comments 、 issue_worklogs ）を別々のパイプライン実行に分割します。
  • APIのレート制限を引き上げるには、Atlassianサポートにお問い合わせください。

問題が欠落しているか、データが不完全です​

問題 ：

取り込まれたデータにいくつかの問題が表示されていないか、データが不完全なようです。

解決 ：

  1. 問題がソース Jira プロジェクトに存在し、アーカイブされていないことを確認します。
  2. ユーザー アカウントがプロジェクト内のすべての課題にアクセスできることを確認します。
  3. Jira インスタンスでカスタム フィールドが適切に設定されていることを確認します。
  4. 特定の問題に関連する警告やエラーがないか、パイプライン イベント ログを確認します。

プロジェクトが見つからないエラー​

エラー ：

Jira project not found: <PROJECT_KEY>

解決 ：

  1. プロジェクト キーが正しいことを確認します。プロジェクト キーでは大文字と小文字が区別されます。
  2. Jira インスタンスにプロジェクトが存在し、アクティブである (アーカイブされていない) ことを確認します。
  3. ユーザー アカウントがプロジェクトにアクセスできることを確認します。
  4. ブラウザでプロジェクトに直接アクセスしてみてください。 https://your-domain.atlassian.net/browse/<PROJECT_KEY>

取り込み性能が遅い​

問題 ：

パイプラインの実行に予想よりも時間がかかっています。

解決 ：

  1. 通常、パイプラインの初期実行 (完全なスナップショット) には、増分実行よりも時間がかかります。
  2. ワークフロー履歴が広範囲にわたるプロジェクトやカスタム フィールドが多数あるプロジェクトでは、取り込みが遅くなる可能性があります。
  3. パイプライン ログを確認して、Jira API レート制限に達していないかどうかを確認します。
  4. データ量を削減するには、すべてのプロジェクトではなく特定のプロジェクトを取り込むことを検討してください。
  5. パフォーマンスの問題が解決しない場合は、サポート チケットを作成してください。

OAuth認証エラー​

問題 ：

パイプラインは動作していましたが、突然認証エラーが発生して失敗し始めました。

解決 ：

  1. コネクタは、OAuth トークンの有効期限が近づくと自動的に更新します。認証エラーが解決しない場合は、問題は OAuth アプリの構成または失効に関連している可能性があります。
  2. OAuth アプリがまだアクティブであり、Atlassian Developer Console で取り消されていないことを確認します。
  3. 必要に応じて、 OAuthフローを再度実行してUnity Catalog接続を再認証します。
  4. パイプラインを再試行します。

宣言型自動化バンドルを使用した列選択​

問題 ：

宣言型自動化バンドルを使用して管理対象の取り込みパイプラインを作成する場合、列選択機能は使用できません。

解決 ：

Databricks CLI のバージョンを確認してください。バージョンがv0.251.0未満の場合、CLI を再インストールします。

さらにサポートが必要ですか?​

このトラブルシューティング ガイドに記載されていない問題が発生した場合は、サポート チケットを作成してください。