Platform changes（平台变更）

Platform changes occur when a platform component, such as a backend service or a frontend application, is upgraded or has its configuration changed. Upgrade Assistant tracks platform changes and provides a list of resources that are affected or may be affected by upcoming changes.

Example platform changes include:

• Modifications of endpoints, such as a change in semantics, URL, payload format, or a full deprecation;
• Modifications of libraries, such as a change in semantics, function names or arguments, or a full deprecation;
• Important bug fixes, such as platform security fixes or Spark fixes that could change the result of a job.

These platform changes may require extra attention because:

• The change is not backward-compatible (as is sometimes the case with modifications of endpoints or libraries).
• Changes that are not backward-compatible may cause platform or workflow issues if appropriate steps are not taken before the change goes into effect.
• The change may affect workflow, pipeline, or analysis results (as may occur with a Spark correctness fix).
• Users should review the impact of a change that may affect the results of their work.

Due date

Each platform change announced in Upgrade Assistant has a due date, which is the scheduled date that the change will go into effect. As the due date gets closer, Upgrade Assistant will send reminders to users who are assigned resources.

:::callout{theme="neutral"} Due to deployment constraints and scheduling, a change may be applied after its due date. However, the due date should still be considered the definitive time by which preparations for a change should be completed. :::

---

中文翻译

平台变更

平台变更是指平台组件（如后端服务或前端应用程序）升级或配置发生变化的情况。升级助手会追踪平台变更，并提供受即将发生的变更影响或可能影响的资源列表。

平台变更的示例包括：

• 端点修改，例如语义、URL、负载格式的变化，或完全弃用；
• 库的修改，例如语义、函数名称或参数的变化，或完全弃用；
• 重要错误修复，例如平台安全修复或可能改变作业结果的 Spark 修复。

这些平台变更可能需要额外关注，原因如下：

• 该变更不向后兼容（端点或库的修改有时会出现这种情况）。
• 如果在变更生效前未采取适当措施，不向后兼容的变更可能导致平台或工作流问题。
• 该变更可能影响工作流、管道或分析结果（Spark 正确性修复可能发生这种情况）。
• 用户应审查可能影响其工作结果的变更所带来的影响。

截止日期

升级助手宣布的每个平台变更都有一个截止日期，即该变更计划生效的日期。随着截止日期的临近，升级助手将向已分配资源的用户发送提醒。

:::callout{theme="neutral"} 由于部署限制和调度安排，变更可能会在截止日期之后才应用。然而，截止日期仍应被视为完成变更准备工作的最终时间节点。 :::