---
schema_version: "1"
id: e00b71ef479a10bc139270c0a82f53cc62a5c7623ef22257f31849e85e1cb0f0
title: Tableau Prep Builder 疑難排解
collection: tableau
version: current
locale: zh-tw
portal_url: https://docs.salesforce.com/tableau/current/zh-tw/prep/prep_troubleshoot.md
canonical_url: https://help.tableau.com/current/prep/zh-tw/prep_troubleshoot.htm
source_site: help.tableau.com
content_type: documentation
content_hash: 8562060f637f8dcf2eaf98d747da9bb8f468abf5d6ae7f8862bc55b0bafc4123
description: Troubleshoot Tableau Prep Builder issues and collect logs and crash dumps.
---
[跳至主要內容](#main-content)

# Tableau Prep Builder 疑難排解

本文列出了您在使用 Tableau Prep Builder 時可能遇到的問題以及有關如何解決這些問題的建議。

對流程問題進行疑難排解時，無論是為自己偵錯還是聯絡支援人員，您通常都需要收集記錄檔和損毀傾印檔案以進行分析，並記錄重現錯誤所需的步驟。提供在錯誤發生前採取的確切步驟以及流程檔案，是幫助開發人員或支援團隊診斷問題的最佳方式。

## 正在收集記錄檔和損毀傾印檔案

Tableau Prep 記錄檔儲存在「我的 Tableau Prep 存放庫」資料夾中。預設情況下，該位置為：

**Windows**: `C:\Users\<username>\Documents\My Tableau Prep Repository\Logs`.

**MacOS**: `/users/<username>/Documents/My Tableau Prep Repository/Logs`

要正確診斷問題，需要收集所有記錄檔。如果執行的是 Tableau Prep Builder，這就是「我的 Tableau Prep 存放庫/記錄檔」資料夾中的所有內容。如果透過命令列執行 Tableau Prep，請包括來自「我的 Tableau Prep 存放庫/命令列存放庫/記錄檔」中的記錄檔。

下表說明所產生的不同記錄檔。

<table style="width: 100%;" class="simple-table"><colgroup><col><col><col></colgroup><tbody><tr><th>記錄檔檔案名稱</th><th>產生記錄檔的程序</th><th>描述</th></tr><tr><td>app.log</td><td>Tableau Prep.exe</td><td>使用者介面記錄檔。這是由在電子處理序中運行的 JavaScript 代碼產生的。</td></tr><tr><td>backendProcessManager.log</td><td>Tableau Prep.exe</td><td>這是由啟動並監控 Java 處理序的 JavaScript 代碼所產生的。</td></tr><tr><td><p>preprestapi.log</p></td><td><p>Java.exe</p></td><td><p>這是 Java 程式碼產生的記錄檔。有關 REST API 使用、編譯、快取管理以及 tabminerva（先前稱為 prepservice）程序的啟動和關閉的記錄項目應位於此處。</p></td></tr><tr><td>log.txt</td><td><p>prepservice.exe</p><p>tabminerva.exe</p></td><td><p>此記錄檔由 C++ 程式碼產生。</p><p>此記錄檔包括與 Tableau 共用技術堆疊的所有互動，包括與資料庫的連線、查詢、執行、外部快取、查詢管道、協定等。</p></td></tr><tr><td>tdeserver.txt</td><td>tdeserver64.exe</td><td><p>這是舊 Tableau 資料引擎建立的記錄檔。Tableau Prep 仍使用 Tableau 資料引擎。</p></td></tr><tr><td>tabprotosrv.txt</td><td>tabprotosrv.exe</td><td><p>通訊協定伺服器記錄檔。任何使用託管資料庫驅動程式的內容都將在此檔案中產生記錄行。</p></td></tr><tr><td>hyperd.log</td><td>hyperd.exe</td><td><p>Hyper 記錄檔。此處包含查詢及與查詢相關的錯誤。</p></td></tr></tbody></table>

### 啟用查詢記錄

從 Tableau Prep Builder 版本 2026.2 開始，可以在說明\>設定和效能功能表下開啟啟用查詢記錄設定，而無需重新啟動應用程式。開啟時，此設定會為 Tableau Prep Builder 執行的每個查詢產生一個 XML 查詢檔案。這在診斷流程問題時很有幫助。記錄檔會產生並儲存在查詢資料夾中。

![Tableau Prep 中的說明功能表，顯示設定和效能功能表選項。](/tableau/current/zh-tw/prep/zh-tw/Img/prep_enable_query_logging.png)

可以在以下目錄中找到這些查詢記錄檔：

**Windows**: `C:\Users\<username>\Documents\My Tableau Prep Repository\Query`

**MacOS**: `/users/<username>/Documents/My Tableau Prep Repository/Query`

### 執行 LogShark

LogShark 是一個免費的開源命令列公用程式，可以使用它從 Prep 記錄檔中擷取資訊以進行疑難排解並深入了解錯誤和使用情況。使用 LogShark `Prep.twbx` 外掛程式，可以產生帶有錯誤和流程儀表板的工作簿，以幫助分析和視覺化 Prep 問題。

有關安裝和執行 LogShark 的資訊，請參閱[為電腦設定 LogShark](https://tableau.github.io/Logshark/docs/logshark_prefunc)。

### 建立損毀傾印檔案

除了記錄檔之外，還要收集損毀傾印檔案。此處可能詳細說明記錄檔中未包含的任何內容，這些資訊可在查詢 .hyper 時對應用程式啟動、例外狀況或問題進行疑難排解時有所幫助。

建立損毀傾印檔案時，為以下處理序建立這些檔案很有用。

<table style="width: 100%;" class="simple-table"><colgroup><col><col></colgroup><tbody><tr><th>處理序</th><th>描述</th></tr><tr><td>tabminerva.exe（先前為 prepservice.exe）</td><td>這是承載 Tableau Prep 商務邏輯其餘部分的原生程序。這個程序也包含共用的 Tableau 原生技術，包括資料庫連接器。</td></tr><tr><td>hyperd.exe</td><td>這是 Hyper 資料庫處理序。查詢失敗的任何時候。發生故障時，hyper 的損毀傾印可能很有用，因為 Tableau Prep 所做的大部分工作都涉及對 hyper 的查詢。</td></tr></tbody></table>

若要建立損毀傾印檔案，請根據作業系統執行以下動作。

#### Windows

1. 開啟「工作管理員」。
2. 右鍵按一下欄標題，然後選取處理序名稱和命令列。這將顯示不同的處理序，並使您能夠選取要用於建立損毀傾印檔案的處理序。
3. 以右鍵按一下 tabminerva.exe 處理序（先前為 prepservice.exe）。
4. 選取「建立傾印檔案」。
    
    將開啟一個對話方塊，並顯示損毀傾印檔案在系統上的位置。

#### MacOS

在 MacOS 上，有兩種類型的診斷檔案可用於對 Tableau Prep 進行疑難排解：

- 損毀報告 — 記錄損毀時的呼叫堆疊，類似於堆疊追蹤。
- 核心檔案 — 終止時處理序記憶體的完整快照。

兩者都需要終止 Tableau Prep 程序。收集這些檔案後，將需要重新啟動 Tableau Prep。

**必要條件**：核心檔案收集需要管理員存取權。

**步驟 1**：建立損毀報告

1. 開啟終端機。
2. 執行命令： `pgrep tabminerva | xargs kill -SEGV`
    
    這會透過向 tabminerva.exe 處理序傳送分割錯誤訊號來終止該處理序，從而導致 MacOS 自動產生損毀報告。
3. 在以下位置尋找儲存的損毀報告： `~/Library/Logs/DiagnosticReports/`
    
    檔案名稱採用 tabminerva\_YYYY-MM-DD-HHMMSS\_machinename.crash 或 tabminerva\_YYYY-MM-DD-HHMMSS\_machinename.ips 格式

將此檔案傳送給 Tableau 支援或開發團隊時，請務必說明您有意傳送區隔錯誤訊號以產生報告。這將其與真正的毀損區分開來。

**步驟 2**：建立核心檔案

建立核心檔案時，使用以下選項之一。

**建立核心檔案並終止 Tableau Prep 工作階段**

1. 開啟終端機。
2. 執行命令 `sudo chmod 1777 /cores` 以授予對核心檔案目錄的寫入存取權限。
3. 執行命令 `ulimit -c unlimited` 以移除目前終端工作階段的核心檔案大小限制。
4. 執行命令 `pgrep tabminerva | xargs kill -SEGV` 以終止程序並產生核心檔案。
5. 在 `/cores/` 中找到核心檔案，並將其命名為 `core.<process_id>`。

**建立核心檔案並讓 Tableau Prep 保持執行**

此選項使用 gcore 公用程式來捕獲執行中處理序的核心傾印而不結束它。此程序需要安裝 Xcode 命令列工具。若要檢查是否已安裝此選項，請開啟終端機並執行 `Bash xcode-select --install`。

1. 開啟終端機。
2. 執行命令：`sudo gcore -o /tmp/tabminerva.core $(pgrep tabminerva)`
    
    這會將核心檔案儲存到 `/tmp/tabminerva.core`。Tableau Prep 會繼續正常執行。

## 使用命令列執行流程時的常見錯誤

您可以從命令列中執行流程來重新整理輸出檔案，而不是開啟 Tableau Prep Builder 以手動方式執行每個流程。儘管此過程可幫助提高流程的效率，但如果語法不正確，或者缺少連線或輸出位置的認證，則在執行此過程時會出現錯誤。

有關 Tableau Prep 中支援的所有命令列選項的清單，請參閱 [Tableau Prep 命令列參考](https://help.tableau.com/current/prep/zh-tw/prep_command_line_reference.htm)。

下表描述了常見錯誤以及如何解決這些錯誤。有關如何從命令列中執行流程的資訊，請參閱[透過命令列重新整理流程輸出檔案](https://help.tableau.com/current/prep/zh-tw/prep_run_commandline.htm)。

<table style="width: 100%;" class="simple-table"><colgroup><col><col><col></colgroup><tbody><tr><th>錯誤</th><th>原因</th><th>如何修復</th></tr><tr><td>「Missing arguments」（缺少引數）</td><td>缺少必需的命令列引數之一。</td><td>使用「tableau-prep-cli -help」來查看命令列引數的清單。</td></tr><tr><td>「Unable to read the connections file.」（無法讀取連線檔案。）</td><td>輸入連線的 credentials.json 檔案中的語法或格式存在錯誤。</td><td>請檢查 .json 檔案中輸入連線的語法。有關詳情和範例，請參閱<a href="https://help.tableau.com/current/prep/zh-tw/prep_run_commandline.htm" target="_blank" class="xref">透過命令列重新整理流程輸出檔案</a>。</td></tr><tr><td><p>「There are errors in the flow.Unable to run the flow.</p><p>Check that the credentials .json file includes all required credentials.在 Tableau Prep Builder 中開啟流程以檢視錯誤詳情。」</p></td><td><p>輸入連線的 credentials.json 檔案中缺少認證，或者流程包含錯誤。</p></td><td><p>請檢查 .json 檔案是否具有所有連線的認證，並在 Tableau Prep Builder 中開啟流程檔案，確定流程中是否存在任何錯誤。</p><p>如果流程有錯誤，您必須修復這些錯誤並將流程重新發佈到 Tableau Server，然後再次嘗試執行該過程。</p></td></tr><tr><td>「Could not find match for &lt;hostname of inputConnections &gt;」（找不到 &lt;輸入連線的主機名稱&gt; 的匹配項）</td><td>Credentials.json 檔案缺少主機名稱（伺服器名稱）條目。</td><td><p>請確保 credentials.json 檔案包括主機名稱（伺服器名稱）的正確認證。</p><p>有關詳情和範例，請參閱<a href="https://help.tableau.com/current/prep/zh-tw/prep_run_commandline.htm" target="_blank" class="xref">透過命令列重新整理流程輸出檔案</a>。</p></td></tr><tr><td>「We don't have credentials of all connections in tfl/tflx file.The following connection(s) were not found: &lt;hostname of inputConnections&gt;」（tfl/tflx 檔案中沒有所有連線的認證。找不到以下連線：&lt;輸入連線的主機名稱&gt;）</td><td>credentials.json 檔案缺失，或包含對於錯誤訊息中顯示的主機名稱（伺服器名稱）而言不正確的認證。</td><td><p>請確保 credentials.json 檔案包括錯誤訊息中所列主機名稱（伺服器名稱）的正確認證。</p><p>有關詳情和範例，請參閱<a href="https://help.tableau.com/current/prep/zh-tw/prep_run_commandline.htm" class="xref">透過命令列重新整理流程輸出檔案</a>。</p></td></tr><tr><td>「Error signing in server &lt;serverUrl&gt; as a user &lt;userName&gt;.Please check the credentials.」（以使用者 &lt;使用者名&gt; 登入到伺服器 &lt;伺服器 URL&gt; 時出錯。請檢查認證。）</td><td>credentials.json 檔案包含的認證對於 Tableau Server 不正確。</td><td><p>請確保 credentials.json 檔案包括適用於輸出連線的所有正確認證和元素。</p><p>有關詳情和範例，請參閱<a href="https://help.tableau.com/current/prep/zh-tw/prep_run_commandline.htm" class="xref">透過命令列重新整理流程輸出檔案</a>。</p></td></tr><tr><td>「Could not sign in successfully as &lt;userName&gt; to server &lt;serverUrl&gt;(&lt;contentUrl&gt;)」（無法以 &lt;使用者名&gt; 成功登入到伺服器 &lt;伺服器 URL&gt;(&lt;內容 URL&gt;)）</td><td>credentials.json 檔案包含的認證對於 Tableau Server 不正確。</td><td><p>請確保 credentials.json 檔案包括適用於輸出連線的所有正確認證和元素。</p><p>有關詳情和範例，請參閱<a href="https://help.tableau.com/current/prep/zh-tw/prep_run_commandline.htm" class="xref">透過命令列重新整理流程輸出檔案</a>。</p></td></tr><tr><td>「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 認證。）</td><td>credentials.json 檔案未作為命令列引數傳入，或者其缺少輸出連線的認證。</td><td><p>請確保在命令列中包括 credentials.json 檔案的路徑，並驗證 credentials.json 檔案是否包括適用於輸出連線的所有正確認證和元素。</p><p>有關詳情和範例，請參閱<a href="https://help.tableau.com/current/prep/zh-tw/prep_run_commandline.htm" class="xref">透過命令列重新整理流程輸出檔案</a>。</p></td></tr><tr><td>「Loom rest api server not started」（Loom rest api 伺服器未啟動）</td><td>安裝或環境設定不正確。</td><td><p>請確保正確安裝了 Tableau Prep Builder，並且您以管理員執行命令。</p><p>如需有關如何安裝 Tableau Prep Builder 的資訊，請參閱<a href="https://help.tableau.com/current/desktopdeploy/zh-tw/desktop_deploy_download_and_install.htm" target="_blank">從使用者介面安裝 Tableau Desktop 或 Tableau Prep Builder</a>。</p></td></tr><tr><td>「Error.Flow file does not exist.」（錯誤。流程檔案不存在。）</td><td>流程檔案的路徑不正確。</td><td>請確保在命令列中包括流程檔的正確路徑。</td></tr><tr><td>「Error.Connections file does not exist.」（錯誤。連線檔案不存在。）</td><td>credentials.json 檔案的路徑不正確。</td><td>請確保在命令列中包括 credentials.json 檔案的正確路徑。</td></tr><tr><td>「找不到 &lt;mapr01:5181&gt;&lt;mapr02:5181&gt;,&lt;mapr03:5181&gt; 相符項目」</td><td>使用 ZooKeeper 連線到 Apache Drill 時，您必須指定特定的埠 ID。</td><td>在命令列中包含指定「埠」：31010 的 credentials.json 檔案以用於輸入認證。</td></tr></tbody></table>

## 常見 Tableau Prep 錯誤

下表描述在使用 Tableau Prep 時可能遇到的一些常見錯誤以及可以嘗試的解決方案。

<table style="width: 100%;" class="simple-table"><colgroup><col><col><col><col></colgroup><tbody><tr><th>錯誤</th><th>原因</th><th>如何修復</th><th>Knowledge 文章</th></tr><tr><td>無法連線到 Tableau Server。檢查伺服器是否正在執行以及 URL 是否正確。<code>tableauErrorCode=0xD5A9A6F9; tableauStatusCode=UNAUTHENTICATED; exceptionName=VizportalAuthenticationException</code></td><td>Proxy 或防火牆阻止 Tableau Prep Builder 的內嵌瀏覽器完成 Tableau Cloud 登入握手。</td><td><p>與 IT 部門合作，透過 Proxy 安全列出 Tableau Cloud URL。</p><p>從 Tableau Prep Builder 中登出並重新登出。</p><p>如果有自動 Proxy 設定指令碼，請驗證它是否在不提示輸入認證的情況下處理驗證。</p></td><td><a href="https://help.salesforce.com/s/articleView?id=001534030&amp;type=1&amp;language=zh_TW" target="_blank">在需要驗證的 Tableau Online 環境中無法從 Tableau Prep Builder 登入到 Tableau Online 需要驗證的 Proxy</a></td></tr><tr><td><p>所需的 SSL 憑證可能缺失或與 [serverhostname] 的 Tableau Server 憑證不相符。</p><p>在伺服器上執行流程時，也顯示為「找不到流程 ID 請求的憑證路徑」。</p></td><td>Tableau Server 上缺少 SSL 憑證鏈結檔案，或者執行 Tableau Prep Builder 的電腦上未安裝該鏈結檔案。在某些情況下，問題是由 AWS 負載平衡器使用不相容的 TLS 原則引起的。</td><td><p>請確保已將 SSL 憑證鏈檔案上傳到 Tableau Server。</p><p>在執行 Prep Builder 的電腦上安裝憑證（如果按兩下並選取「安裝憑證」會傳回「該檔案無效，無法用於以下內容：安全性憑證」，則憑證檔案本身可能格式錯誤。與 IT 合作匯出有效的鏈檔案。</p><p>如果落後於 AWS 負載平衡器，請將原則降級為 ELBSecurityPolicy-TLS-1-2-2017-01。</p></td><td><a href="https://help.salesforce.com/s/articleView?id=001471603&amp;type=1&amp;language=zh_TW" target="_blank">錯誤 - 所需的 SSL 憑證可能遺失或與 Tableau Server 憑證不相符 - 從 Tableau Prep 登入</a></td></tr><tr><td><p>由於基礎處理序意外停止，Tableau Prep Builder 已停止執行。如果問題仍然存在，請嘗試重新安裝產品。</p></td><td><p>這可能由多種因素觸發：VPN/網路設定（透過 Cato Network VPN 阻止本機主機通訊確認）、防毒幹擾或開啟特定 .tfl 檔案時連接埠檔案損壞。</p><p><b>附註</b>：切勿將 Tableau Prep Builder 安裝在 Tableau Server 節點上。這是此錯誤的已知原因。</p></td><td><p>重新安裝、檢查 AV 排除、驗證本機主機 IPv4/IPv6 通訊</p><p>如果是 VPN 特定的，請使用備用 VPN 進行測試以進行隔離;讓網路團隊參與檢查 localhost 區塊</p><p>若繫結至特定 .tfl 檔案，請收集 Prep 記錄和 IPS 轉儲，以調查 tabminerva 程序當機</p><p>確保未在任何 Tableau Server 節點上安裝 Tableau Prep Builder。</p></td><td><a href="https://help.salesforce.com/s/articleView?id=005384997&amp;type=1&amp;language=zh_TW" target="_blank">錯誤：由於啟動 Tableau Prep 時基礎處理序意外停止，Tableau Prep 已停止執行</a></td></tr><tr><td>AqlProcessor evaluation failed：已取消 — 流程在樞紐步驟後失敗</td><td>在樞紐步驟後變更樞紐欄的值時的已知問題。</td><td><p>注意：此修補檔適用於 2022.2 及更高版本。</p><p>升級到修補檔涵蓋的版本。</p><p>作為舊版本的解決方法，請避免在樞紐的下游步驟中修改樞紐的欄值。</p></td><td><a href="https://help.salesforce.com/s/articleView?id=001497312&amp;type=1&amp;language=zh_TW" target="_blank">錯誤：系統錯誤 - 與資料來源 （LoomDataSource） 通訊時發生錯誤 在樞紐步驟之後變更樞紐欄的值時發生</a></td></tr><tr><td>此流程需要的記憶體多於目前為執行此動作而配置的記憶體。請考慮篩選資料或將流程細分為更小的部分。</td><td>流程的大小或複雜性需要的記憶體超出 Tableau Cloud 中完成流程作業的可用記憶體量。</td><td><p>簡化流程。請嘗試在聯結之前移除未使用的欄位、套用篩選器、移動篩選器或匯總，以壓縮資料表。</p><p>嘗試使用流程輸出作為最終流程的輸入將流程拆分為較小的流程。</p><p>有關更多想法，請參閱<a href="https://www.tableau.com/zh-tw/blog/best-practices-authoring-data-preparation-flow" target="_blank">改善資料準備流程效能的最佳做法</a>。</p></td><td><a href="https://help.salesforce.com/s/articleView?id=001474406&amp;type=1" target="_blank">嘗試執行流程時出現錯誤「無法配置 ###### 位元組的記憶體：已超出 ###### 位元組的「全域記憶體限制」限制」</a></td></tr><tr><td>無法發佈資料來源」 — 流程在本機或輸出到 .hyper 檔案時成功執行，但在發佈到 Tableau Cloud 時失敗。</td><td>由於臨時檔案大小超過 Tableau Cloud 限制，流程失敗。當流程因與記憶體相關的 SQL 錯誤（例如，大型 JOIN 作業）而失敗時，也會出現這種情況，這些錯誤僅在 Tableau Cloud 中出現，而不是在本機出現。</td><td><p>將輸出切換到本機 .hyper 檔案，以確認該問題是雲端特定的。</p><p>降低流程複雜性、分成更小的流程、移除未使用的欄或使用即時連線。</p></td><td>不適用</td></tr><tr><td>Prep Builder 無法在 Windows 上開啟;偵錯記錄顯示與相對暫存資料夾路徑相關的錯誤。</td><td><p>Windows TEMP 環境變數設定為相對路徑（例如 <code>%USERPROFILE%\AppData\Local\Temp</code>）或包含重複的路徑項目。</p><p>Tableau Prep Builder 需要絕對路徑。</p></td><td><p>驗證 Windows TEMP 環境變數是否設定為絕對路徑（例如 <code>C:\Users[username]\AppData\Local\Temp</code>）</p><p>從 TEMP 變數中移除任何重複項目。</p></td><td>不適用</td></tr></tbody></table>

## 此區段的其他文章