Tableau Prep Builder 疑難排解
本文列出了您在使用 Tableau Prep Builder 時可能遇到的問題以及有關如何解決這些問題的建議。
LogShark 是一個免費的開源命令列公用程式,可以使用它從 Prep 記錄檔中擷取資訊以進行疑難排解並深入了解錯誤和使用情況。使用 LogShark Prep.twbx
外掛程式,可以產生帶有錯誤和流程儀表板的工作簿,以幫助分析和視覺化 Prep 問題。
LogShark 要求處理的 Prep 記錄檔是壓縮 (zipped) 檔。若要查找 Prep 記錄檔,請巡覽到「我的 Tableau Prep 存放庫」資料夾。位置是 /Users/<username>/Documents/My Tableau Prep Repository
。
有關安裝和執行 LogShark 的資訊,請參閱為電腦設定 LogShark。
您可以從命令列中以程式設計方式執行流程來重新整理輸出檔案,而不是開啟 Tableau Prep Builder 以手動方式執行每個流程。儘管此過程可幫助提高流程的效率,但如果語法不正確,或者缺少連線或輸出位置的認證,則在執行此過程時會出現錯誤。
下表描述了常見錯誤以及如何解決這些錯誤。有關如何從命令列中執行流程的資訊,請參閱透過命令列重新整理流程輸出檔案(連結在新視窗開啟)。
錯誤 | 原因 | 如何修復 |
---|---|---|
「Missing arguments」(缺少引數) | 缺少必需的命令列引數之一。 | 使用「tableau-prep-cli -help」來查看命令列引數的清單。 |
「Unable to read the connections file.」(無法讀取連線檔案。) | 輸入連線的 credentials.json 檔案中的語法或格式存在錯誤。 | 請檢查 .json 檔案中輸入連線的語法。有關詳情和範例,請參閱透過命令列重新整理流程輸出檔案(連結在新視窗開啟)。 |
「There are errors in the flow.Unable to run the flow. Check that the credentials .json file includes all required credentials.在 Tableau Prep Builder 中開啟流程以檢視錯誤詳情。」 | 輸入連線的 credentials.json 檔案中缺少認證,或者流程包含錯誤。 | 請檢查 .json 檔案是否具有所有連線的認證,並在 Tableau Prep Builder 中開啟流程檔案,確定流程中是否存在任何錯誤。 如果流程有錯誤,您必須修復這些錯誤並將流程重新發佈到 Tableau Server,然後再次嘗試執行該過程。 |
「Could not find match for <hostname of inputConnections >」(找不到 <輸入連線的主機名稱> 的匹配項) | Credentials.json 檔案缺少主機名稱(伺服器名稱)條目。 | 請確保 credentials.json 檔案包括主機名稱(伺服器名稱)的正確認證。 有關詳情和範例,請參閱透過命令列重新整理流程輸出檔案(連結在新視窗開啟)。 |
「We don't have credentials of all connections in tfl/tflx file.The following connection(s) were not found: <hostname of inputConnections>」(tfl/tflx 檔案中沒有所有連線的認證。找不到以下連線:<輸入連線的主機名稱>) | credentials.json 檔案缺失,或包含對於錯誤訊息中顯示的主機名稱(伺服器名稱)而言不正確的認證。 | 請確保 credentials.json 檔案包括錯誤訊息中所列主機名稱(伺服器名稱)的正確認證。 有關詳情和範例,請參閱透過命令列重新整理流程輸出檔案。 |
「Error signing in server <serverUrl> as a user <userName>.Please check the credentials.」(以使用者 <使用者名> 登入到伺服器 <伺服器 URL> 時出錯。請檢查認證。) | credentials.json 檔案包含的認證對於 Tableau Server 不正確。 | 請確保 credentials.json 檔案包括適用於輸出連線的所有正確認證和元素。 有關詳情和範例,請參閱透過命令列重新整理流程輸出檔案。 |
「Could not sign in successfully as <userName> to server <serverUrl>(<contentUrl>)」(無法以 <使用者名> 成功登入到伺服器 <伺服器 URL>(<內容 URL>)) | credentials.json 檔案包含的認證對於 Tableau Server 不正確。 | 請確保 credentials.json 檔案包括適用於輸出連線的所有正確認證和元素。 有關詳情和範例,請參閱透過命令列重新整理流程輸出檔案。 |
「We don't have credentials for Tableau Server to publish extract for one or more output nodes in tfl/tflx file.」(tfl/tflx 檔案中沒有用於為一個或多個輸出節點發佈擷取的 Tableau Server 認證。) | credentials.json 檔案未作為命令列引數傳入,或者其缺少輸出連線的認證。 | 請確保在命令列中包括 credentials.json 檔案的路徑,並驗證 credentials.json 檔案是否包括適用於輸出連線的所有正確認證和元素。 有關詳情和範例,請參閱透過命令列重新整理流程輸出檔案。 |
「Loom rest api server not started」(Loom rest api 伺服器未啟動) | 安裝或環境設定不正確。 | 請確保正確安裝了 Tableau Prep Builder,並且您以管理員執行命令。 如需有關如何安裝 Tableau Prep Builder 的資訊,請參閱從使用者介面安裝 Tableau Desktop 或 Tableau Prep Builder(連結在新視窗開啟)。 |
「Error.Flow file does not exist.」(錯誤。流程檔案不存在。) | 流程檔案的路徑不正確。 | 請確保在命令列中包括流程檔的正確路徑。 |
「Error.Connections file does not exist.」(錯誤。連線檔案不存在。) | credentials.json 檔案的路徑不正確。 | 請確保在命令列中包括 credentials.json 檔案的正確路徑。 |
「找不到 <mapr01:5181><mapr02:5181>,<mapr03:5181> 相符項目」 | 使用 ZooKeeper 連線到 Apache Drill 時,您必須指定特定的埠 ID。 | 在命令列中包含指定「埠」:31010 的 credentials.json 檔案以用於輸入認證。 |
錯誤:「These features were found that prevent this version of the application from using this file」(發現了使此版本的應用程式無法使用此檔案的這些功能)
如果在較早版本的 Tableau Prep Builder 中開啟在版本 2018.2.1 或更新版本中建立的流程,您可能會看到以下錯誤:
包括較早版本中不支援的功能的流程將導致此相容性錯誤。為了解決錯誤,請在更新版本中開啟流程,並儲存沒有所指明功能的流程的複製。在上面的範例中,請從應用了 null 篩選器的欄位中將該篩選器移除。
然後在較早版本的 Tableau Prep Builder 中開啟已移除該功能的複製。
使用 Tableau Prep 登入到啟用 SSL 的 Tableau Server 時出現「You are using Server version: null...」(您正使用 Server 版本: null...)錯誤
從 Tableau Prep Builder 中登入到啟用 SSL 的 Tableau Server 時,您必須在安裝了 Tableau Prep Builder 的電腦上安裝根證書。如果未安裝證書,您可能會看到以下錯誤:
You are using Server version: null but the minimum compatible version is: 10.0. Please upgrade to a compatible version(您正使用 Server 版本: null,但相容的最低版本為: 10.0。請升級到相容版本)
如果看到此錯誤,請與 IT 部門或系統管理員合作,在安裝了 Tableau Prep Builder 的電腦上安裝所需的根證書。有關詳情,請參閱 Tableau Desktop 和 Tableau Prep Builder 部署指南中的系統需求(連結在新視窗開啟)。