与 Tableau Prep 的版本兼容性

版本号格式

Tableau Desktop 和 Tableau Prep Builder 的版本号具有不同的格式。例如：

Tableau Desktop 和 Tableau Prep Builder 的维护版本不遵循相同的顺序。

查找我们的版本

注意：要下载特定版本的 Tableau Prep Builder，请打开产品下载和发行说明（链接在新窗口中打开）页面，然后从页面左侧的列表中选择 Tableau Prep Builder。

Tableau Prep Builder

要查找产品的发行版本，请打开 Tableau Prep Builder，然后在顶部菜单中执行以下操作之一：

• Windows：在顶部菜单中，单击“帮助”>“关于 Tableau Prep Builder”或“关于 Tableau Prep”，具体取决于您的版本。

• Mac：在顶部菜单中，单击 Tableau Prep Builder >关于 Tableau Prep Builder 或 Tableau Prep >关于 Tableau Prep，具体取决于您的版本。

版本号显示在对话框的左下角。

Tableau Server

Tableau Prep Conductor 作为 Tableau Server 版本 2019.1 中的数据管理加载项的一部分引入。若要计划流在 Tableau Server 上运行，您必须使用 Tableau Server 版本 2019.1 或更高版本，并且必须启用 Tableau Prep Conductor。

To find your version of Tableau Server, open Tableau Server in your web browser. In the top menu bar click the information icon in the top right corner and select About Tableau Server. A dialog opens that tells you which version of Tableau Server you are using. For information about how to enable Tableau Prep Conductor, see Step 2: Configure Flow Settings for your Server(Link opens in a new window) in the Tableau Server help.

Tableau Online

Tableau Prep Conductor was introduced as part of the Data Management Add-on in Tableau Online version 2019.3. To schedule flows to run on Tableau Online, you must be using Tableau Online version 2019.3 or later and Tableau Prep Conductor must be enabled.

To find your version of Tableau Online, open Tableau Online in your web browser. In the top menu bar click the information icon in the top right corner and select About Tableau Online. A dialog opens that tells you which version of Tableau Online you are using. For information about enabling Tableau Prep Conductor, see Tableau Prep Conductor(Link opens in a new window) in the Tableau Online help.

Compatibility between different versions of Tableau Prep Builder

Generally, a new version of Tableau Prep Builder can open flows created in an older version. However, compatibility issues can occur when you try to open a flow between newer and older versions of Tableau Prep Builder or even when opening flows in the same version of Tableau Prep Builder using different computers.

For example:

• The flow includes input connectors or features that aren't supported in the version where the flow is opened.

• The machine that you use to open the flow doesn't have the required input connectors installed or has a driver version for the connector that isn't compatible. Tableau Prep Builder requires 64-bit drivers to be installed to work with flow input connectors.

If compatibility is an issue, when you try to open the flow, the flow may open but contains errors or the flow won't open at all and you receive an error message. In the example below, the flow won't open and an error message displays and lists the incompatible features and options for resolving the issue.

Fix compatibility issues with Tableau Prep Builder

To fix compatibility issues, try one of the following:

• Upgrade to the latest version of Tableau Prep Builder.

  Click the update button on the bottom of the Discover pane to download the latest version of the product and follow the instructions to Install Tableau Prep Builder(Link opens in a new window) in the Tableau Desktop and Tableau Prep Builder Deployment Guide. If you don't have access to the update button on the Discover pane, instructions about how to download the latest version of the product are included in the Install Tableau Prep Builder topic.

• Make sure your computer is compatible with Tableau Prep Builder. For example, make sure that you have the 64-bit drivers installed for the connectors used by the flow. To install drivers, see the Driver Download(Link opens in a new window) page.

• Open a copy of the flow that has the incompatible features removed.

Compatibility between different versions of Tableau Prep Builder and Tableau Server

Publishing from a newer version of Tableau Prep Builder to an older version of Tableau Server can result in compatibility issues. For example, new features added in Tableau Prep Builder version 2021.3.1 may not be compatible with Tableau Server version 2021.2 but would be compatible with Tableau Server version 2021.4 and any later major versions of Tableau Server, such as version 2022.1.

