管理笔记本
本文档介绍了如何管理 BigQuery 中的 Colab Enterprise 笔记本。笔记本是由 Dataform 提供支持的 BigQuery Studio 代码资源。
如需使用笔记本，您必须先启用 BigQuery Studio 以进行资产管理。
所需权限
如需共享笔记本，您需要以下 Identity and Access Management (IAM) 角色：
- Bigquery Job User (
roles/bigquery.jobUser) - Bigquery Read Session User (
roles/bigquery.readSessionUser) - 资源级层的 Code Owner (
roles/dataform.codeOwner)。
如需保存和删除笔记本，您需要以下 IAM 角色：
- Bigquery Job User (
roles/bigquery.jobUser) - Bigquery Read Session User (
roles/bigquery.readSessionUser) - Code Owner (
roles/dataform.codeOwner) 或 Code Editor (roles/dataform.codeEditor)
如需使用笔记本修订版本，您需要以下 IAM 角色：
- Bigquery Job User (
roles/bigquery.jobUser) - Bigquery Read Session User (
roles/bigquery.readSessionUser) 以下任何角色：
如需详细了解 BigQuery IAM，请参阅使用 IAM 进行访问权限控制。
授予对笔记本的访问权限
若要向其他用户授予对笔记本的访问权限，请将这些用户添加到相应的 IAM 角色。
在 Google Cloud 控制台中，转到 BigQuery 页面。
在探索器窗格中，展开您的项目和笔记本文件夹，然后根据需要展开共享笔记本文件夹。找到您要授予其访问权限的笔记本。
点击笔记本旁边的 查看操作，然后点击共享 > 管理权限。
在管理权限窗格中，点击添加用户/群组。
在新的主账号字段中，输入主账号。
在角色列表中，选择以下角色之一：
- Code Owner：可以对笔记本执行任何操作，包括删除或共享笔记本。
- Code Editor：可以修改笔记本。
- Code Viewer：可以查看笔记本。
可选：如需查看角色和高级共享设置的完整列表，请点击高级共享。
点击保存。
如需返回笔记本信息页面，请点击关闭。
共享笔记本
如需与其他用户共享笔记本，您可以生成并共享该笔记本的链接。如需让其他用户查看您共享的笔记本，您必须先授予对笔记本的访问权限。
如需运行笔记本，用户必须有权访问笔记本所访问的数据。如需了解详情，请参阅授予对数据集的访问权限。
在 Google Cloud 控制台中，转到 BigQuery 页面。
在探索器窗格中，展开您的项目和笔记本文件夹，然后根据需要展开共享笔记本文件夹。找到您要共享的笔记本。
点击笔记本旁边的 查看操作，然后点击共享 > 复制链接。
与其他用户共享该链接。
查看所有笔记本
如需查看项目中所有笔记本的列表，请执行以下操作：
在 Google Cloud 控制台中，转到 BigQuery 页面。
在探索器窗格中，点击笔记本旁边的 查看操作，然后执行以下操作之一：
- 如需在当前标签页中打开该列表，请点击全部显示。
- 如需在新标签页中打开该列表，请点击在以下位置全部显示 > 新标签页。
- 如需在拆分标签页中打开该列表，请点击在以下位置全部显示 > 拆分标签页。
查看笔记本元数据
如需查看笔记本元数据，请按照以下步骤操作：
在 Google Cloud 控制台中，转到 BigQuery 页面。
在探索器窗格中，展开您的项目和笔记本文件夹，然后根据需要展开共享笔记本文件夹。点击您要查看其元数据的笔记本的名称。
查看摘要窗格，以查看有关笔记本的信息（例如笔记本使用的区域）及其上次修改日期。
使用笔记本版本
使用以下部分了解如何查看、比较和恢复笔记本的版本。
查看笔记本版本
如需查看笔记本版本，请按照以下步骤操作：
在 Google Cloud 控制台中，转到 BigQuery 页面。
在探索器窗格中，展开您的项目和笔记本文件夹，然后根据需要展开共享笔记本文件夹。点击要查看其活动的笔记本的名称。
点击活动标签页，可查看按日期降序排列的笔记本版本列表。
比较笔记本版本
如需比较笔记本版本，请按照以下步骤操作：
在 Google Cloud 控制台中，转到 BigQuery 页面。
在探索器窗格中，展开您的项目和笔记本文件夹，然后根据需要展开共享笔记本文件夹。点击您要比较其版本信息的笔记本的名称。
在活动标签页中，点击笔记本版本旁边的 查看操作，然后点击比较。
在修订历史记录窗格中，使用版本下拉列表来选择要比较的版本。
可选：如需比较笔记本源代码，请选中原始源代码复选框。
可选：如需以内嵌方式（而不是在单独的窗格中）比较版本，请选中内嵌差异复选框。
可选：如需在笔记本中隐藏命令输出，请清除显示输出复选框。
恢复笔记本版本
使用以下任一选项来恢复笔记本版本。通过从修订历史记录窗格进行恢复，您可以在选择恢复先前版本之前比较笔记本的当前版本和先前版本。恢复笔记本会创建新版本的笔记本，而不是覆盖当前版本。不会丢失版本历史记录。
“活动”窗格
在 Google Cloud 控制台中，转到 BigQuery 页面。
在探索器窗格中，展开您的项目和笔记本文件夹，然后根据需要展开共享笔记本文件夹。点击您要恢复其先前版本的笔记本的名称。
选择活动窗格。
点击要恢复的笔记本版本旁边的 查看操作，然后点击恢复。
点击确认。
修订历史记录
在 Google Cloud 控制台中，转到 BigQuery 页面。
在探索器窗格中，展开您的项目和笔记本文件夹，然后根据需要展开共享笔记本文件夹。点击您要恢复其先前版本的笔记本的名称。
选择活动窗格。
点击笔记本版本旁边的 查看操作，然后点击比较。
在修订历史记录窗格中，点击版本下拉列表旁边的 查看操作，然后点击恢复修订版本。
点击确认。
下载笔记本
如需下载笔记本，请按照以下步骤操作：
在 Google Cloud 控制台中，转到 BigQuery 页面。
在探索器窗格中，展开您的项目和笔记本文件夹，然后根据需要展开共享笔记本文件夹。点击您要下载的笔记本的名称。
点击下载。
删除笔记本
如需删除笔记本，请按照以下步骤操作：
在 Google Cloud 控制台中，转到 BigQuery 页面。
在探索器窗格中，展开您的项目和笔记本文件夹，然后根据需要展开共享笔记本文件夹。找到您要删除的笔记本。
点击笔记本旁边的 查看操作，然后点击删除。
如需确认删除，请在对话框中输入
delete。点击删除。
问题排查
如需了解详情，请参阅排查 Colab Enterprise 问题。
后续步骤
- 详细了解 BigQuery 中的 Colab Enterprise 笔记本。
- 了解如何创建笔记本。