重要
本文档已过时,将来可能不会更新。 本内容中提及的产品、服务或技术不再受支持。 请参阅什么是 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 脚本,请执行以下操作:
从保留的 DBFS 位置 (
/databricks/init
) 复制现有的旧版全局 init 脚本,并使用 UI 或 REST API 将它们添加到新版全局 init 脚本框架中。 请参阅全局 init 脚本。使它们保持禁用状态,直到完成下一步。
禁用所有旧版全局 init 脚本。
在管理员设置中,转到“全局 init 脚本”选项卡,然后关闭“旧版全局 init 脚本”开关。
备注
如果你无权访问 UI,请从
/databricks/init
位置删除所有文件,以停止执行旧版 init 脚本。启用新版全局 init 脚本。
在“全局 init 脚本”选项卡上,为要启用的每个 init 脚本打开“启用”开关 。
重启所有群集。
重要
禁用旧版全局 init 脚本后,旧版脚本将立即停止运行。 这会产生两个重要的影响:
- 运行群集自动缩放时,旧脚本和新全局 init 脚本不会在添加的节点上运行。 若要确保新脚本在所有群集上运行,并在现有群集上的新节点上运行,必须重启所有群集。
- 迁移到新版全局 init 脚本框架并禁用旧脚本时,可能需要修改非幂等脚本。