Skip to main content

版本到版本 Server 升级指南:支持的版本

重要

请参阅 Server 升级检查列表,以帮助规划和执行成功的 Server 升级,包括 升级前检查 工作流,以确定导致升级失败的问题。

本文档可提供什么帮助?

本文档重点介绍了在 Alteryx Server 的不同版本之间进行升级时需要注意的任务和变化。问题是逐渐累积的,因此在升级多个版本时,请仔细阅读每个部分。本文档不能取代发行说明(请参见各部分中的链接)。

发布时间表

  • 每半年发布一次的版本会增加一些功能,但也可能更改 Server 管理,要求您或您的用户改变行为。

  • 每个季度内发布的维护版本/补丁会解决初始版本中发现的问题。例如,2022.3 的第一个维护版本将会是 2022.3.2。

图例

停站

需要在升级到更高版本前先升级到该版本的重大变更。

MongoDB 升级

Mongo 数据库版本已升级。

Alteryx Server 升级只能包括当前版本和目标升级版本之间的一个 MongoDB 版本升级。

关键

关键问题:管理员在转移到该版本或更新版本时必须解决或注意的问题。

此列表中条目的标准

此列表浓缩了每个版本的发行说明,以突出以下内容:

  • 管理员或用户必须执行的操作。

  • 对选择升级版本非常重要的项目(即,已更改的行为或缺陷)。

  • Server 管理中做出的重大变更。

快速链接

2022.3 及更早版本

对于不支持的版本(2022.3 及更早版本),请参阅 版本到版本 Server 升级指南:不支持的版本

2024.1

新增功能 / 发行说明

版本

升级到此版本,或更新版本时要执行的操作。

2024.1

管理功能:通过 UI 和 API 转让资产所有权的功能

管理员可以通过 Server UI 或使用 Server API V3 端点在用户之间转让工作流和计划所有权。

影响

  • 增加了新的 API 端点。请参阅 工作流端点用户端点

    • PUT /v3/workflows/{workflowId}/transfer

    • PUT /v3/users/{userId}/assetTransfer

  • 新通知。请参阅 通知

注意

  • 新所有者看不到工作流作业历史记录。

  • 工作流将移至新所有者的工作室,这将影响其在源工作室或目标工作室中对其他用户的可见性。

  • 要成功运行工作流,需要与新所有者共享其他元素:

    • DCM 连接

    • 共享 Gallery 数据库连接

    • 共享 Gallery 凭证

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。请选择其他版本。内部错误 - 检测到死锁。”

任务

  • 所有连接器工具必须更换为新版本。

  • 用户应在工作流中重新测试 Python。引擎仍然使用 Python 版本 3,因此对脚本的影响应该很小。

2024.1

关键

MongoDB 日期时间字段更改(Server 数据库中的服务时间戳已转换为 UTC 格式)

影响:我们将所有日期时间字段转换为 UTC 格式,以改进对时区和夏令时变化的处理。如需了解详情,请参阅 Server 2024.1 发行说明

  • 所有带有时间戳元素的 Server API 都会受到影响。

  • 如果您从旧版本升级到 2024.1,当 AlteryxService 启动时,现有资产的时间戳将依照新的 UTC 标准进行转换。

任务:查看在访问 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 筛选

GET v3/workflows/{workflowID}/jobs 端点现在可以选择按 status 和 resultCode 进行筛选,返回与这些筛选条件相匹配的作业 ID 列表。如需了解详情,请参阅 Server 2024.2 发行说明工作流端点

  • 所有带有时间戳元素的 Server API 都会受到影响。

  • 如果您从旧版本升级到 2024.1,当 AlteryxService 启动时,现有资产的时间戳将依照新的 UTC 标准进行转换。

任务:查看在访问 MongoDB 或 API 的应用程序中如何处理日期时间字段。它们可能需要进行调整,以使日期时间符合 UTC 格式。

订阅(工作室)的新 API 端点

管理员现在可以使用 Server V3 API 端点管理订阅(工作室)。这些端点有助于批量编辑订阅,并提供将单个用户移回单个工作室的功能。

如需详细了解这些端点,请参阅 订阅端点

工作流端点的 API 更新

  • SourceAppId 现在会在以下 API 调用的响应主体中返回:

    • GET/v3/workflows

    • GET/v3/workflow/{workflowID}

    • GET /admin/v1/workflows/migratable

  • 创建者现在可以调用以下对象:GET v3/workflows/{workflowId}

  • status resultCode 筛选已添加到 GET v3/workflows/{workflowID}/jobs 中:

如需了解详情,请参阅 Server 2024.2 发行说明工作流端点

用于允许更新单项计划设置的新 API 端点

使用新 API 端点 PATCH /v3/schedules/{scheduleId} 更新计划,而无需填写多个必填字段以进行单一更改。如需了解详情,请参阅 计划端点

