Confluence取り込みのトラブルシューティング
備考
プレビュー
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.
解決 ：
- OAuth アプリで付与された OAuth スコープを確認します。
- Confluence インスタンス URL が正しく、完全なドメイン (例:
https://your-domain.atlassian.net) が含まれていることを確認します。
レート制限エラー
エラー ：
Confluence API rate limit exceeded.
解決 ：
- Confluence コネクタは、レート制限に達すると、指数バックオフで自動的に再試行します。
- レート制限エラーが解決しない場合は、パイプラインの実行をオフピーク時間帯にスケジュールすることを検討してください。
- 大規模な Confluence インスタンスの場合、パイプラインの実行間隔を長くする必要がある場合があります。
- API レート制限を引き上げる必要がある場合は、Atlassian サポートにお問い合わせください。スペースが見つからないエラー
欠落したページまたは不完全なデータ
問題 : 取り込まれたデータに一部のページが表示されないか、データが不完全であるように見えます。
解決 ：
- ページがソース Confluence スペースに存在し、アーカイブされていないことを確認します。アーカイブされたページはサポートされていません。
- ページが下書き状態になっていないことを確認します。公開されたページのみが取り込まれます。
- ユーザー アカウントにスペース内のすべてのページに対する読み取りアクセス権があることを確認します。
- 特定のページに関連する警告やエラーがないか、パイプライン イベント ログを確認します。
取り込み性能が遅い
問題 ：
パイプラインの実行に予想よりも時間がかかっています。
解決 ：
- 通常、パイプラインの初期実行 (完全なスナップショット) には、増分実行よりも時間がかかります。
- 膨大なコンテンツや多数の添付ファイルを含む大きなページでは、取り込み速度が遅くなる可能性があります。
- パイプライン ログを確認して、Confluence API レート制限に達していないかどうかを確認します。
- パフォーマンスの問題が解決しない場合は、サポート チケットを作成してください。
更新時の有効期限
問題 ：
パイプラインは動作していましたが、突然認証エラーが発生して失敗し始めました。
解決 ：
- OAuth アプリで付与された OAuth スコープを確認します。
- 接続を更新します。
- パイプラインを再試行します。
Databricks アセットバンドルを使用した列選択
問題 ：
Databricks アセット バンドルを使用して管理されたインジェスト パイプラインを作成する場合、列選択機能は使用できません。
解決 ：
Databricks CLI のバージョンを確認してください。バージョンがv0.251.0未満の場合、CLI を再インストールします。
さらにサポートが必要ですか?
このトラブルシューティング ガイドに記載されていない問題が発生した場合は、サポート チケットを作成してください。