使用 BigQuery Studio Git 代码库管理代码
您可以使用 BigQuery Studio Git 代码库管理 SQL 脚本和笔记本。此功能将版本控制直接集成到 BigQuery Studio 文件浏览器中,让您无需离开 Google Cloud 控制台即可克隆代码库、 管理分支和执行 Git 操作。
与经典 代码库相比,BigQuery Studio Git 代码库提供了更精简的基于文件夹的 体验。 BigQuery Studio Git 代码库直接显示在左侧窗格中的用户根文件夹下。
通过使用 BigQuery Studio Git 代码库,您可以像处理标准文件和目录一样与代码资产互动,同时保持与远程 Git 代码库的连接。
限制
- BigQuery Studio Git 代码库仅限于用户根文件夹上下文,供私人使用。请勿与其他用户共享这些代码库。虽然这些代码库显示在用户根文件夹中(这是项目中资产的虚拟表示),但它们实际上是在项目级层创建的。
- 不支持将 Developer Connect 账号连接器与 Git 代理搭配使用。
- 装载位置 内的文件系统操作会消耗 Dataform 配额。
- 包含大量文件、文件大小较大、分支较多或提交历史记录较深且复杂的代码库需要更长时间才能克隆。克隆操作可能会超出操作超时时间,从而导致代码库无法成功创建。如需缩短具有较深 提交历史记录的代码库的克隆时间,您可以创建浅克隆。 您可以根据需要在稍后提取更多提交。
- 存储在 BigQuery Studio Git 代码库装载中的笔记本文件的大小不能超过 30 MB。如果您的文件大于 30 MB,请将其保存到装载位置之外的 Colab 运行时的本地存储空间。
当您在装载之外对 Git 代码库进行更改(例如,通过在左侧窗格中修改或重命名文件)时,这些更改最多可能需要 60 秒才能在笔记本运行时的装载中显示。 您可以通过将
CACHE_TTL_SECONDS参数传递给构造函数来调整此时长:FuseWidget(CACHE_TTL_SECONDS=NUMBER)将
NUMBER替换为缓存保持有效状态的秒数。减小此值会增加同步频率 ,并更快地消耗 Dataform 配额。
准备工作
在您的 Google Cloud 项目中启用 Developer Connect API。
所需角色
如需获得使用 BigQuery Studio Git 代码库管理代码所需的权限,请让管理员在项目上授予您Developer Connect OAuth User (roles/developerconnect.oauthUser) IAM 角色。如需详细了解如何授予角色,请参阅管理对项目、文件夹和组织的访问权限。
此预定义角色包含 使用 BigQuery Studio Git 代码库管理代码所需的权限。如需查看所需的确切权限,请展开