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

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

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

すべてのマネージドインジェストパイプラインに適用される一般的なトラブルシューティングガイダンスについては、マネージドインジェストパイプラインのトラブルシューティングを参照してください。

認証エラー​

エラー :

The user does not have access to the specified site 'https://your-domain.atlassian.net' with the given token, or the URL is incorrect. Please verify the URL and the OAuth token's permissions.

解決 :

  1. OAuth アプリで付与された OAuth スコープを確認します。
  2. Confluence インスタンス URL が正しく、完全なドメイン (例: https://your-domain.atlassian.net ) が含まれていることを確認します。

レート制限エラー​

エラー :

Confluence API rate limit exceeded.

解決 :

  1. Confluence コネクタは、レート制限に達すると、指数バックオフで自動的に再試行します。
  2. レート制限エラーが解決しない場合は、パイプラインの実行をオフピーク時間帯にスケジュールすることを検討してください。
  3. 大規模な Confluence インスタンスの場合、パイプラインの実行間隔を長くする必要がある場合があります。
  4. API レート制限を引き上げる必要がある場合は、Atlassian サポートにお問い合わせください。スペースが見つからないエラー

欠落したページまたは不完全なデータ​

問題 : 取り込まれたデータに一部のページが表示されないか、データが不完全であるように見えます。

解決 :

  1. ページがソース Confluence スペースに存在し、アーカイブされていないことを確認します。アーカイブされたページはサポートされていません。
  2. ページが下書き状態になっていないことを確認します。公開されたページのみが取り込まれます。
  3. ユーザー アカウントにスペース内のすべてのページに対する読み取りアクセス権があることを確認します。
  4. 特定のページに関連する警告やエラーがないか、パイプライン イベント ログを確認します。

取り込み性能が遅い​

問題 :

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

解決 :

  1. 通常、パイプラインの初期実行 (完全なスナップショット) には、増分実行よりも時間がかかります。
  2. 膨大なコンテンツや多数の添付ファイルを含む大きなページでは、取り込み速度が遅くなる可能性があります。
  3. パイプライン ログを確認して、Confluence API レート制限に達していないかどうかを確認します。
  4. パフォーマンスの問題が解決しない場合は、サポート チケットを作成してください。

更新時の有効期限​

問題 :

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

解決 :

  1. OAuth アプリで付与された OAuth スコープを確認します。
  2. 接続を更新します。
  3. パイプラインを再試行します。

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

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