版本到版本 Server 升级指南：支持的版本
重要
请参阅 Server 升级检查列表，以帮助规划和执行成功的 Server 升级，包括 升级前检查 工作流，以确定导致升级失败的问题。
本文档可提供什么帮助？
本文档重点介绍了在 Alteryx Server 的不同版本之间进行升级时需要注意的任务和变化。问题是逐渐累积的，因此在升级多个版本时，请仔细阅读每个部分。本文档不能取代发行说明（请参见各部分中的链接）。
发布时间表
每半年发布一次的版本会增加一些功能，但也可能更改 Server 管理，要求您或您的用户改变行为。
每个季度内发布的维护版本/补丁会解决初始版本中发现的问题。例如，2022.3 的第一个维护版本将会是 2022.3.2。
图例
停站 | 需要在升级到更高版本前先升级到该版本的重大变更。 |
MongoDB 升级 | Mongo 数据库版本已升级。 Alteryx Server 升级只能包括当前版本和目标升级版本之间的一个 MongoDB 版本升级。 |
关键 | 关键问题：管理员在转移到该版本或更新版本时必须解决或注意的问题。 |
此列表中条目的标准
此列表浓缩了每个版本的发行说明，以突出以下内容：
管理员或用户必须执行的操作。
对选择升级版本非常重要的项目（即，已更改的行为或缺陷）。
Server 管理中做出的重大变更。
快速链接
2023.2 及更早版本
对于不受支持的版本（2023.2 及更早版本），请参阅：不支持的版本跨版本 Server 升级指南。
2024.1
版本 | 升级到此版本，或更新版本时要执行的操作。 |
|---|---|
2024.1 | 管理功能：通过 UI 和 API 转让资产所有权的功能 管理员可以通过 Server UI 或使用 Server API V3 端点在用户之间转让工作流和计划所有权。 影响： 注意
|
2024.1 | 新功能：增加了新的数据库选项 (SQL DB) 可以使用用户管理的 SQL Server 数据库代替 MongoDB。目前，官方唯一支持的 SQL 版本是 MSSQL Server 2019 和 2022。 影响： |
2024.1 关键 | Python 升级：嵌入式 Python 从 3.8.16 升级到 3.10.13 影响： 如果在 Designer 中使用了不兼容的连接器版本，则会出现以下错误消息：“在我们的 Alteryx 发行版中找不到版本 3.8。请选择其他版本。内部错误 - 检测到死锁。” 任务：
|
2024.1 关键 | MongoDB 日期时间字段更改（Server 数据库中的服务时间戳已转换为 UTC 格式） 影响：我们将所有日期时间字段转换为 UTC 格式，以改进对时区和夏令时变化的处理。如需了解详情，请参阅 Server 2024.1 发行说明。
任务：查看在访问 MongoDB 或 API 的应用程序中如何处理日期时间字段。它们可能需要进行调整，以使日期时间符合 UTC 格式。 |
2024.1 | DCM 开发/生产 Server 管理：生产 Server 可将开发 DCM 重定向到生产连接 影响：向管理员菜单中添加了 DCM 连接和 DCM 连接处理。如需了解详情，请访问以下帮助页面： 任务：将 DCM 重定向添加到生产 Server，以允许从开发迁移的工作流访问生产数据源，而无需更改工作流。 |
2024.1 | DCM 管理：用户权限精细程度 影响：添加了新的 DCM 权限。如需了解详情，请参阅 用户角色与权限 帮助页面。 |
2024.1 | DCM 管理：新增了 DCM 通用外部加密保管库 影响：您可以配置一个通用加密保管库，该加密保管库可以使用基本身份验证，通过编程接口从任何加密保管库检索密钥。 |
2024.1 | 管理更改：DCM 并行共享 影响：您可以共享同一 DCM 连接用于协作，也可以单独用于执行。以前，您只能选择 1 个共享选项。如需了解详情，请参阅 数据连接管理器：Server UI。 |
2024.1 | “洞察”终止服务 影响：Alteryx Server 中不再提供洞察。如需了解详情，请访问我们的常见问题页面。 |
2024.2
版本 | 升级到此版本，或更新版本时要执行的操作。 |
|---|---|
2024.2 停站 关键 | 将嵌入式 MongoDB 升级至版本 7 影响：在 Server 2024.2 的安装过程中，嵌入式 MongoDB 将升级到版本 7.0。适合升级的最低 Server 版本为 2023.2（MongoDB 版本 6.0）。 任务：确保 Server 版本为 2023.2 或 2024.1，然后执行 Server 2024.2 发行说明 中所述的步骤。 |
2024.2 停站 关键 | 版本 2024.2 是包含 Crypto Migrator 代码 的最后一个版本。 此停站仅适用于从自 2022.1 或更早版本进行的用户管理的 MongoDB 升级，升级过程中需对数据库执行加密迁移。 任务：按照 版本到版本 Server 升级指南：不支持的版本 2022.3 部分和迁移准备工具中的说明执行加密迁移流程。 |
2024.2 | 将数据连接和工作流迁移到 DCM 现在，您可以将共享 Server 数据连接迁移到 DCM 连接。要执行此操作，请查看如何将 Server 数据连接迁移到 DCM 和 数据连接。 |
2024.2 | 将工作室中的用户限制为一个用户的可能性 管理员可选择通过将工作室中的用户限制为一个用户来关闭共享工作室。作为管理员，您现在可以通过将工作流从一个工作室转让给另一个工作室来轻松转让资产所有权。 要将工作室中的成员数限制为一个用户,请转至 管理员 > 设置 > 配置 > 用户。然后选中将工作室用户数限制为 1 个 复选框。如需了解详情，请参阅 Alteryx Server 设置。 |
2024.2 | 限制将工作流设为公开：全局设置 现在，管理员可以通过选中或清除限制公共工作流（全局）复选框来控制工作流的发布方式（公开或非公开）。为此，请转至 管理员 > 设置 > 安全。 如需了解详情，请参阅 Alteryx Server 设置。 |
2024.2 | Designer 代理设置扩展 在 Designer 中，新增了 选项 > 用户设置 > 编辑用户设置 > 代理 > 启用新代理设置（预览版），以便更好地控制代理设置并允许使用 PAC 脚本。 注意：在此初始版本中，该设置适用于 Designer 中的多项功能（例如，下载工具），但不适用于其他功能（例如，连接器或 ODBC）。如需了解详情，请参阅 用户设置。 |
2024.2 | 系统设置“取消运行时间超过（秒）的作业”现在适用于所有作业 在以前的版本中，此设置仅适用于计划作业。要允许手动作业的运行时间长于计划作业，请清除此设置并使用下面介绍的两个新的 Server UI 选项。 如需了解详情，请参阅 Alteryx Server 设置。 |
新增了用于将长时间运行的手动作业取消运行的选项 在 Server UI > 管理员 > 设置 > 资产 中，新增了一个选项，用于将运行时间超过指定时间的手动作业（包括 API 作业运行）取消运行。这适用于所有工作程序，除非该工作程序已设置 Alteryx 系统设置 > Worker（工作程序）> General（常规）> Cancel jobs running longer than (seconds)（取消运行时间超过（秒）的作业）。工作程序设置将覆盖 Server UI 设置。 | |
新增了用于将长时间运行的计划作业取消运行的选项 在 Server UI > 管理员 > 设置 > 资产中，新增了一个选项，用于将运行时间超过指定时间的计划作业取消运行。这适用于所有工作程序，除非该工作程序已设置 Alteryx 系统设置 > Worker（工作程序）> General（常规）> Cancel jobs running longer than (seconds)（取消运行时间超过（秒）的作业）。工作程序设置将覆盖 Server UI 设置。 | |
2024.2 | API 更新： |
向 GET v3/workflows/{workflowID}/jobs 中新增了 API 筛选
任务：查看在访问 MongoDB 或 API 的应用程序中如何处理日期时间字段。它们可能需要进行调整，以使日期时间符合 UTC 格式。 | |
订阅（工作室）的新 API 端点 管理员现在可以使用 Server V3 API 端点管理订阅（工作室）。这些端点有助于批量编辑订阅，并提供将单个用户移回单个工作室的功能。 如需详细了解这些端点，请参阅 订阅端点。 | |
工作流端点的 API 更新
如需了解详情，请转至 Server 2024.2 发行说明 和 工作流端点。 | |
用于允许更新单项计划设置的新 API 端点 使用新 API 端点 | |
作业端点的更新
如需了解详情，请参阅 作业端点。 |
2025.1
版本 | 升级到此版本，或更新版本时要执行的操作。 |
|---|---|
2025.1 | 面向非管理员用户的新凭证页面 非管理员用户现在可以在 Server UI 中访问凭证页面。此页面允许用户查看、创建、编辑和删除自定义凭证。如需了解详情，请参阅凭证：Server 用户界面。 |
2025.1 | 新增了面向管理员的工作流结果视图 管理员现在可以在“工作流结果”视图中查看工作流结果和作业消息。如需了解详情，请访问工作流结果：管理员界面。 |
2025.1 | 为 Alteryx 系统设置增加了审计日志 通过 Alteryx 系统设置应用程序对 RuntimeSettings.xml 所做的更新现在会记录在 |
2025.1 | Server API |
用于取消特定作业的新端点 新增了 如需了解详情，请转至作业端点。 | |
共享 Server 凭证的新端点 为 Server 凭证（非 DCM）增加了以下端点：
这些端点仅供管理员使用，且需要启用 TLS。如需了解详情，请前往凭证端点帮助页面。 | |
为计划端点增加了 Cron 表达式 通过使用 Cron 条目增加了动态计划灵活性。您现在可以在以下 API 中使用 Cron 表达式：
如需了解详情，请访问计划端点帮助页面。 | |
2025.1 | 管理员可以邀请用户添加凭证 此功能允许管理员邀请用户添加共享凭证，管理员可以管理和共享该凭证。更多详细信息，请参阅邀请创建或编辑凭证。 |
2025.1 | 新增了 SAML 断言加密支持 我们现在支持 SAML 断言加密，允许您对断言进行加密和签名。此功能在 FIPS 和非 FIPS 环境中均可用。 有关配置详细信息，请参阅配置 Alteryx Server 身份验证帮助页面。 |
2025.2
版本 | 升级到此版本，或更新版本时要执行的操作。 |
|---|---|
2025.2 停站 关键 | 将嵌入式 MongoDB 升级到版本 8 影响：在 Server 2025.2 的安装过程中，嵌入式 MongoDB 将升级到版本 8.0。 任务：查看架构版本对照表，以确保您的升级路径是迁移到相同版本的 MongoDB 或相邻的下一个版本（仅高一个版本）。您一次不能跨多个 MongoDB 版本直接升级 Server。如需了解详情，请转至 Server 2025.2 发行说明。 |
2025.2 | 将 Server 连接至 Alteryx One 现在，Alteryx Server 在“控制器”页面上包含了新的连接–Alteryx One功能。此功能简化了将 Alteryx Server 环境连接至 Alteryx One 平台的流程，并增强了该流程的安全性。它允许通过 Alteryx One 将世系元数据从 Server 直接传输到外部数据目录（如 Atlan 或 Collibra）。 任务： |
2025.2 | Designer 与 Server 更新分离 您可以独立于 Server 升级 Designer，因此用户可以立即访问最新的 Designer 功能，而无需等待 Server 批准或环境升级。使用较新版本 Designer 构建的资产不再被阻止发布到较旧的 Server 环境。 有关重要详情与持续更新，请转至 Designer Server 版本兼容性。 由于此更改，已向工作流 API 端点添加了一个新参数。如需了解详情，请转至为工作流端点新增的参数。 |
2025.2 | 已更新的 Server 主机恢复流程 在 2 个恢复选项之间进行选择：
从许可证门户下载脚本。如需详细了解新恢复流程，请参阅 Server 主机恢复指南。 |
2025.2 | 从 Server UI 计划分析应用程序 您现在可以直接从 Server UI 中计划分析应用程序。要计划分析应用程序，只需在 Server UI 中选择该应用程序，点击计划，设置您的偏好参数，填写所有必需的输入字段，然后保存计划即可。如需了解详情，请转至计划工作流。 |
2025.2 | Server API |
用于监控作业的新 API 端点 添加了 如需了解详情，请转至作业端点。 | |
新增 API 端点以支持 SDK 连接器 已将 此端点仅管理员可使用。如需了解详情，请前往 DCM 端点帮助页面。 | |
为工作流端点新增的参数 为了支持 Designer 和 Server 分离更新，以下工作流端点添加了一个新参数 -
这样可绕过当 Server 版本低于工作流版本时通常阻止上传的保护机制。如需详细了解使用情况，请参阅工作流端点。 | |
2025.2 | 用户凭证共享功能已完成 现在您可以使用重复凭证，即使这些凭证没有通过 Alteryx Server 平台共享。此更新还可解决可用性和可视问题，以实现更顺畅的凭证管理体验。 有关凭证的详细信息，请访问凭证：服务器用户界面和凭证：管理员界面。 |
2025.2 | Microsoft .NET 4.8+ 要求 Alteryx Server 2025.2 需要 Microsoft .NET Framework 4.8 或更高版本。 请在升级前确保已更新 .NET。 如需了解详情，请参阅： |
2026.1
版本 | 升级到此版本，或更新版本时要执行的操作。 |
|---|---|
2026.1 | WebView2 要求 影响：从 2026.1 版本开始，如果您使用 Alteryx One 应用程序和 Designer 功能，则必须安装 WebView2 才能在 Server 上运行 Designer。 如需详细信息，请参阅 Server 系统要求和 Microsoft Edge WebView2。 |
2026.1 | SMTP 电子邮件的 OAuth 支持 Alteryx Server 现已支持通过 OAuth 进行 SMTP 电子邮件投递。 摘要：为应对 Microsoft 停用 Exchange Online 中的基本身份验证，请在系统设置 > Server UI 中更新 SMTP 身份验证设置，以确保关键系统电子邮件（包括工作流警报和通知）的持续送达。 如需了解有关如何配置 Server 电子邮件的更多详情，请转至配置有关 Server 通知的电子邮件。 |
2026.1 | Server 上的集中式代理管理 Alteryx Server 现已支持针对工作程序节点上的引擎运行进行集中式代理管理。本次更新使 Server 与 Designer 进一步保持一致，并提升了代理配置的一致性、可见性和可控性。 |
2026.1 | Server 上的 AI 工具支持 新增对在 Alteryx Server 上运行包含提示词和 LLM 覆盖工具的工作流的支持。 任务：如需在 Server 上运行这些工作流，请务必配置通过服务主体凭证向 Alteryx One 进行身份验证的 DCM 连接。更新提示词和 LLM 覆盖工具，使其使用此 DCM 连接而非 Designer 的活动链接，并确保所有引用的 LLM 连接（含凭证）均已与服务主体共享。 当 DCM 连接已同步且 Server 环境允许网络访问 Alteryx 云平台时，工作流可在 Server 上成功运行。 如需详细了解 AI 工具，请参阅 Server 上的 AI 工具和服务主体帮助页面。 |
2026.1 | Python Upgraded to Version 3.13 The Python version has been upgraded from 3.10 to 3.13. All Python connectors must be reinstalled, and workflows using Python should be tested after the upgrade. For more information, refer to: |