作业端点的更新

  • 新 API 端点GET /v3/jobs/{jobId}/messages

    此端点仅供管理员使用。将 jobId 用作输入参数,以检索该作业的相应消息。

  • 已更新的 API 端点GET /v3/jobs/{jobId}

    GET /v3/jobs/{jobId} 端点已更新,因此用户可以查看通过集合共享给他们的作业。

如需了解详情,请参阅 作业端点

2025.1

新增功能 / 发行说明

版本

升级到此版本,或更新版本时要执行的操作。

2025.1

面向非管理员用户的新凭证页面

非管理员用户现在可以在 Server UI 中访问凭证页面。此页面允许用户查看、创建、编辑和删除自定义凭证。如需了解详情,请参阅凭证:Server 用户界面

2025.1

新增了面向管理员的工作流结果视图

管理员现在可以在“工作流结果”视图中查看工作流结果和作业消息。如需了解详情,请访问工作流结果:管理员界面

2025.1

为 Alteryx 系统设置增加了审计日志

通过 Alteryx 系统设置应用程序对 RuntimeSettings.xml 所做的更新现在会记录在 C:\ProgramData\Alteryx 路径下。

2025.1

Server API

用于取消特定作业的新端点

新增了 DELETE /v3/jobs/{jobId} 端点,用于取消任何正在运行或排队的作业(手动或计划)。

如需了解详情,请参阅作业端点

共享 Server 凭证的新端点

为 Server 凭证(非 DCM)增加了以下端点:

  • 创建 Server 凭证:POST /v3/credentials

  • 更新现有 Server 凭证的密码:PUT /v3/credentials/{credentialId}

这些端点仅供管理员使用,且需要启用 TLS。如需了解详情,请前往凭证端点帮助页面。

为计划端点增加了 Cron 表达式

通过使用 Cron 条目增加了动态计划灵活性。您现在可以在以下 API 中使用 Cron 表达式:

  • POST /v3/schedules

  • PUT /v3/schedules/{scheduleId}

  • PATCH /v3/schedules/{scheduleId}

  • GET /v3/schedules/{scheduleId}

如需了解详情,请访问计划端点帮助页面。

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)。

任务

  • 在 Alteryx One 平台中设置连接。如需了解详情,请参阅数据世系连接

  • 在 Alteryx 系统设置中设置连接。如需了解详情,请参阅控制器

2025.2

Designer 与 Server 更新分离

您可以独立于 Server 升级 Designer,因此用户可以立即访问最新的 Designer 功能,而无需等待 Server 批准或环境升级。使用较新版本 Designer 构建的资产不再被阻止发布到较旧的 Server 环境。

有关重要详情与持续更新,请转至 Designer Server 版本兼容性

由于此更改,已向工作流 API 端点添加了一个新参数。如需了解详情,请参阅为工作流端点新增的参数

2025.2

已更新的 Server 主机恢复流程

在 2 个恢复选项之间进行选择:

  • 手动方式:自行完成所有步骤。

  • 脚本化方式:使用新的恢复脚本自动完成 RuntimeSettings 和 MongoDB 的准备、安装及恢复工作,然后手动完成剩余步骤。

许可证门户下载脚本。如需详细了解新恢复流程,请参阅 Server 主机恢复指南

2025.2

从 Server UI 计划分析应用程序

您现在可以直接从 Server UI 中计划分析应用程序。要计划分析应用程序,只需在 Server UI 中选择该应用程序,点击计划,设置您的偏好参数,填写所有必需的输入字段,然后保存计划即可。如需了解详情,请参阅计划工作流

2025.2

Server API

用于监控作业的新 API 端点

添加了 Get /v3/Jobs/ 端点以监控 Server 上的所有作业。

如需了解详情,请参阅作业端点

新增 API 端点以支持 SDK 连接器

已将 PUT /v3/dcm/connections/{id}/sharing/collaboration 端点添加到 DCM 端点。

此端点仅管理员可使用。如需了解详情,请前往 DCM 端点帮助页面。

为工作流端点新增的参数

为了支持 Designer 和 Server 分离更新,以下工作流端点添加了一个新参数 - bypassWorkflowVersionCheck

  • POST /v3/workflows

  • POST /v3/workflows/{workflowId}/versions

这样可绕过当 Server 版本低于工作流版本时通常阻止上传的保护机制。如需详细了解使用情况,请参阅工作流端点

2025.2

用户凭证共享功能已完成

现在您可以使用重复凭证,即使这些凭证没有通过 Alteryx Server 平台共享。此更新还可解决可用性和可视问题,以实现更顺畅的凭证管理体验。

有关凭证的详细信息,请访问凭证:服务器用户界面凭证:管理员界面