Tableau Prep Builder 疑難排解
本文列出了您在使用 Tableau Prep Builder 時可能遇到的問題以及有關如何解決這些問題的建議。
執行 LogShark
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 部署指南中的系統需求(連結在新視窗開啟)。