版本到版本 Server 升级指南：不支持的版本
重要
请参阅 Server 升级检查列表，以帮助规划和执行成功的 Server 升级，包括 升级前检查 工作流，以确定导致升级失败的问题。
本文档可提供什么帮助？
本文档重点介绍了在 Alteryx Server 的不同版本之间进行升级时需要注意的任务和变化。问题是逐渐累积的，因此在升级多个版本时，请仔细阅读每个部分。本文档不能取代发行说明（请参见各部分中的链接）。
本文档仅包含不支持的 Server 版本。如需详细了解支持的版本，请参阅版本到版本 Server 升级指南：支持的版本。
发布时间表
每半年发布一次的版本会增加一些功能，但也可能更改 Server 管理，要求您或您的用户改变行为。
每个季度内发布的维护版本/补丁会解决初始版本中发现的问题。例如，2022.3 的第一个维护版本将会是 2022.3.2。
图例
停站 | 需要在升级到更高版本前先升级到该版本的重大变更。 |
MongoDB 升级 | Mongo 数据库版本已升级。 Alteryx Server 升级只能包括当前版本和目标升级版本之间的一个 MongoDB 版本升级。 |
关键 | 关键问题：管理员在转移到该版本或更新版本时必须解决或注意的问题。 |
此列表中条目的标准
此列表浓缩了每个版本的发行说明，以突出以下内容：
管理员或用户必须执行的操作。
对选择升级版本非常重要的项目（即，已更改的行为或缺陷）。
Server 管理中做出的重大变更。
快速链接
2018.1
版本 | 升级到此版本，或更新版本时要执行的操作。 |
|---|---|
2018.1 MongoDB 3.4 | MongoDB 升级：嵌入式 MongoDB 从版本 3.0.4 升级到 3.4。 任务：如果使用嵌入式 Mongo，请在升级到 2021.4+ 之前先升级到 2019.3-2021.3，以确保嵌入式 Mongo 升级到版本 4.0。请注意，可用驱动器空间要求为当前 Mongo 数据库大小的 1-3 倍。 |
2019.3
版本 | 升级到此版本，或更新版本时要执行的操作。 |
|---|---|
2019.3 MongoDB 4.0 | MongoDB 升级：嵌入式 MongoDB 从版本 3.4 升级到 4.0.10 任务：如果使用嵌入式 Mongo，请在升级到 2021.4+ 之前先升级到 2019.3-2021.3，以确保嵌入式 Mongo 升级到版本 4.0。请注意，可用驱动器空间要求为当前 Mongo 数据库大小的 1-3 倍。 |
2019.3 关键 | Python 升级：嵌入式 Python 从 3.6.0 升级到 3.6.8 (Conda) 影响：用户应在工作流中重新测试 Python。引擎仍然使用 Python 版本 3，因此对脚本的影响应该很小。 任务：所有连接器工具必须从 YXI 重新安装。 |
2020.1
版本 | 升级到此版本，或更新版本时要执行的操作。 |
|---|---|
2020.1 | MongoDB 问题：如果用户名、电子邮件地址或订阅为空，将导致在此版本和未来版本中升级失败。 任务：在升级到此版本或更高版本之前，请使用 升级前检查 工作流识别 NULL 值。 |
2020.1 | 管理更改：默认情况下，创建者可以创建集合。 影响：这为创建者增加了以前可能不具备的功能。 任务：要删除用户的此功能，请编辑其用户记录并将创建集合设置为否。 |
2020.1 | 管理更改：具有查看者角色的用户无法在与他们共享的集合中运行工作流 (TGAL-2666)。 影响：对于想要在集合中运行共享给他们的工作流的用户，需要将其角色设置为成员。预期错误消息：此工作流已发布在私人工作室中。要运行发布在私人工作室中的工作流，需要有 Analytics Gallery 成员身份。请联系共享该工作流的创建者，以申请成员身份。如需详细了解成员身份，请联系 sales@alteryx.com。 任务：将用户的角色设置为成员。 |
2020.1 | 缺陷 TGAL-2745：如果使用 AD 身份验证：计划、集合和单个用户可能无法显示（已在 2020.3.9 中更正）。 影响：在使用 Active Directory 身份验证的情况下，如果删除了 AD 用户，则：
任务：要确定您是否有任何 Server 用户在升级前已删除 AD 用户账户，请运行 AD 健康检查工作流。如果遇到此问题，请联系客户支持部门以解决[使用 Windows 身份验证时出现的 CSE Gallery 错误]。 |
2020.2
版本 | 升级到此版本，或更新版本时要执行的操作。 |
|---|---|
2020.2 | 新增功能
|
2020.3
版本 | 升级到此版本，或更新版本时要执行的操作。 |
|---|---|
2020.3 | 新增功能
|
2020.3 | 缺陷 TSM-317：输出工具 SQL Server 错误（已在 2021.2 中更正） |
2020.3 | 缺陷 TGAL-2832：如果使用 AD 用户组，则现在将使用 AD“显示名称”，它可以不同，也可以留空（已在 2021.4 中更正） 影响：如果使用 AD 身份验证，AD 用户组名称将从“网络名称”更改为“显示名称”字段。这可能导致 AD 用户组名称在 Server UI 中有不同的显示或完全留空。 |
2020.3 关键 | 缺陷 TGAL-2671：Active Directory 身份验证导致管理员访问用户列表的速度缓慢（已在 2020.4 中更正） 影响：如果使用 Active Directory 身份验证，请迁移至版本 2020.4+。 |
2020.4
版本 | 升级到此版本，或更新版本时要执行的操作。 |
|---|---|
2020.4 关键 | Python 升级：嵌入式 Python 从 3.6.8 升级到 3.8.5 (Conda) 影响：用户应在工作流中重新测试 Python。引擎仍然使用 Python 版本 3，因此对脚本的影响应该很小。 任务：所有使用 Python 的连接器工具必须从 YXI 重新安装。 |
2020.4 | 新增功能
|
2020.4 | 管理更改：无法再与私人工作室共享集合，而是与用户共享集合。 影响：此功能允许使用 Active Directory 身份验证的 Server 使用后门，以允许不同 AD 森林中的用户访问集合。 使用后门的步骤如下：
在此之后，另一个域中的 AD 用户无法共享该集合，因为该集合只能共享给同一 AD 森林中的用户。 |
2020.4 | 缺陷 TGAL-6039：如果使用 AD 身份验证，则无法更改集合所有者（已在 2022.1 中更正） 影响：在使用 Active Directory 身份验证的情况下，如果删除了拥有集合的 Server 用户的 AD 用户，则集合更改所有者页面将显示为空白。 任务：在 Server UI 中编辑用户，并将其角色设置为无访问权限，以更正此问题。 |
2020.4 | 缺陷 TDALI-1078：来自渲染工具的 PowerPoint 输出已损坏（已在 2022.3 中更正） 影响：打开 PPT / PPTX 文件时出现错误： |
2021.1
版本 | 升级到此版本，或更新版本时要执行的操作。 |
|---|---|
2021.1 关键 | 管理更改：现在，必须将 Server 共享数据库连接与尝试使用该连接运行或计划工作流的用户进行共享。在此之前，使用共享数据库连接的工作流可以与集合共享，并且集合中的所有用户都能够运行该工作流。 影响：之前正常运行的工作流和计划现在可能会收到无法转换别名错误。2022.1 补丁 5 和 2022.3 补丁 2 提供了恢复此功能的选项。 任务：对于升级后收到错误的工作流，请确定工作流使用的共享 Server 数据库连接，并将其与尝试运行或计划该工作流的用户进行共享。 |
2021.1 | 新增功能
|
2021.1 | 系统更改：配置文件位置已更改。 影响：
|
2021.1 | 安全性增强：强制将 OAuth 参数作为标头而非查询参数发送。 |
2021.1 | 缺陷 TGAL-2872：管理员可以看到其他用户在共享工作流上运行的作业，但在尝试访问结果时会收到访问被拒错误（已在 2021.4 中更正）。 影响：如果 UserA 通过集合或在同一工作室与管理员共享工作流，则管理员将看到 UserA 已手动或通过计划运行的作业。当管理员选择该作业以查看结果时，他们会收到 |
2021.2
版本 | 升级到此版本，或更新版本时要执行的操作。 |
|---|---|
2021.2 停站 | 首个兼容 2022.3+ 加密迁移的版本 影响：版本 2021.2 - 2022.1 与在升级到 2022.3+ 时执行的 MongoDB 加密迁移兼容。 任务：如果从早期版本升级到 2022.3+，则需要升级到 2021.2 - 2022.1，然后进行测试，再升级到 2022.3。 |
2021.2 | MongoDB 更改：重复的电子邮件地址将导致在此版本和更高版本中升级失败。 影响：在升级到此版本或更高版本之前，请使用 升级前检查 工作流识别重复的电子邮件地址。 |
2021.2 | 新增功能
|
2021.2 | 已删除的功能：已从工作流页面中删除用于共享工作流的选项。 影响：这将从该页面中删除用于通过社交媒体和电子邮件共享工作流的选项。 |
2021.2 | 缺陷 TCPE-120：Designer 选择工具缺陷。重命名的字段名称“XXX”与现有字段名称冲突（已在 2022.1 中更正）。 影响：如果传入数据字段名称在工具配置后改变了大小写，则选择工具上会出现错误消息。 |
2021.2 | 升级更改：如果 MongoDB 架构迁移失败，服务将无法启动。 影响：这可确保在服务启动前解决阻止架构迁移的问题。升级前检查 工作流是确保架构迁移成功的最佳方法。 |
2021.2 | 缺陷 TCPE-531：.hyper 文件将字符串作为 V_WString 读入 Alteryx 影响：.hyper 文件将字符串作为 V_WString (1,073,741,823) 读入 Alteryx，而之前的版本将字符串作为 V_WString (255) 读入。 任务：读取 .hyper 数据后，使用自动字段或选择工具重置列类型。 |
2021.3
版本 | 升级到此版本，或更新版本时要执行的操作。 |
|---|---|
2021.3 | 性能改进-计划预测性能显著提高 |
2021.3 | 缺陷：运行 alteryxservice setserversecret 会导致错误设置 Server 密钥失败：错误CryptImportKey(3)：不良数据 (-2xxx) 影响：未创建缺陷。要更正此错误，请编辑运行时设置，删除 Server 密钥部分的内容并保存。 |
2021.3 | 数据库连接 - 终止对 32 位数据库连接的支持 影响：请参阅 关于停止支持 32 位数据库连接的常见问题。将在 2023.1 后停止支持 32 位连接。 任务：用户应迁移到 64 位连接，请参阅 21.3 和 32 位连接。 |
2021.3.4 | 缺陷 TGAL-6268：API 端点 影响：
任务：请参阅有关您需要进行的更改的讨论，以及执行已根据此缺陷更新的工作流迁移的工作流示例：迁移工作流。 |
2021.3.6 MongoDB 4.2 | MongoDB 升级：嵌入式 MongoDB 从版本 4.0 升级到 4.2 影响：2021.3 的 .6 维护版本升级了 MongoDB 版本，详情请参阅 下文中的 2021.4 部分。 |
2021.3.6 | 缺陷 TGAL-6566：升级到 2021.3.6 后服务未能启动，并且 LastStartupError.txt 中出现以下错误：Mongo error: Index with name: fd5e7f7ad987788251ca676578977ec1 already exists with a different name: generic server error" code: <mongodb:85>（已在 2021.3.7 中更正）。 影响：这仅影响到 2021.3.6 的升级。 任务：联系支持部门，并参阅 CSE 内部文章 无法在版本为 4.2+ 的用户管理数据库上升级 Server。TAM 注意事项：文章中的步骤很简单，可在升级之前主动完成（请参见 Jennifer Powell）。 |
2021.4
版本 | 升级到此版本，或更新版本时要执行的操作。 |
|---|---|
2021.4 MongoDB 4.2 | MongoDB 升级：嵌入式 MongoDB 从版本 4.0.10 升级到 4.2.15 影响：初始升级到 4.0.10，随后通过补丁升级到 4.2.15 [CSE 内部 (TGAL-6772)]。 任务：如果使用嵌入式 MongoDB，升级到此版本或更高版本将把 MongoDB 升级到版本 4.2。请注意，可用驱动器空间要求为当前 Mongo 数据库大小的 1-2 倍。 注意 如果您首次安装的 Server 版本低于 2018.1，并且您的 MongoDB 文件夹不包含扩展名为 .WT 的文件，则需要备份并还原 Mongo 数据库，然后在本次升级之前将 Server 设置为使用还原后的数据文件夹。请参阅 MongoDB 从 MMAPv1 迁移到 WiredTiger 存储。[CSE 内部- TGAL-6590 和 Teams]（已在 2021.3.7 中更正）。 |
2021.4 关键 | 内部更改：控制器令牌长度延长 影响：升级后，较短的控制器令牌将继续有效，但您将无法使用较短的令牌执行 Server 主机恢复，因为“AlteryxService.exe setserversecret”步骤不会接受该令牌。最佳实践是主动将您的控制器令牌重置为延长后的新长度，以确保将来能够执行 Server 主机恢复。 任务： 极其重要
|
2021.4 | 新功能：数据连接管理器 (DCM) 影响：用户可在 DCM 中为凭证、数据源和连接器存储密码。用户可在本地或 Server 上的工作流中使用这些密码，并可在 Server 上共享它们，以便其他用户或用户组可以在 Server 上运行该用户的工作流。这会将凭证的控制权从 Server 管理员移交给发布工作流的用户。 |
2021.4 | 新功能：API V3 新增了许多新的管理端点、OAuth2 和新的 API 端点 影响： 任务：如果您的 Server 使用的是 localhost 以外的基址，请将域复制到 Alteryx 系统设置 > Gallery > General（常规）中的 Web API 地址中。  如果您有负载平衡器，则必须实施粘滞会话才能使用 OAuth2。否则，当负载平衡器将 API 调用发送到并非生成该 Bearer 令牌的计算机时，将导致间歇性 401-未授权错误。 [CSEs - Jira TGAL-6353, TCPE-402; Aha SERV-605] |
2021.4 | Server UI 更改：私人工作室和主页合并 影响： |
2021.4 | Server UI 更改：如果用户已在私人工作室之间移动，他们现在将看到自己所创建的所有工作流 影响：在此版本之前，如果用户在私人工作室（订阅）之间移动，他们将只能看到当前私人工作室中的工作流。改为在“我的工作区”中查看工作流后，用户现在将能看到自己创建过的所有工作流。但是，尽管可以显示，用户将无法删除或打开除当前订阅（在管理员> 订阅 中分配）中的工作流以外的工作流。 这是朝着从 Server 产品中删除私人工作室，转而通过集合共享工作流的方向迈出的一步。在未来的版本中，用户将能打开和删除其所有工作流，无论这些工作流是在哪个私人工作室中创建的。 任务：无需执行任何操作。 |
2021.4 | 管理更改：“与我共享的作业”选项卡已从私人工作室（现称为我的工作区）中删除 影响：如果用户通过在同一私人工作室中启用工作室设置“共享计划”来共享计划的工作流作业结果，则他们将无法再在其私人工作室中看到“与我共享的作业”选项卡，以查看这些计划的作业结果。 任务：要提供对共享计划的访问权限：
|
2021.4 | 改进：增强了遥测功能，以在工作流层面跟踪使用情况 影响：
|
2021.4 | 缺陷 TGAL-6408：分配给私人工作室的默认工作程序标记未保存（已在 2022.3 中更正） 影响：私人工作室分配的工作程序设置未保存。 任务：在发布工作流时设置作业标记（用户必须将分配作业设置为 true）。 |
2021.4 | 缺陷 TGAL-6502/TCPE-292：如果您有用户管理的 MongoDB Atlas，则超过 250 个用户/订阅时架构迁移会失败（已在 2021.4.2_Patch2 中更正） 影响：已在上述版本中更正。 |
2021.4 | Defect TCPE-473: Collection names appear with %20 or %26 instead of space of ampersand (corrected 2023.1) 影响：在过去的版本中，集合名称被保存为 URLEncoded，其中空格将被替换为 %20（以及其他替换字符）。2021.4+ 显示的集合名称与数据库中显示的名称完全一致。 任务：您可以通过查看 AlteryxGallery.collections 集合中是否存在带有 %20 的名称来确定这是否会是一个问题。如果存在此类名称，您可以在 Server UI 中编辑集合以进行更正。如果数量太多，无法轻松编辑，请联系客户支持部门寻求帮助。 |
2021.4 | Excel XLSX 文件处理更改：如果 Excel XLSX 文件在 Excel 中打开，则无法再读取这些文件 [TDCB-3592] 影响：做出此更改是为了确保数据完整性 |
2021.4.2 | 缺陷 TDES-4123：有关使用锁定用户的 Designer 对单个特定 Server UI URL 的访问的功能（已在 2021.4.2_Patch2 中更正） 影响：如果在本地 Designer 安装中使用以下功能来 (1) 指定默认 Server UI URL 和 (2) 阻止用户连接到他们选择的 Server UI，则用户将丢失文件 > 打开工作流菜单中的默认 Server UI，从而无法再从 Server UI 打开工作流。 受影响的功能：控制 Designer 对 Server 的访问 导致问题的特定设置： <Designer> <ManageGalleriesEnabled>False</ManageGalleriesEnabled> <DefaultGalleryUrl>http://my-server.com/gallery</DefaultGalleryUrl> </Designer> 任务：将 XML 文件 |
2021.4.2 | 缺陷 TGAL-6443： 影响：如果工作流最初是从 Designer 发布的，则使用 |
2021.4.2 | 安全通知：AMP Engine（已在 2021.4.2_Patch1 中更正） 影响：Alteryx 收到 AMP 处理中存在漏洞的报告。Alteryx 正在调查可能产生的影响。(TELC-2814) |
2021.4.2.47792 补丁 5 | 缺陷 TGAL-6990：Gallery 数据连接包含空白密码时升级失败（已在 21.4.2 补丁 6、22.1.1 补丁 4 中更正） 影响：存在包含空白密码的 Gallery 数据连接时升级失败，请参阅 社区 [TGAL-6990]。 任务：
|
2021.4.2.47792 补丁 5 | 缺陷 TGAL-7256：Server 主机恢复（打开）后 DCM 连接不起作用 影响：如果将 Mongo 数据库还原到新计算机（Server 主机恢复），DCM 连接将不起作用（错误因每个使用 DCM 的工具而异）。 任务：解决方法-最佳选项：
|
2022.1
版本 | 升级到此版本，或更新版本时要执行的操作。 |
|---|---|
2022.1 关键 | Server 要求更改：建议的逻辑核心和内存要求已更改 影响：2022.1 中默认已启用 AMP，并且内存和逻辑核心要求已更改，以支持此功能。此外，AMP 现在可以运行同步工作流（每 8 个逻辑核心 1 个）。请注意下表中从“物理”到“逻辑核心”的更改。  任务：除非禁用 AMP，否则请检查工作程序节点是否符合新准则。另请参阅：AMP Engine 最佳实践。 要在 Server 上禁用 AMP，请参阅 AMP Engine 最佳实践中的“如果我想保留当前的引擎系统设置，应该怎么办？”。 使用 AMP 时的最佳实践：允许 Server 管理同步工作流和内存，请选中：
|
2022.1 关键 | 设置更改：AMP Engine 和 "允许 Server 管理同时运行的工作流"默认为打开 [TCPE-309] 影响：这将根据上述新的 AMP 建议重置现有的 Workflows Allowed to Run Simultaneously（允许同时运行的工作流）设置。如果您选择禁用 AMP，则需要还原同步工作流设置，以确保性能不受影响（非 AMP 同步工作流的计算方法为 physical_cores / 2）。 任务：如需了解详情，请参阅 发行说明中的“默认已启用 AMP Engine”部分。 要禁用 AMP：Alteryx 系统设置 > Engine（引擎）> General（常规）> Engine（引擎） > Original Engine Only（仅原始引擎） |
2022.1 关键 | API 更改：OAuth1 API 已弃用 影响：API 现在仅使用 OAuth2。选择 Server UI 页面右上角的问号，查看 API 文档。有关关键链接和方向，请参阅介绍 OAuth2 的 2021.4 部分。   脚本中的 OAuth1 身份验证必须更新为 OAuth2。首先考虑升级到 2021.4，因为在 2021.4 中这两种身份验证类型都可用，因此可以在不停机的情况下转换脚本。 |
2022.1 补丁 5 | 管理更改：允许用户使用共享 Server 数据库连接运行工作流的选项 影响：新增了允许在没有共享凭证的情况下访问工作流选项，以允许已通过集合共享工作流的任何人运行使用共享 Server 数据库连接的工作流。其他用户不要求与他们明确共享 Gallery 连接。 任务：转至 Server UI > 管理员 > 设置 > 资产，然后选中 允许在没有共享凭证的情况下访问工作流。 |
2022.1 内置身份验证的停站 | 内置身份验证更改：内置身份验证密码加密已更改 [TGAL-6431] 影响：内置身份验证密码加密已更改。如果您使用内置身份验证，则需要先升级到此版本，然后再升级到更高版本，并执行以下步骤。 为自定义登录尝试新增了其他选项。 任务： 要求用户访问 Server UI，并在出现提示时重置密码（他们可以重新输入与之前相同的密码）。 如果用户需要将 Designer 连接到 Server，请将其升级到 Designer 2022.1。 未执行上述步骤的用户将在连接到 Server 时在 Designer 中收到错误“电子邮件地址或密码不正确。请重试。” 如果未执行上述步骤，则需要为每个用户使用重置密码选项才能迁移到更高版本。 |
2022.1 关键 | R 升级：嵌入式 R 从 4.0.5 升级到 4.1.3 任务：重新安装外部 R 库并指引用户在工作流中重新测试 R。如需了解详情，请参阅 如何将兼容 R 版本 4.1.3 的包与 R 工具配合使用。 |
2022.1 | Designer 部署到 VDI：为 Designer 部署新增了虚拟桌面基础架构 (VDI) 支持 影响：可将 Designer 部署到持久性和非持久性 VDI，请参阅 虚拟桌面基础架构支持。 |
2022.1 | 下载工具 SSL 安全性提高：解决了 SSL 漏洞 [JIRA PSEC-8] 影响：解决了有关握手重协商的 SSL 漏洞 (CVE-2009-3555)。但是，这导致一些客户的下载工具停止工作，并显示错误“传输数据时出现错误：SSL 连接错误”。 任务：联系您正在访问的站点，要求他们升级其服务器以支持RFC 5746。如果此方法不可行，请联系客户支持部门，并参考 Jira card PSEC-8 以了解其他解决方法。2022.3 提供对等验证允许列表配置选项。 |
2022.1.42590 补丁 3 | 缺陷 TGAL-6990：Gallery 数据连接包含空白密码时升级失败（已在 21.4.2_Patch6、22.1.1_Patch4 中更正） 影响：存在包含空白密码的 Gallery 数据连接时升级失败，请参阅 社区文章 和 [TGAL-6990] 任务：
|
2022.2-FIPS
版本 | 升级到此版本，或更新版本时要执行的操作。 |
|---|---|
2022.2-FIPS | 这是一个仅适用于 FIPS 的版本，专为在 FIPS 环境中工作的新客户而设计。FIPS 是联邦信息处理标准 (Federal Information Processing Standards) 的缩写。 通用版 Server 和 Designer 产品将跳过季度版本，下一版本将为 2022.3。在等待 2022.3 季度版本的同时，Alteryx 将继续发布以前版本的维护更新。如果从较早版本升级，请跳过此版本，并升级到 2022.3+。 |