全局 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 脚本框架并禁用旧脚本时,可能需要修改非幂等脚本。