--- schema_version: "1" id: 379b138249040a28688c7ffd4ae884186d9900056ac1df9747ada5a4b735ca66 title: 查找和解决兼容性问题 collection: tableau version: current locale: zh-cn portal_url: https://docs.salesforce.com/tableau/current/zh-cn/desktopdeploy/desktop_deploy_compatibility.md canonical_url: https://help.tableau.com/current/desktopdeploy/zh-cn/desktop_deploy_compatibility.htm source_site: help.tableau.com content_type: documentation content_hash: 6996382c37123c386bd1e787b53034bd3c9f6c0caeb62823f4e8f1f38cc47915 description: Find and resolve version compatibility issues between Tableau Desktop, Server, and Prep Builder. --- [跳转到主要内容](#main-content) # 查找和解决兼容性问题 理想情况下，组织中的每个人都可以运行相同版本的 Tableau Desktop 或 Tableau Server，但这并不总是可行的。在大型组织中，不同的个人或组可能需要使用不同版本的 Tableau 产品。 本文介绍兼容性注意事项，以及 Tableau Desktop、Tableau Prep Builder 和 Tableau Server 如何能协同工作。 **注意**：本文仅讨论仍然享受技术支持的 Tableau 产品。Tableau 在每个产品版本发布后为其提供 24 个月的技术支持。有关各个版本及其支持计划的列表，请参见 Tableau 网站上的[支持服务](http://www.tableau.com/zh-cn/support/services)页 ## Tableau Desktop 和 Tableau Server 之间的兼容性 兼容性问题通常只会在 Tableau 产品的_发布升级_版本之间出现，而不是在_维护版本_之间出现。举例来说，如果您使用 Tableau Desktop 2022.1，而其他人使用 Tableau Desktop 2021.4，或者您需要发布到 Tableau Server，而其仍在运行版本 2021.1，则可能会遇到兼容性问题。 > [!IMPORTANT] > > **重要信息：**Tableau 产品并不总是同时发布。例如，可能有新升级版本的 Tableau Desktop 可用，但兼容版本的 Tableau Server 可能在几个月后才可用。安装新版本 Tableau Desktop 时，请确保它与 Tableau Server 兼容。 使用任何版本的 Tableau Desktop 创建的工作簿可连接到任何支持版本的 Tableau Server。但连接之后可能会出现兼容性问题，具体情况视您所使用的版本和执行的操作而定。 ### 从 Tableau Desktop 发布到 Tableau Server 如果 Tableau Server 的版本与 Tableau Desktop 的版本相同或比该版本新，则您只能将工作簿和数据源发布到 Tableau Server。例如，您可以将工作簿和数据源从 Tableau Desktop 2021.2 发布到 Tableau Server 2021.2、Tableau Server 2021.3 或 Tableau Server 2021.4。 您可以将在 Tableau Desktop 版本 2022.1 上创建的工作簿降级，以将其发布到 Tableau Server 版本 2021.3。有关如何将工作簿降级的详细信息，请参见本文中的[将工作簿降级](#Downgrad)。 ### 从 Tableau Server 下载工作簿 从 Tableau Server 下载的工作簿的版本与最后一次对其进行编辑的 Tableau 版本相同。例如，假设 Amanda 运行的是 Tableau Desktop 2021.2，并将工作簿发布到 Tableau Server 2021.3。如果 Zachary 运行的也是 Tableau Desktop 2021.2，则他可以连接到 Tableau Server，下载工作簿，并将其打开。 但是，有一些可能会出现兼容性问题的情形： - **如果其他人在服务器上编辑并保存该工作簿，则该工作簿将更新为 Tableau Server 的该版本。** - **如果某人将工作簿从 Tableau Server 下载到较新版本的 Tableau Desktop，并编辑、保存和发布该工作簿，则工作簿将更新到较新版本的 Tableau Desktop。** 例如，假设 Elizabeth 将工作簿从 Tableau Desktop 2021.2 发布到 Tableau Server 2021.3。Ted 将工作簿从 Tableau Server 下载到 Tableau Desktop 2021.3。他对工作簿进行编辑，并将其重新发布回服务器。工作簿现在更新为较新版本。Zachary 和 Elizabeth 两人均使用 Tableau Desktop 2021.2，他们可下载工作簿，但无法将其打开，因为工作簿已更新到 Tableau 版本 2021.3。 ### 连接到发布的数据提取 使用 .tde 文件格式的数据提取在刷新（完整或增量）或附加到时会自动升级为 .hyper 格式。有关 .hyper 数据提取格式的详细信息，请参见[数据提取升级为 .hyper 格式](https://help.tableau.com/current/server/zh-cn/extracting_upgrade.htm)。 对于以前版本的 Tableau Server，在 Tableau Server 上刷新或附加在 Tableau Desktop 中创建的包含数据提取的任何已发布工作簿或数据源时，该工作簿或数据源将保持其原始版本。 **注意**：Tableau 版本 2024.2 之后不再支持 .tde 文件。 ### 连接到基于 Tableau Server 的数据源 Tableau Desktop 中的工作簿可使用已发布到较高版本 Tableau Server 的数据源。但是，如果连接的数据源使用 Tableau Desktop 早期版本中所没有的功能，则那些字段将不可用。 在 Tableau Desktop 中创建的工作簿始终可以使用 Tableau Server 早期版本中的数据源。例如，Tableau Desktop 2022.1 工作簿可以使用 Tableau Server 2021.1 中的数据源。 ## Tableau Desktop 版本之间的兼容性 Tableau Desktop 用户可共享工作簿 — 例如，通过电子邮件发送工作簿或将工作簿复制到公司网络上的某个位置。但如果两个用户使用不同版本的 Tableau Desktop，则共享并非总是可行。规则很简单： - **较新版本的 Tableau Desktop 可以打开使用较旧版本创建的工作簿。** - **较旧版本的 Tableau Desktop 无法打开使用较新版本创建的工作簿。** 例如，假设 Amanda 使用 Tableau Desktop 版本 2021.3 创建 Tableau 工作簿，并将工作簿发送给 Zachary，其 Tableau Desktop 版本为 2022.1。Zachary 将能够打开该工作簿，但会看到此警告消息： `The workbook will be upgraded when it is saved. The upgraded file can't be read by earlier versions of the application.` 如果 Zachary 编辑并保存工作簿，并将其发回给 Amanda，他将需要先将工作簿降级，以便 Amanda 能够打开工作簿。如果未降级，当 Amanda 尝试在 Tableau Desktop 版本 2021.4 中打开工作簿时，加载将会失败，因为该工作簿现在为 2022.2 工作簿。 有关在 Tableau Desktop 版本之间将工作簿降级的详细信息，请参见本文中的[将工作簿降级](#Downgrad)。 ### 使用 Tableau 数据提取 较新版本的 Tableau Desktop 可打开使用较旧版本创建的数据提取，但较旧版本的 Tableau Desktop 无法打开使用较新版本创建的数据提取。 但是，如果在较旧版本中创建 .tde 数据提取，并在 Tableau Desktop 10.5 及更高版本中打开工作簿并刷新（完全或增量刷新），或者附加到数据提取，则数据提取将转换为 .hyper 格式，并且工作簿变得与较旧版本的 Tableau 不兼容。 **注意**：从版本 2020.3 开始，Tableau 数据提取 (.tde) 文件不再受支持，应转换为 .hyper 格式。对于 2024.3 及更新版本，.tde 文件不再可用。 有关 .hyper 数据提取格式的详细信息，请参见[数据提取升级为 .hyper 格式](https://help.tableau.com/current/server/zh-cn/extracting_upgrade.htm)。 ### 将工作簿降级 如果您需要将工作簿发布到早期版本的 Tableau Server，或者与使用早期版本的 Tableau Desktop 的人员共享工作簿，则可以将工作簿降级到早期版本。降级的工作簿可在所选的版本及更高版本中打开。 Tableau 仅支持在发布后 24 个月内下载产品版本。超过 24 个月的版本已达到使用寿命，不再提供。 ### 将工作簿导出到早期版本 您可以使用 Tableau Desktop 中的“文件”\>“导出为版本”将工作簿导出到其他版本的 Tableau，或在 Tableau Cloud 或 Tableau Server 中工作簿的工具栏中选择**“下载”**\>**“Tableau 工作簿”**。有关详细信息，请参见[导出视图和工作簿](https://help.tableau.com/current/pro/desktop/zh-cn/save_export_image.htm)。 ### 为 Tableau Server 降级工作簿 如果使用较新版本的 Tableau Desktop 和较旧版本的 Tableau Server，您可以在发布期间将工作簿降级为较旧的 Tableau Server 版本。 发布工作簿时，您将看到一条警告消息，指出将会对工作簿进行降级。 ![Tableau Server 的发布对话框，并显示一个警告，指出服务器运行的版本比您的 Tableau Desktop 副本旧](/tableau/current/zh-cn/desktopdeploy/zh-cn/Img/downgrade_workbook.png) 如果继续发布工作簿，则会移除旧版本中不可用的任何特性和功能以实现兼容。您可能需要重新添加对工作簿进行降级时移除的功能。 **注意：**此选项不适用于数据源。 ## Tableau Prep Builder 兼容性 有关 Tableau Prep Builder 兼容性的详细信息，请参见 _Tableau Prep Builder_ 帮助中的[与 Tableau Prep 的版本兼容性](https://help.tableau.com/current/prep/zh-cn/prep_conductor_compatibility.htm)。 ### Tableau Prep Conductor Tableau Prep Conductor 是作为 Tableau Server 版本 2019.1 的 Data Management 的一部分引入的。 - 若要将流程计划为在 Tableau Server 上运行，您必须使用 Tableau Server 版本 2019.1 或更高版本，并且必须启用 Tableau Prep Conductor。 - 若要将流程计划为在 Tableau Cloud 上运行，您必须使用 Tableau Cloud 版本 2019.3 或更高版本，并且必须启用 Tableau Prep Conductor。 ### 不同版本的 Tableau Prep Builder 和 Tableau Server 之间的兼容性 从较新版本的 Tableau Prep Builder 发布到较旧版本的 Tableau Server 可能会导致兼容性问题。例如，Tableau Prep Builder 版本 2021.3.1 添加的新功能可能不兼容 Tableau Server 版本 2021.2，但将兼容 Tableau Server 版本 2021.4 和 Tableau Server 的任何更高主要版本，例如版本 2022.2。 在 Tableau Server 中，Tableau Prep Conductor 会在发布流程时检测流程中包括的功能。如果它发现不支持的功能，则流程仍然可发布到 Tableau Server，但无法运行、计划流程或将其添加到任务。Tableau Cloud 会定期自动更新，因此与 Tableau Prep Builder 的所有版本兼容。 如果有较旧版本的 Tableau Server，则仍可以在 Tableau Prep Builder 中手动运行或使用命令行运行不兼容的流程。有关使用此过程的详细信息，请参见“通过命令行刷新流程输出文件”。 ### Tableau Prep Builder 不同版本之间的兼容性 当您尝试在新版本的 Tableau Prep Builder 中打开旧版本的流程，以及尝试在旧版本中打开新版本的流程时，或者甚至在使用不同的计算机在相同版本的 Tableau Prep Builder 中打开流程时，都可能会遇到兼容性问题。 例如： - 流程包括的输入连接器或功能在打开流程的版本中不受支持。 - 用于打开流程的计算机没有安装所需的输入连接器，或其具有的连接器驱动程序版本不兼容。Tableau Prep Builder 需要安装 64 位驱动程序才能处理流程输入连接器。如果在尝试打开流程时出现兼容性问题，流程可能会打开，但包含错误，或者流程根本无法打开，并且您收到错误消息。 ## Tableau Cloud 兼容性 发布 Tableau 的新主要版本时，通常会升级 Tableau Cloud 服务器。将工作簿和数据源发布到 Tableau Cloud， Tableau Cloud 版本将相同或晚于 Tableau Desktop 和 Tableau Prep Builder，因此，兼容性问题得到缓解。但是，请考虑与 Tableau Bridge 安装以及使用 Tableau 命令行实用程序（例如 tabcmd 和 Tableau 数据提取实用程序）的现有脚本或进程的兼容性。 关于主要升级的构成的信息，请参见[升级 Tableau Desktop 和 Tableau Prep Builder](https://help.tableau.com/current/desktopdeploy/zh-cn/desktop_deploy_upgrade.htm)。 ### 何时升级 Tableau Desktop 以使用 Tableau Cloud Tableau Cloud 升级到新的主要版本之后，您仍然可以从早期版本的 Tableau Desktop 中发布数据源和工作簿。但是，您将需要升级到 Tableau Desktop 的最新主要版本以执行以下操作： - 下载并打开一个在 Tableau Cloud Web 编辑环境中编辑和保存的已发布工作簿。 - 制作数据源的本地副本。 如果您尝试在比 Tableau Cloud 服务器版本早的 Tableau Desktop 版本中使用此类工作簿或数据源，则您将收到以下错误： `This file was created by a newer version of Tableau. Please upgrade Tableau Desktop to the version (or greater) that the file was saved in.` ### 何时升级 Tableau Bridge 以使用 Tableau Cloud Tableau Bridge 是一个代理客户端，它运行在您网络中的一台计算机上，用于将您的专用网络数据连接到 Tableau Cloud。Tableau 建议将 Bridge 升级到最新版本以避免任何兼容性问题，因为某些新功能和错误修复需要同时更新 Tableau Cloud 和 Bridge。 如果通过 Tableau 身份验证启用了多重身份验证 (MFA)，则 Bridge 客户端必须运行 Tableau Bridge 版本 2021.1 及更高版本。有关使用 MFA 的 Tableau 的详细信息，请参见[关于多重身份验证和 Tableau Cloud](https://help.tableau.com/current/online/zh-cn/security_auth.htm#mfa_requirement)。 ### 何时为站点管理升级 tabcmd 如果您使用 tabcmd 管理您的 Tableau Cloud 站点，例如，自动执行工作簿上载、管理用户等任务，那么您将需要 tabcmd 的最新支持版本以运行这些任务。使用 tabcmd 的过时版本会导致错误和不可预知的结果。 欲了解详细信息和 tabcmd 的当前支持版本，请参见 Tableau Cloud 帮助中的[安装 tabcmd](https://help.tableau.com/current/online/zh-cn/tabcmd.htm#install)。 ### 使用 Tableau 数据提取实用工具刷新数据源 Tableau 数据提取命令行实用工具随 Tableau Desktop 一起自动安装。如果您使用此工具在 Tableau Cloud 上向已发布数据源推送数据，请考虑以下要求： - 您将需要使用站点 ID，而不是站点名称。 站点 ID 是 Tableau Cloud URL 的一部分。例如，在以下示例中，站点 ID 为 WidgetWorks： `https://online.tableau.com/t/WidgetWorks/view/projects` 有关 `-t` 选项的详细信息，请参见 Tableau Cloud 帮助中的[自动执行数据提取刷新任务](https://help.tableau.com/current/online/zh-cn/help.htm#to_refresh_extract_commandline.htm)。 - 在您向 Tableau Cloud 发布数据源后，您必须使用与 Tableau Cloud 版本匹配的 Tableau Desktop 版本附带的数据提取实用工具来刷新已发布数据源中的数据。