In Tableau Server, Tableau Prep Conductor detects the features that are included in a flow when it has been published. If it finds features that it doesn't support, the flow can still be published to Tableau Server, but the flow can't be run, scheduled, or added to a task. Tableau Online is updated automatically on a regular basis, so is generally compatible with all versions of Tableau Prep Builder.

If you have an older version of Tableau Server, you can still run incompatible flows manually in Tableau Prep Builder or using the command line. For more information about using this process, see, Refresh flow output files from the command line.

Detect incompatible features

Depending on the version of Tableau Prep Builder you are using, you can spot incompatible features in different ways.

Tableau Prep Builder (version 2020.1.1 and later)

Sign into Tableau Server, and Tableau Prep Builder will detect and disable incompatible features for you. Any features that aren't compatible will show as grayed out. If you want to still use the feature and run the flow manually or from the command line, you can enable it from the menu.

Note: Starting in Tableau Prep Builder version 2020.1.4, once you sign into your server, Tableau Prep Builder remembers your server name and credentials when you close the application so that the next time you open the application you are already logged into your server.

1. Hover over the disabled feature to see if it's disabled because it isn't compatible with your server version, then click the Use Features button. This option is available in the Flow pane and from the menus in the Profile pane, Results pane and data grid.

   Note: Features can be disabled for other reasons, such as data updates being paused or if the option isn't available for a particular step or data type.

   

2. The selected feature is applied and all incompatible features are enabled and available to use. Incompatible features are flagged with a warning so that you can easily find and remove them if you want to run the flow using a schedule in your version of Tableau Server.

To disable this feature entirely and enable all incompatible features, do the following:

1. From the top menu, select Help > Settings and Performance > Disable Incompatible Features.

   

2. Select Disable Incompatible Features to clear the check mark next to this option. To enable the feature again, select Disable Incompatible Features. This option should be enabled by default.

Tableau Prep Builder (version 2019.3.1 and later)

As you build your flow, Tableau Prep Builder can detect incompatible features as you add them and flags these features with an alert icon. You must be signed into your server to see these alerts. This new alert system helps you quickly identify incompatible features in your flow so you can decide whether to keep the feature in your flow or remove it.

Hover over alerts in the Flow pane to view information about the incompatible feature, or use the new alert center to see more details. In the alert center, click the View in Flow link to navigate directly to the step, annotation, field or change that triggered the warning.

Tableau Prep Builder (all versions)

If you publish a flow with incompatible features, the following message is displayed and lists the features that aren't supported in the version of Tableau Server that you are signed into. In Tableau Prep Builder version 2019.2.3 and earlier, this is the only way to see which features are incompatible in your flow.

Note: The error message lists the Tableau Prep Builder version when the feature was introduced. Tableau Prep Builder doesn't release maintenance versions, so for the feature to be compatible, Tableau Server must be running the next major release version. In the example below, the Duplicate Fields feature was introduced in Tableau Prep Builder version 2019.2.3 so it won't be compatible with the 2019.2.3 Tableau Server maintenance release version. Instead it would be compatible with the next major release for Tableau Server, version 2019.3.

If you continue to publish the flow, publishing will complete successfully. However, when you open the flow in Tableau Server or Tableau Online, you will see the following message:

To schedule and run the flow in Tableau Server, you can do one of the following:

• Look for the latest major release of Tableau Server(Link opens in a new window) that is compatible with the version of Tableau Prep Builder that you are using. For example, if you are using features introduced in Tableau Prep Builder version 2019.2.3, to run the flow in Tableau Server, you would need the server version to be 2020.3 or later.

  Tableau Online is updated automatically on a regular basis, usually every quarter. Test your flow first, to make sure it is compatible with your current version of Tableau Online before publishing.

• Before publishing the flow, remove the incompatible features from the flow, then publish the flow.

• If you already published your flow to Tableau Server, try editing the flow directly on the server (version 2019.4 and later), download the flow and remove the features, or create the flow in an older version of Tableau Prep Builder using only the features available in that version.

  Note: To download a specific version of Tableau Prep Builder, open the Product Downloads and Release Notes(Link opens in a new window) page and select Tableau Prep Builder from the list on the left side of the page.

