Alteryx 嵌入式 Python
概览
Alteryx 平台包含一个嵌入式的 Python 版本，以支持产品中的多项功能。Alteryx Python 版本不会影响计算机上已安装的其他Python 版本。Alteryx 需要不时升级该 Python 版本。您可能会在 Jupyter Python 工具和其他使用 Alteryx Python SDK 的工具中看到版本更新信息。基于 Python 的数据连接器包括 Salesforce、Google BigQuery、Microsoft Azure Data Lake Store、Microsoft Power BI、Microsoft OneDrive 和 Microsoft Dynamics CRM。
Alteryx Python 兼容性
Alteryx 发行版 | 嵌入式 Python 版本 | 虚拟环境 |
|---|---|---|
2025.1（稳定更新）和更新版本 | 3.10.18 | Designer 中的 Python 工具现在使用内置虚拟环境，而不是以前基于 Miniconda 的设置。此更新简化了依赖关系管理，并减小了安装过程中与 Python 相关的文件的大小。 在 25.2 版本中，旧版 |
2025.1 | 3.10.15 | 标准（适用于 v1 SDK 的 Conda） 如果您的工作流包含对 |
2024.1 – 2024.2 | 3.10.13 | Conda |
2023.2 | 3.8.16 | Conda |
2020.4 – 2023.1 | 3.8.5 | Conda |
2019.3 – 2020.3 | 3.6.8 | Conda |
2019.3 之前 | 3.6.0 | 标准 |
Python 3.10 升级常见问题解答（2024.1 Alteryx Designer 和 Server 版本）
免责声明
我们将每月更新此文档，以纳入更多可用信息。
这是一项产品计划，将 Alteryx Designer 和 Server 从 Python v3.8.16 升级到 Python v3.10.13。这是因为 Python 不再提供对 v3.8 的支持。Alteryx 必须遵循这些措施以保持安全合规。安全性对 Alteryx 而言至关重要，我们必须在 2024.1 版本（2024 年 5 月初）发布时将 Designer 升级到 Python 3.10。
使用依赖于 Python 的 Designer 工具的所有客户。这包括数据连接器、合作伙伴构建的 SDK 工具、自定义构建的 SDK 工具、Python 工具以及 Intelligence Suite 工具。
依赖 Python 的 Designer 工具必须升级以适配 Python 3.10.13，否则将无法在 Designer 和 Server 24.1 中运行。
如果您在早于 24.1 的 Alteryx 版本的工作流中使用了 Python SDK 工具，该版本的 SDK 工具将无法与 24.1 兼容。若要继续，请务必...
安装与 24.1 兼容的新版 SDK 工具。
更新您的工作流以使用新版本的工具。
将工作流重新发布到 Alteryx Server。
鉴于用户可能需要使用升级后的工具测试工作流，对于倾向于在单个沙盒环境中测试新工作流的 Server 客户，建议创建一个独立的沙盒环境来测试 24.1。通过独立的测试环境，您可以在迁移到生产环境之前，继续使用现有工具测试当前的工作流，并利用新环境来测试 24.1 版本中的新工具。此设置必不可少，因为 24.1 版本的 Python 型连接器无法与较早 Alteryx 版本兼容，反之亦然。
是的，自定义工具的用户需要在完成 Python 升级后下载并安装最新版本的工具。如果适用，您可以在社区 Gallery 上发布工具的最新版本，或向 Alteryx Marketplace 提交更新。
在计划于 2024 年 5 月发布的 2024.1 版本中，我们将把 Designer 的 Python 版本从 3.8.16 升级至 3.10.13。因此，请合作伙伴和客户在安装 Alteryx Designer 2024.1 之前，务必先将其 SDK 工具升级到 Python 3.10.13 版本。
现已提供有关如何将工具升级到 Python 3.10.13 的逐步升级说明。转至将自定义工具更新到 Python 3.10 的说明。
如果您有其他疑问，请转至 Alteryx IO 开发人员论坛并在那里发布。我们也会在有更多材料可用时定期更新本文档。
Python 3.8.5 升级常见问题解答（2020.4 Alteryx Designer 和 Server 版本）
以下常见问题解答与升级至 Python 3.8.5 有关，该升级随 2020.4 版 Alteryx Designer 和 Server 发布。
如果您在以前版本的 Designer 中安装了 YXI 自定义工具，工具模块依赖项中不兼容的 Python 版本引用问题将导致自定义工具不能正常工作。
此外，该工具可能包含不再兼容的 Python 模块依赖项，或者使用了新 Python 版本不再支持的 Python 语言特性。
升级脚本：
我们提供了嵌入式 Python 升级脚本，以便您查看计算机或服务器上可能受到影响的工具列表。考虑升级到 2020.4（和未来版本）的 Alteryx 用户和 Server 管理员，或者已经升级但需要帮助来对包含 Python SDK 工具的工作流进行故障排除的用户，都可以使用这个脚本。
如果您在此前安装了 YXI 自定义工具并且升级到 Designer 20.4，您将收到一条告知用户相关问题的错误消息。此外，您将无法运行包含该工具的工作流。
所有 Alteryx 产品的工作流都将受到影响。
请清点您拥有的所有工具和版本。有两个文件路径可查找此信息，具体取决于您的安装。
对于提升权限安装（以管理员身份运行），请导航至 Program Data（隐藏）> Alteryx > Tools。
对于非提升权限安装，请导航至 Users > [User] > App Data（隐藏）> Roaming > Alteryx > Tools。
一共有六个基于 Python 的数据连接器：Salesforce、Google BigQuery、Microsoft Azure Data Lake Store、Microsoft Power BI、Microsoft OneDrive 和 Microsoft Dynamics CRM。这有助于您跟踪需要重新安装的版本。虽然不是所有数据连接器都会出现故障，但我们强烈建议您重新安装处于工作状态的工作流中每个连接器的所有版本。
如果某个工具不需要任何更新即可与 Python 3.8 兼容，请记下该工具的版本和位置。因为此过程需要重新安装工具软件包，所以在删除工具之前，请确保您能找到该工具的 YXI 软件包。接着，建议您删除工具目录及其文件，然后重新安装该工具的 YXI。重新安装 YXI 之前，请勿打开使用该工具的工作流，否则将可能导致工作流出现未知行为。
有些工具可能不需要执行此步骤也可以继续工作，但我们强烈建议您按照此处提供的说明操作。
对每台计算机的每个工具的安装目录都需要按照以上说明进行操作。如果您使用非管理员和管理员安装，请确保对所有存在该工具的位置都进行了更新。
如果某个工具需要更新来解决使用差异、依赖关系问题或新 WHL 文件打包问题，则需要从工具开发人员处获得新工具。在大多数情况下，这些是合作伙伴构建的工具，但也可能是 Alteryx 构建的旧版工具，甚至是来自社区或 Gallery 的工具。
否，我们在 Python 升级工作中升级了这些工具。正常情况下，它们将正常运行。
您应该不会察觉到 Python 工具或 Insights 工具的任何变化，这两个工具均使用 Python 但未使用 Python SDK。但是，由于基础软件包（如 pandas）不断更新，在某些情况下，代码可能不再与 Python 版本兼容。
如果 “Python” 工具使用了不再受支持的功能，您可能会碰到工具的 Python 代码出现问题的情况。如果出现这种情况，则需要更新代码以与 Python 3.8 兼容。3.7 和 3.8 之间可能有一些变化。这两个版本的相关链接如下：
如果您将 20.3 版含 Python SDK 工具的工作流上载到已升级至 20.4 的Server，基础代码是相同的，且您已通过在 Server 上重新安装相同的 YXI 文件来修复使用基于 Python 工具的工作流，您将不会遇到错误。所有活跃工作流中的基于 Python 的工具都应在 Server 上重新安装。
工作流引用的是工具名称和工具版本，而不是 Python 版本。
如果重新打包了工具并且创建了新版本以支持 20.4，则工具之间将存在版本不兼容问题，且需要在 Server 或 Designer 中更新该工具。
我们还将 Alteryx Analytics Hub 中的嵌入式 Python 版本升级到了 3.8.5。与 Server 一样，Designer 和 Alteryx Analytics Hub 之间的版本也可能不同。如果您使用的 YXI 具有不兼容的依赖项版本，则需要重新安装该 YXI。
如果用户拥有 Alteryx Analytics Hub 和 Alteryx Intelligence Suite 许可，则必须安装 Alteryx Analytics Hub 以升级 20.2 稳定版，然后使用 20.4 下载安装 Alteryx Intelligence Suite （可在 downloads.alteryx.com 的 AAH 旁边找到）。最后，重新安装 YXI。
可以。Python 版本与 20.3 及更旧版本不兼容，但与 20.4 及更高版本兼容。无论何时升级，都需要更新 YXI 工具才能实现兼容。
可以。如果您没有重新安装任何 Python 工具，您应该能够恢复到以前的状态，并且不会出现问题。更新 Python 工具后，您必须继续该过程以切换版本。例如，如果要从 20.3 升级到 20.4 并重新安装 Salesforce，但随后又要恢复为 20.3，则需要重新安装 Salesforce。
如果您使用的是基于 Python SDK 的工具，则不能。如果不这样做，安装多个版本极有可能不会遇到任何问题。
您可以继续使用相同 Alteryx 版本的非管理员安装和管理员安装。
安装将会成功。您可能会遇到的问题是：任何未安装的基于 Python 的工具在更新之前都无法在 20.4 上运行。更新这些工具后，对于非基于 Python 3.8（Alteryx 版本低于 20.4 ）的安装，它们不再能够正常工作。
如需详细了解如何在计算机上安装多个版本，请访问 https://community.alteryx.com/t5/Alteryx-Designer-Knowledge-Base/How-to-install-two-versions-of-Designer-on-the-same-machine/ta-p/454948。
如果您需要其他帮助，请在以下 URL 中创建一个客户支持请求：https://community.alteryx.com/t5/Support/bd-p/SupportPage。
Python 开发人员常见问题解答
建议合作伙伴和工具创建者升级他们的本地安装并测试他们已创建的所有工具。他们使用的模块可能含有与 Python 3.8 不再兼容的版本或者不再受支持的语法。
如果您的工具使用 WHL 文件，请在 Python 3.8 环境中重新打包该工具及其 WHL 文件并重新发布，以便用户访问。
如果工具创建者使用的是已针对 20.4 更新的 Beta 版 ayx-plugin-sdk，则需要将该包更新至最新版本以确保其持续正常运行。
Snakeplane 中的多个模块已进行更新以支持 Python 3.8.5，其中包括 numpy 和 pandas。在某些情况下，您可能需要更新 Snakeplane 才能使工具正常工作。