创建和使用工作区
本文档介绍了如何在 BigQuery 中使用工作区，包括以下任务：
- 创建工作区
- 删除工作区
- 在工作区中处理文件
- 对工作区中的文件执行版本控制
准备工作
如果您尚未创建 BigQuery 代码库，请先创建一个。
所需的角色
对工作区的访问权限取决于其父级代码库中授予的角色。如需了解详情，请参阅必需的角色。
创建工作区
工作区创建方式因您使用的是 BigQuery 代码库还是第三方代码库而异。
在 BigQuery 代码库中创建工作区
如需在 BigQuery 代码库中创建新工作区，请按以下步骤操作：
在 Google Cloud 控制台中，转到 BigQuery 页面。
在探索器窗格中，展开代码库文件夹。
选择要创建工作区的代码库。
在编辑器中，点击添加工作区。
在创建工作区窗格的工作区 ID 字段中，输入工作区的唯一 ID。
ID 只能包含数字、字母、连字符和下划线。
点击创建。
在第三方代码库中创建工作区
如需在第三方代码库中创建新工作区，请按以下步骤操作：
在 Google Cloud 控制台中，转到 BigQuery 页面。
在探索器窗格中，展开代码库文件夹。
选择要创建工作区的代码库。
在编辑器中，点击添加工作区。此时会打开创建工作区窗格。
根据您是要为工作区使用现有分支还是新分支，选择 Existing remote branch（现有远程分支）或 New branch（新分支）单选按钮。
指定要使用的分支：
- 如果您选择了现有远程分支单选按钮，请在远程分支字段中选择一个现有分支。
如果您选择了新分支单选按钮，请在 Workspace ID 字段中输入分支名称。在第三方代码库中创建的分支名称与 BigQuery 工作区 ID 相同。
ID 只能包含数字、字母、连字符和下划线。
点击创建。
在工作区中创建目录
如需在工作区中创建目录，请按以下步骤操作：
在 Google Cloud 控制台中，转到 BigQuery 页面。
在探索器窗格中，展开代码库文件夹。
选择包含要使用的工作区的代码库。
在编辑器中，找到相应工作区，然后点击打开。
此时，系统会打开工作区窗格：
点击 Add 选项。
依次点击在代码库中创建 > 目录。
在添加目录路径字段中，输入目录路径。
点击创建目录。
在工作区中处理文件
您可以在工作区中创建新文件，也可以上传现有文件。
您可以创建或将以下类型的文件上传到代码库：
创建文件
如需在工作区中创建文件，请按以下步骤操作：
在 Google Cloud 控制台中，转到 BigQuery 页面。
在探索器窗格中，展开代码库文件夹。
选择包含要使用的工作区的代码库。
在编辑器中，找到相应工作区，然后点击打开。
此时，系统会打开“工作区”窗格：
执行下列其中一项操作：
- 点击 Add 选项。
- 选择一个现有目录，然后点击 操作选项。
点击在代码库中创建，然后点击要创建的文件类型。
在 Name 字段中，输入文件名。
可选：在父目录字段中，输入要用于创建文件的目录路径。
点击保存。
上传文件
如需将文件上传到工作区，请按以下步骤操作：
在 Google Cloud 控制台中，转到 BigQuery 页面。
在探索器窗格中，展开代码库文件夹。
选择包含要使用的工作区的代码库。
在编辑器中，找到相应工作区，然后点击打开。
此时，系统会打开“工作区”窗格：
执行下列其中一项操作：
- 点击 Add 选项。
- 选择一个现有目录，然后点击 操作选项。
点击上传到代码库，然后点击要上传的文件类型。
在“上传”窗格中，执行以下操作之一：
- 在文件上传字段中，点击浏览，选择一个文件，然后点击打开。
- 在网址字段中，输入文件的网址。
可选：在父目录字段中，输入要用于创建文件的目录路径。
点击上传。
删除文件
如需从工作区中删除文件，请按以下步骤操作：
在 Google Cloud 控制台中，转到 BigQuery 页面。
在探索器窗格中，展开代码库文件夹。
选择包含要使用的工作区的代码库。
在编辑器中，找到相应工作区，然后点击打开。
此时，系统会打开“工作区”窗格：
选择要删除的文件，点击 操作选项，然后点击删除。
点击删除。
对文件使用版本控制
本部分介绍了如何在 BigQuery 中使用版本控制功能来跟踪工作区中的文件。
BigQuery 使用 Git 跟踪对代码库中文件所做的每项更改。在 BigQuery 代码库中，您可以直接与 Git 代码库进行交互。在关联的代码库中，您可以与在关联代码库时配置的远程代码库的默认分支进行交互。
BigQuery 会根据工作区中更改的状态显示版本控制选项。例如，只有当您的工作区中有未提交的本地更改时，BigQuery 才会显示提交选项。如果您的工作区中的文件是默认分支或默认分支的完全副本，BigQuery 会显示最新状态。
BigQuery 会显示以下版本控制选项：
- 提交 X 更改
- 提交工作区或所选更改文件中的 X 项本地更改。BigQuery 会显示未提交的更改。
- 推送到默认分支
- 将提交的更改推送到默认分支。如果您的工作区中没有未提交的更改，但有未推送的提交，则代码库中会显示此选项。
- 推送至“
your-branch-name” - 将已提交的更改推送到
your-branch-name。 如果您的工作区中没有未提交的更改，则已连接到第三方 Git 代码库的代码库中会提供此选项。第三方代码库中的远程分支名称与 BigQuery 工作区 ID 相同。 - 从默认分支拉取
- 使用默认分支中的近期更改更新您的工作区。 如果您的工作区中没有未提交的更改，则代码库中会显示此选项。
- 从“
your-branch-name”拉取 - 根据
your-branch-name中的近期更改更新您的工作区。 如果您的工作区中没有未提交的更改，则已连接到第三方 Git 代码库的代码库中会提供此选项。第三方代码库中的远程分支名称与 BigQuery 工作区 ID 相同。 - 还原为上次提交的内容
- 将工作区中的文件恢复为上次提交时的状态。
拉取更改
如果您的工作区与代码库不同步，BigQuery 会显示 Pull 选项。
如需将更改从代码库拉取到工作区，请按以下步骤操作：
在 Google Cloud 控制台中，转到 BigQuery 页面。
在探索器窗格中，展开代码库文件夹。
选择包含要使用的工作区的代码库。
在编辑器中，找到相应工作区，然后点击打开。
此时，系统会打开工作区窗格：
在“工作区”窗格中，执行以下操作：
- 如果您位于 BigQuery 代码库中，请点击从默认分支拉取。
如果您位于已连接到第三方 Git 代码库的代码库中，请执行以下任一操作：
- 点击从默认分支拉取，从第三方代码库的默认分支拉取代码。
- 点击从
your-branch-name拉取，从与当前工作区对应的第三方代码库的分支中拉取代码。
提交更改
在工作区中进行更改后，BigQuery 会显示提交选项。您可以提交所有本地更改或所选文件。您添加或修改的文件在工作区窗格中会带有一个蓝点。
如需将工作区中的更改提交到代码库，请按以下步骤操作：
在 Google Cloud 控制台中，转到 BigQuery 页面。
在探索器窗格中，展开代码库文件夹。
选择包含要使用的工作区的代码库。
在编辑器中，找到相应工作区，然后点击打开。
此时，系统会打开工作区窗格：
在“工作区”窗格中，点击提交 X 更改。
在提交更改窗格中，执行以下操作：
选择您要提交的已更改文件。
如果您未选择任何文件，BigQuery 会提交所有本地更改。您可以按文件状态、文件名和路径过滤已更改的文件。
在添加提交消息字段中，输入提交的说明。
点击提交所有更改或提交 X 更改。
按钮名称取决于您选择要提交的文件。
推送更改
您提交更改后，BigQuery 会显示推送选项。
如需将工作区中的更改推送到代码库，请按以下步骤操作：
在 Google Cloud 控制台中，转到 BigQuery 页面。
在探索器窗格中，展开代码库文件夹。
选择包含要使用的工作区的代码库。
在编辑器中，找到相应工作区，然后点击打开。
此时，系统会打开工作区窗格：
在“工作区”窗格中，执行以下操作：
- 如果您位于 BigQuery 代码库中，请点击推送到默认分支。
如果您位于已连接到第三方 Git 代码库的代码库中，请执行以下任一操作：
- 点击推送到默认分支，以推送到第三方代码库的默认分支。
- 点击 Push to
your-branch-name以推送到与当前工作区对应的第三方代码库的分支。
还原未提交的更改
如需还原未提交的更改，请按以下步骤操作：
在 Google Cloud 控制台中，转到 BigQuery 页面。
在探索器窗格中，展开代码库文件夹。
选择包含要使用的工作区的代码库。
在编辑器中，找到相应工作区，然后点击打开。
此时，系统会打开工作区窗格：
在“工作区”窗格中，点击版本控制按钮上的 下拉箭头，然后点击还原到上次提交。
解决合并冲突
如果工作区中的本地更改与对代码库的默认分支所做的更改不兼容，就可能会发生合并冲突。当多个用户同时修改同一文件时，通常会发生合并冲突。
当其他用户向同一分支推送了有冲突的更改后，您在从该分支拉取时通常会遇到合并冲突。您需要手动解决合并冲突，方法是修改受影响的文件。
以下代码示例显示了 SQL 文件中显示的合并冲突：
<<<<<<< HEAD
SELECT 1 as CustomerOrders
=======
SELECT 1 as Orders
>>>>>>> refs/heads/main
如需解决合并冲突，请按以下步骤操作：
在 Google Cloud 控制台中，转到 BigQuery 页面。
在探索器窗格中，展开代码库文件夹。
选择包含要使用的工作区的代码库。
在编辑器中，找到相应工作区，然后点击打开。
此时，系统会打开工作区窗格：
选择受影响的文件，然后使用您选择的更改对其进行修改。
提交更改。
可选：推送更改。
查看提交历史记录
如需查看提交历史记录，请按以下步骤操作：
在 Google Cloud 控制台中，转到 BigQuery 页面。
在探索器窗格中，展开代码库文件夹。
选择包含要使用的工作区的代码库。
在编辑器中，找到相应工作区，然后点击打开。
此时，系统会打开工作区窗格：
在“工作区”窗格中，点击版本控制按钮上的 下拉箭头，然后点击查看提交记录。
删除工作区
如需删除工作区及其所有内容，请按以下步骤操作：
在 Google Cloud 控制台中，转到 BigQuery 页面。
在探索器窗格中，点击 Repositories 文件夹。
在 Git Repositories 窗格中，选择要删除的工作区。
点击 操作选项，然后点击删除。
点击删除。
后续步骤
- 了解如何创建代码库。