Fixing compatibility issues

If the flow is already published to Tableau Server, try the steps below to remove the incompatible features using your current version of Tableau Prep Builder. After you remove the features and no longer see the version incompatibility message or warnings, republish your flow to Tableau Server or Tableau Online and schedule it using the Tableau Prep Conductor.

Note: Tableau Prep Conductor is part of the Data Management Add-on. It must be enabled in Tableau Server or Tableau Online to run flows using the scheduling functionality. For more information about the Data Management Add-on, see Tableau Data Management Add-On(Link opens in a new window). For more information about enabling Tableau Prep Conductor in Tableau Server or Tableau Online, see Step 2: Configure Flow Settings for your Server(Link opens in a new window) in the Tableau Server help or Tableau Prep Conductor(Link opens in a new window) in the Tableau Online help.

Identify incompatible features

If you are working in Tableau Server, it doesn't currently list the incompatible features in your flow. To identify the list of features to remove from the flow, you need to open the flow in Tableau Prep Builder then find and remove them in your flow.

1. Open your flow. If you are in Tableau Prep Conductor, from the More actionsmenu, click Download to download and open the flow in Tableau Prep Builder or simply open the flow in Tableau Prep Builder.

2. If you downloaded the flow, click on the downloaded flow to open it.

3. Depending on your version, do one of the following:

• Version 2019.3.1 and later: From the top menu select Server >Sign In. Make sure you select the same server that is incompatible with the flow. Any incompatible steps, annotations, fields, or changes should be marked with an alert icon.

  In the top right corner of the flow pane, click Alert to view the details for each incompatible feature. Click View in Flow to navigate to the incompatible feature to take action.

  

• Version 2019.2.3 and earlier: From the top menu select Server >Publish Flow. If you need to sign into the server again, make sure you select the same server that is incompatible with the flow. A warning dialog opens that lists the features that are not compatible with your server version. Note the features so you can identify and remove them from the flow. Then click Cancel to close the dialog.

  

4. From the top menu, click File > Save As to save a copy of your flow. Use the options in the following sections to remove incompatible features from your flow.

Remove incompatible features from the flow

You can use various methods to find and remove features from your flow. This section shows some options to help you resolve incompatibility errors.

Incompatible data sources

If the data source isn't compatible, for example a new connector was added that isn't yet supported in Tableau Prep Conductor, you'll need to connect to a data source that is supported.

To change your data connection do the following:

1. In the Connections pane, click the drop-down arrow on the connector and select Remove to remove the data source connection.

   This will temporarily put your flow in an error state.

2. Connect to a compatible data source and drag it to the Flow pane. To connect the new Input step with your flow, drag the step to the first step in the flow where you want to connect it and drop it on the connecting step on the Add option.

   

3. Repeat these steps to replace any other connectors. Then save your flow and republish it.

Incompatible features

To remove incompatible features you'll need to find the steps where the features were used and remove them. You can follow the instructions in Identify incompatible features to locate the incompatible features.

1. 如果该功能是步骤类型，请在“流程”窗格中单击使用该功能的步骤。右键单击或按住 Ctrl 键单击 （MacOS） 的步骤，然后选择“删除”。

2. 如果该功能是清理操作，请在“流程”窗格中单击使用该功能的步骤。您可以将鼠标悬停在“流程”窗格或“配置文件”或“结果”窗格中的批注上，以查看更改列表。

   注意：在 Tableau Prep Builder 版本 2019.1.3 及更高版本中，您可以将鼠标悬停在“流程”窗格或配置文件卡中的某个步骤中表示您要查找的更改的图标上，然后从更改列表中选择批注。更改将在“更改”窗格、“配置文件”或“结果”窗格和数据网格中突出显示。

3. 如果需要，请打开“更改”窗格，然后选择与需要删除的功能匹配的更改。单击更改以将其选中，然后单击“删除”将其从流中删除。

   

4. 重复这些步骤以替换任何其他功能。然后保存流并重新发布。