管理清洁室

重要

此功能目前以公共预览版提供。

本文介绍如何管理清洁室,包括如何:

  • 更新清洁室所有者和注释
  • 添加、删除和编辑数据资产和笔记本
  • 允许访问清洁室
  • 监视清洁室活动
  • 删除清洁室

这些任务可由清洁室中的所有协作者执行。

开始之前

管理清洁室需要以下权限,具体取决于任务:

  • 若要在清洁室列表中查看清洁室或查看清洁室详细信息,你必须是清洁室的所有者、元存储管理员,或者对清洁室拥有下列权限之一:MODIFY CLEAN ROOMEXECUTE CLEAN ROOM TASKBROWSE
  • 要更新清洁室的所有者,你必须是清洁室的所有者或元存储管理员。
  • 要在清洁室中添加和删除数据资产和笔记本并更新注释,你必须是清洁室的所有者,或者对清洁室具有 MODIFY CLEAN ROOM 权限。
  • 要允许访问清洁室,你必须是所有者或元存储管理员。
  • 要删除清洁室,你必须是所有者。

注意

创建者在其 Databricks 帐户中会自动分配为清洁室的所有者。 协作者组织的元存储管理员会自动分配为其 Databricks 帐户中清洁室的所有者。 你可以转让所有权。 请参阅管理 Unity Catalog 对象所有权

更新清洁室

  1. 在 Azure Databricks 工作区中,单击 “目录”图标“目录”。

  2. 在“快速访问”页上,单击“数据清洁房间 >”按钮。

    或者,单击“目录”窗格顶部的 齿轮图标 齿轮图标,并选择“数据清洁房间”。

  3. 从列表中选择清洁室。

  4. 进行以下任何更新:

    • 编辑注释:单击注释旁边的 “编辑”图标 编辑图标。 注释更改仅适用于 Unity Catalog 元存储中的清洁室安全对象。 这些更改不会传播给其他协作者。

    • 转移所有者:单击“所有者”名称旁边的 “编辑”图标 编辑图标。

    • 添加表和卷:请参阅步骤 3.将数据资产和笔记本添加到清洁室

    • 删除表和卷:单击资产行上的 Kebab 菜单 Kebab 菜单(也称为三点菜单),然后选择“删除数据资产”。

    • 添加笔记本:请参阅步骤 3.将数据资产和笔记本添加到清洁室

    • 更新笔记本:单击笔记本行上的 Kebab 菜单 Kebab 菜单,然后选择“更新笔记本”。 在对话框中,浏览并选择更新后的笔记本。

      在“清洁室”界面中选择笔记本之前,直接在笔记本中进行任何更新。

    • 删除笔记本:单击笔记本行上的 Kebab 菜单 Kebab 菜单,然后选择“删除笔记本”。

允许访问清洁室

清洁室所有者对清洁室拥有所有权限。 只有清洁室所有者和元存储所有者角色可以向其他主体授予访问清洁室的权限。 创建者在其 Databricks 帐户中会自动分配为清洁室的所有者。 协作者组织的元存储管理员会自动分配为其 Databricks 帐户中清洁室的所有者。 你可以转让所有权。 请参阅管理 Unity Catalog 对象所有权

所有者可授予对清洁室的以下权限:

  • BROWSE,支持列出清洁室,并查看注释、所有者、资产和运行历史记录等详细信息。
  • MODIFY CLEAN ROOM,支持执行 BROWSE 授予的所有操作,并允许添加和删除数据资产、添加和删除笔记本以及更新注释。
  • EXECUTE CLEAN ROOM TASK,支持执行 BROWSE 授予的所有操作,并允许在清洁室中运行笔记本。

若要向主体授予对清洁室的权限,请执行以下操作:

  1. 在 Azure Databricks 工作区中,单击 “目录”图标“目录”。

  2. 在“目录”窗格顶部,单击 齿轮图标 齿轮图标,然后选择“清洁室”。

    或者,在“快速访问”页中,单击“清洁室 >”按钮。

  3. 从列表中选择清洁室。

  4. 转到“权限”选项卡。

  5. 选择用户、组或服务主体,单击“授予”,然后选择要授予的权限。

有关授予权限的详细信息,请参阅管理 Unity Catalog 中的特权

监视清理室笔记本运行

所有协作者的所有笔记本运行都记录在清洁室 UI 中的“运行”选项卡上。 可以按状态和运行任务的协作者筛选运行。

  1. 在 Azure Databricks 工作区中,单击 “目录”图标“目录”。

  2. 在“快速访问”页上,单击“数据清洁房间 >”按钮。

    或者,单击“目录”窗格顶部的 齿轮图标 齿轮图标,并选择“数据清洁房间”。

  3. 从列表中选择清洁室。

  4. 转到“运行”选项卡。

还可以在清洁室 UI 中选择笔记本,并转到笔记本详细信息页上的“运行”选项卡来查看特定笔记本的运行。

监视清洁室日志

clean_room_events 系统表记录了 Azure Databricks 元存储中的所有与清洁室相关的事件,并使你能够查看你和其他协作者对清洁室执行的所有操作。

若要了解如何使用此系统表深入了解清洁室活动,请查看清洁室事件系统表参考

删除清洁室

删除清洁室后,协作者无法使用该清洁室,但它会显示在其清洁室列表中,直到他们删除自己的清洁室对象。 删除清洁室时,会立即取消正在运行的任务。

  1. 在 Azure Databricks 工作区中,单击 “目录”图标“目录”。

  2. 在“快速访问”页上,单击“数据清洁房间 >”按钮。

    或者,单击“目录”窗格顶部的 齿轮图标 齿轮图标,并选择“数据清洁房间”。

  3. 从列表中选择清洁室。

  4. 单击页面右上角的 Kebab 菜单 Kebab 菜单

  5. 选择“删除”。

  6. 确认要删除清洁室,然后单击“删除”。

排查清洁室问题

使用清洁室时,可能会遇到以下错误消息或问题。

其他协作者已经退出清洁室,因此清洁室不再可用。 请删除此清洁室安全对象。

在无信任清洁室中,任何协作者都可以删除中央清洁室。 此错误消息表示其他协作者删除了中央清洁室,并且对中央清洁室的引用不再有效。 你只能删除你的 Azure Databricks 工作区中的清洁室对象。 你不能使用它。

协作者 X 已经有一个名为 Y 的清洁室

没有协作者可以更改清洁室名称。 这可确保所有协作者都可以引用没有歧义的清洁室名称。 此错误意味着其他协作者已具有与你选择的清洁室同名的清洁室。 请选择其他清洁室名称。

请在使用清洁室之前接受无服务器服务条款

中央清洁室需要无服务器计算。 无需在自己的工作区中启用无服务器计算,即可使用清洁室。 但是,你确实需要接受无服务器计算服务条款。 请参阅启用无服务器计算。 如需帮助,请联系 Databricks 代表。

受邀协作者看不到清洁室

最初在受邀协作者的元存储中创建清洁室时,只有元存储管理员可以查看此清洁室。 为 Unity Catalog 启用的某些工作区未分配有元存储管理员。 必须分配元存储管理员角色才能开始使用清洁室。 请参阅分配元存储管理员