全局 init 脚本（旧版）

  • 项目

重要

本文档已过时，将来可能不会更新。 本内容中提及的产品、服务或技术不再受支持。 请参阅什么是 init 脚本？。

警告

旧版全局 init 脚本和群集命名的 init 脚本已终止服务，不能再使用了。

旧版全局 init 脚本在每个群集上运行。 它们不如新版全局 init 脚本框架安全，会以无提示方式忽略故障，并且无法引用环境变量。

Databricks 建议将所有现有的旧版全局 init 脚本迁移到新版全局 init 脚本框架。 旧版全局 init 脚本在 UI 中不可见，但可在 dbfs:/databricks/init/ 中找到。 必须将其删除或移出该文件夹才能完成迁移。

从旧版迁移到新版全局 init 脚本

如果你的 Azure Databricks 工作区是在 2020 年 8 月之前启动的，则你可能仍然使用的是旧版全局 init 脚本。 旧的全局 init 脚本已弃用，在新工作区中不再可用。 不应使用它们。

备注

2023 年 9 月 1 日，Azure Databricks 将对所有工作区禁用旧的全局 init 脚本。 Azure Databricks 建议尽快将旧的全局 init 脚本迁移到当前的全局 init 脚本框架。

自动迁移笔记本

Databricks 工程部门创建了一个笔记本，以便自动执行旧版全局 init 脚本中的迁移过程。 有关笔记本下载的说明和链接，请参阅旧版全局 init 脚本迁移笔记本。

手动迁移说明

若要从旧的全局 init 脚本迁移到新的全局 init 脚本，请执行以下操作：

  1. 从保留的 DBFS 位置 (/databricks/init) 复制现有的旧版全局 init 脚本，并使用 UI 或 REST API 将它们添加到新版全局 init 脚本框架中。 请参阅使用全局 init 脚本。

    使它们保持禁用状态，直到完成下一步。

  2. 禁用所有旧版全局 init 脚本。

    在管理员设置中，转到“全局 init 脚本”选项卡，然后关闭“旧版全局 init 脚本”开关。

    禁用旧版全局 init 脚本

    备注

    如果你无权访问 UI，请从 /databricks/init 位置删除所有文件，以停止执行旧版 init 脚本。

  3. 启用新版全局 init 脚本。

    在“全局 init 脚本”选项卡上，为要启用的每个 init 脚本打开“启用”开关 。

  4. 重启所有群集。

重要

禁用旧版全局 init 脚本后，旧版脚本将立即停止运行。 这会产生两个重要的影响：

  • 运行群集自动缩放时，旧脚本和新全局 init 脚本不会在添加的节点上运行。 若要确保新脚本在所有群集上运行，并在现有群集上的新节点上运行，必须重启所有群集。
  • 迁移到新版全局 init 脚本框架并禁用旧脚本时，可能需要修改非幂等脚本。