排除 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.

解決方法：

1. 請查看 OAuth 應用程式中授予的 OAuth 範圍。
2. 請確認你的 Confluence 實例網址是否正確，且包含完整網域（例如， https://your-domain.atlassian.net）。

速率限制錯誤

錯誤：

Confluence API rate limit exceeded.

解決方法：

1. 當遇到速率限制時，Confluence 連接器會自動以指數退避策略重試。
2. 若速率限制錯誤持續存在，請考慮在非尖峰時段排程管線運行。
3. 對於大型 Confluence 實例，您可能需要延長管線運行間隔。
4. 如果你需要提高 API 速率限制，請聯絡 Atlassian 客服。## 找不到空間錯誤

缺頁或資料不完整

問題：有些頁面未出現在已攝取的資料中，或資料看起來不完整。

解決方法：

1. 確認這些頁面存在於 Source Confluence 空間，且沒有被封存。 已存檔的頁面不被支援。
2. 檢查這些頁面是否處於草稿狀態。 僅收錄已發佈的頁面。
3. 確認使用者帳號對該空間中所有頁面都有讀取權限。
4. 請查看管線事件日誌，看看是否有與特定頁面相關的警告或錯誤。

緩慢的吞噬效能

問題：

管線運行比預期還要久。

解決方法：

1. 初始管線執行（完整快照）通常比增量執行花費更長時間。
2. 內容龐大或附件眾多的頁面可能會拖慢資料擷取速度。
3. 檢查管線日誌，確認你是否達到 Confluence API 的速率限制。
4. 如果效能問題持續，請 建立支援單。

刷新令牌到期

問題：

管線本來運作正常，但突然開始出現認證錯誤。

解決方法：

1. 請查看 OAuth 應用程式中授予的 OAuth 範圍。
2. 更新連線。
3. 重新嘗試管線。

使用 Databricks 資產組合進行欄位選擇

問題：

當您使用 Databricks 資產套件組合建立受控擷取管線時，您無法使用資料行選取功能。

解決方法：

檢查您的 Databricks CLI 版本。 如果版本低於v0.251.0，請 重新安裝CLI。

需要更多協助嗎？

如果你遇到本故障排除指南未涵蓋的問題，請 建立支援單。