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.Open the flow in Tableau Prep Builder to view error details.”（流程中存在错误。无法运行流程。请检查 credentials .json 文件是否包括所有必需的凭据。在 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 文件的正确路径。 |
| “Could not find match for <mapr01:5181>,<mapr02:5181>,<mapr03:5181>”（找不到 <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 部署指南中的系统要求(链接在新窗口中打开)。