版本到版本 Server 升级指南：支持的版本
重要
请参阅 Server 升级检查列表，以帮助规划和执行成功的 Server 升级，包括 升级前检查 工作流，以确定导致升级失败的问题。
本文档可提供什么帮助？
本文档重点介绍了在 Alteryx Server 的不同版本之间进行升级时需要注意的任务和变化。问题是逐渐累积的，因此在升级多个版本时，请仔细阅读每个部分。本文档不能取代发行说明（请参见各部分中的链接）。
发布时间表
每半年发布一次的版本会增加一些功能，但也可能更改 Server 管理，要求您或您的用户改变行为。
每个季度内发布的维护版本/补丁会解决初始版本中发现的问题。例如，2022.3 的第一个维护版本将会是 2022.3.2。
图例
停站 | 需要在升级到更高版本前先升级到该版本的重大变更。 |
MongoDB 升级 | Mongo 数据库版本已升级。 Alteryx Server 升级只能包括当前版本和目标升级版本之间的一个 MongoDB 版本升级。 |
关键 | 关键问题：管理员在转移到该版本或更新版本时必须解决或注意的问题。 |
此列表中条目的标准
此列表浓缩了每个版本的发行说明，以突出以下内容：
管理员或用户必须执行的操作。
对选择升级版本非常重要的项目（即，已更改的行为或缺陷）。
Server 管理中做出的重大变更。
快速链接
2022.3
新增功能 / 发行说明 / Server 社区博客 / 概述社区博客
版本 | 升级到此版本，或更新版本时要执行的操作。 |
|---|---|
2022.3 关键 | 针对 2022.1 缺陷 TCPE-1100 的升级要求：如果要从 2022.1 升级到此版本或更高版本，则必须安装补丁。 影响：如果当前使用的是 22.1，则在升级到 22.3 或经过 22.3 升级到其他版本之前，您必须使用 22.1.1.9.42691_Patch_9 或更高版本，以避免出现缺陷 TCPE-1100。 此缺陷会影响工作流版本号，将它们全部设置为“1”。 任务：如果您尚未使用 Patch_9 或更高版本，请在继续升级之前应用最新的 22.1 补丁。 |
2022.3 关键 | MongoDB 重新加密：在升级之前，必须使用 AES256 和 SHA256 散列标准重新加密数据库集合 影响：应在升级到 2022.3+ 之前运行 加密迁移准备工具，以便在 Server 继续运行时在后台重新加密工作流。如果运行了该准备工具，则在升级后服务首次启动时，一些集合以及 RuntimeSettings.xml 也将进行加密迁移。 任务： 在开始此过程之前，您的 Server 应为 2021.2 或更高版本。如果您使用的是之前的版本，请先升级到 2021.2 和 2022.1 之间的版本，然后再尝试升级到 2022.3+。 在升级 Server 之前运行加密迁移准备工具，并查看迁移程序日志中是否有包含 升级后，您可以删除未加密的旧集合。有关清理所创建的临时文件和减小 Mongo 数据库大小的信息，请与支持部门联系（CSE 请参阅 此处）。 如果需要回滚升级，则需要还原升级过程中生成的 RuntimeSettings.xml 备份，C:\ProgramData\Alteryx\。 |
2022.3 关键 | Designer 版本要求：需要 Designer 2022.3 影响：2022.3 Server 使用的加密方法需要 Designer 2022.3。 任务：用户必须升级 Designer，才能将工作流保存到 Server。 |
2022.3 关键 | 配置更改：SAML ACS 端点必须全部小写 影响：ACS 端点现在为小写 (/saml2/acs)，但以前是混合大小写 (/Saml2/Acs)。 这会阻止服务启动。 [TCPE-940 要求在不出错的情况下接受新旧两种大小写方式]。 任务：将 IDP 中的 ACS 端点更改为全部小写。 |
2022.3 补丁 2 | 管理更改：允许用户使用共享 Server 数据库连接运行工作流的选项 影响：新增了允许在没有共享凭证的情况下访问工作流选项，以允许已通过集合共享工作流的任何人运行使用共享 Server 数据库连接的工作流。其他用户不要求与他们明确共享 Gallery 连接。 任务：转至 Server UI > 管理员 > 设置 > 资产。然后选中允许在没有共享凭证的情况下访问工作流复选框。 |
2022.3 | 管理更改：负载平衡器 影响：新增了 Alteryx 系统设置 > Server UI > Canonical Address（规范地址）选项，以确保来自 Server 的电子邮件消息将使用用户用于访问 Server UI 的 URL。 任务：如果您使用负载平衡器，请将这些值设置为用户通常用于访问 Server UI 或 API 的 URL。 |
2022.3 | Server 使用情况报告已弃用 影响：Alteryx 不再支持 Server 使用情况报告。以前的版本可能会继续正常工作。 |
2022.3 | 密码管理：新增了 HashiCorp 和 CyberArk 密码保管库支持 |
2022.3 | “下载工具”访问安全性较低的握手重协商：设置文件允许特定于站点的控制 影响：如果从下载工具接收到“SSL 连接错误”，请使用 对等验证允许列表。下载工具已更新至 OpenSSL 3.0.7。 |
2022.3 | 内部更改：控制器令牌长度 影响：Server 2021.4 引入了更长、更安全的控制器令牌，但从 2021.3 升级而来的版本保留了较短的令牌。如果令牌在某个时间点没有重新生成到更长的长度，则它将在 2022.3 升级中自动重新生成。这将以相同的方式在所有节点上发生，因此它们将创建相同的较长令牌，并能在升级后与控制器进行通信。 任务：使用新的控制器令牌，以便将来向 Server 体系结构添加新节点。 |
2022.3 | 缺陷 TGAL-7199：工作流的所有版本均标记为“1”（已在 2022.3.1_Patch2 中更正） 影响：查看工作流的版本列表时，所有版本都显示“1”，而不是连续版本号。这是一个 UI 问题，且运行作业时使用的是正确的版本。 |
2023.1
版本 | 升级到此版本，或更新版本时要执行的操作。 |
|---|---|
2023.1 关键 | 最低 Designer 版本 影响：需要 Designer 2022.3 补丁 3 或更高版本才能与 Server 连接。请参阅 Server 2023.1 发行说明。 |
2023.1 | 管理更改：允许用户使用共享 Server 数据库连接运行工作流的选项 影响：新增了允许在没有共享凭证的情况下访问工作流选项，以允许已通过集合共享工作流的任何人运行使用共享 Server 数据库连接的工作流。其他用户不要求与他们明确共享 Gallery 连接。 任务：Server UI > 管理员 > 设置 > 资产 > 选中允许在没有共享凭证的情况下访问工作流复选框。 |
2023.1 | 密码管理：新增了 AWS 秘钥管理器密码保管库支持 影响：AWS 秘钥管理器 |
2023.1 | API 添加：对于 Active Directory (AD) 身份验证 Server，可将 AD 用户组添加到自定义用户组 影响：新增了端点：
|
2023.1 | 管理更改：针对 SAML 身份验证方法的 Azure Active Directory 用户组支持 影响：管理员现在可以使用 Azure Active Directory (Azure AD) 和 SCIM 协议同步用户和用户组对 Server 的访问。 |
2023.1 | DCM 功能：用于禁用 Designer 和 Server 之间的 DCM 同步的选项 影响：此功能在生产 Server 上非常有用，可确保用户不会意外同步并在其本地 Designer 中使用生产凭证。 任务：Alteryx 系统设置 > DCM > 选中阻止 Server 与 Designer 之间的 DCM 连接同步复选框。有关更多信息，请参阅 DCM - Server。 |
2023.1 | 管理更改：工作程序可使用唯一凭证连接到用户管理的 MongoDB。 影响：这会允许对每个工作程序进行审计。 |
2023.1 | 数据库连接：32 位数据库连接终止服务 影响：关于停止支持 32 位数据库连接的常见问题。32 位连接将不再起作用。 |
2023.1 R 安装程序 关键 | R 升级：RInstaller_2023.1.1.200.exe+ 中的嵌入式 R 版本从 4.1.3 升级到 4.2.3 影响：R 版本将为 4.1.3 或 4.2.3，如下所示：
任务：
|
2023.1 | 分析应用程序缺陷（已在 2023.1_Patch_2 中更正） 影响：
|
2023.1 关键 | Connect 产品：Connect 与初始 2023.1 版本不兼容 影响：发行说明将指明与 2022.3 兼容的补丁。 |
2023.2
版本 | 升级到此版本，或更新版本时要执行的操作。 |
|---|---|
2023.2 MongoDB 6.0.5 | MongoDB 升级：嵌入式 MongoDB 从版本 4.2.15 升级到 6.0.5 影响：嵌入式 MongoDB 升级到 6.0.5 任务：如果使用嵌入式 MongoDB，升级到此版本或更高版本会将 MongoDB 升级到版本 6.0.5。请注意，可用驱动器空间要求为当前 MongoDB 大小的 1-2 倍。 |
2023.2 关键 | MongoDB 升级对话框：用于启动嵌入式 MongoDB 升级的对话框已最小化 影响：升级到 2023.2 时，选择完成升级后，嵌入式 MongoDB 迁移对话框将会打开，但会立即最小化，给人升级已完成的印象 [TGAL-9041]。如需了解详情，请参阅 升级到 Server 版本 23.2 时服务日志中出错：功能兼容性版本值无效，预期为“5.0”、“5.3”或“6.0”。 任务：确保此对话框可见并单击启动 MongoDB 升级。在完成 MongoDB 升级之前，服务将不会启动。 |
2023.2 | MongoDB 更改：从 AlteryxGallery 集合中删除了 __ServiceDataBlob 字段 影响：__ServiceDataBlob 字段已从 AlteryxGallery 集合中删除；字段现在显示为标准 MongoDB 字段。 任务：如果您有使用 ServiceDataParser 宏指令从该 Blob 中解压缩数据的管理员工作流，则需要对它们进行重构。 |
2023.2 | DCM 管理更改：现在可以共享 DCM 连接以进行协作 影响：在 Server UI 中共享 DCM 连接时，“为协作共享连接”选项可让其他用户在其 Designer 中使用 DCM 连接。如需了解详情，请参阅 数据连接管理器：Server UI > 在 Designer 中共享。 任务：此更改使共享工作流的协作更加容易，并且可以使用同事的 DCM 连接创建新的工作流。 |
2023.2 | Python 升级：嵌入式 Python 从 3.8.5 升级到 3.8.16 影响：用户应在工作流中重新测试 Python。引擎仍然使用 Python 版本 3，因此对脚本的影响应该很小。 任务：如需了解详情，请参阅 Alteryx 嵌入式 Python。 |
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 版本为 23.2（MongoDB 版本 6.0）。 任务：确保 Server 版本为 2023.2 或 2024.1，然后执行 Server 2024.2 发行说明 中所述的步骤。 |
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 端点 | |
作业端点的更新
如需了解详情，请参阅 作业端点。 |