注意:以下翻译的准确性尚未经过验证。这是使用 AIP ↗ 从原始英文文本进行的机器翻译。
在代码库界面的顶部,你可以选择五个不同的选项卡:
在代码选项卡中,你可以点击 按钮,启动逐步指南,引导你了解代码库中可用的核心功能。应用内帮助目前仅在代码视图中可用。
通过命令面板使用键盘快捷键,在Windows上使用F1键或在macOS上使用Fn+F1:
使用下拉分支菜单选择一个现有的沙盒分支进行工作。或者,点击 图标创建一个新的沙盒分支,该分支包含现有分支代码的副本。要在你的库中编辑代码,你必须在沙盒分支中工作——受保护的分支无法直接编辑。
在你的库中编写和编辑代码时,你可以执行以下操作:
点击 图标,创建新文件、文件夹或子项目。如果你想向代码库中添加另一个特定语言的子项目,请选择“新子项目”选项。
Foundry Explorer 辅助
Foundry Explorer 辅助是一个文件导航界面,让你快速浏览所有文件和文件夹。一旦选择了特定的数据集,可以点击“打开”查看完整数据集。
问题辅助
问题辅助会告诉你代码中检测到的任何问题。点击这里列出的特定问题可以打开有问题的代码。
调试器辅助
调试器允许你在变换运行时检查其行为(参见调试变换)。
预览辅助
预览辅助允许你在输入数据集的有限样本上运行代码,以快速预览代码而不提交更改(参见预览变换)。
测试辅助
当你的库包含单元测试时(参见Python测试和Java测试),测试辅助可以让你运行这些测试并显示其结果。
文件更改辅助
文件更改辅助可以用于查看当前文件的任何未提交更改,以及比较文件的以前版本。
构建辅助
构建辅助可以让你触发数据集构建并查看构建的进度。一旦选择了数据集源文件,可以点击构建按钮来构建输出数据集的新版本,并在代码上运行自动检查。然后可以在构建辅助中查看正在运行任务的进度。
点击代码库界面右上角的构建按钮相当于从构建辅助中触发构建。
文档辅助
文档辅助包含可以用来编写代码的可用语言的参考资料。有关不在产品文档中提供的更详细的特定语言文档,请参见支持的语言。
SQL草稿
SQL辅助允许你快速测试SQL查询。编写SQL查询并点击 预览查询结果。你也可以通过选择适当的
.sql
文件并点击 测试你在库中编写的现有查询。
要查看标记为收藏的查询,请转到 选项卡。要查看SQL辅助中运行的查询历史,请转到
选项卡。
要在SQL草稿中访问输入数据集的特定分支,请在查询中添加分支名称:例如 SELECT * FROM `branch_A`.`/path/to/dataset`
。如果未指定分支,将默认为master
。
状态栏提供有关环境状态和检查结果的信息。你可以在状态栏中找到以下信息:
本节总结了如何在分支选项卡中创建新分支和创建新的拉取请求。这些功能也可以在代码选项卡中使用。
在分支选项卡中,你可以看到代码库中存在的分支列表——这包括你自己的分支以及其他用户的分支。点击 按钮,创建一个新的沙盒分支,该分支包含特定分支代码的副本。
每个列出的分支都包含一个摘要,其中包括以下可用功能:
分支选项卡还允许你访问标签列表,标签类似于不可变的分支。标签可用于通过赋予版本号或名称标记代码的一个重要版本,以供将来参考。要创建新标签,请导航到分支选项卡的标签部分并点击“新建标签”按钮。标签可以从当前分支版本或任何任意提交中创建。
为了确保所有标签名称遵循特定的命名约定,你可以在库根目录下的repoSettings.json
文件中添加一个tagNameValidation
配置块,例如:"tagNameValidation": { "regex": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(-rc\\d+)?$", "errorMessage": "标签名称必须具有格式x.x.x或x.x.x-rcx。" }
有关推荐的git开发工作流程的更多信息,请参见开发者最佳实践。
本节总结了如何在拉取请求选项卡中创建新的拉取请求。此功能也可以在代码选项卡中使用。
在拉取请求选项卡中,你可以找到代码库中拉取请求的信息。拉取请求允许用户在合并更改之前查看分支更改的历史记录并逐行审查你的代码。每当你想将分支上的更改合并到主代码中时,你应该创建一个新的拉取请求。
点击 按钮,创建一个新的拉取请求。默认情况下,创建的新拉取请求将你的更改合并到库的主分支中(通常是master分支)。选择你想基于哪个分支创建新的拉取请求。
通过点击拉取请求列表顶部的“打开”/“关闭”按钮,可以在打开和关闭的拉取请求列表之间切换,并使用搜索栏根据标题或作者进一步筛选列表。
点击其中一个拉取请求,逐行审查提议的代码更改并添加评论。根据库设置,每个拉取请求可能需要至少一个批准的审查才能合并。
在审查变换代码的更改时,你还可以检查这些更改对你的数据集的影响。
在检查选项卡中,你可以查看每个分支正在运行和已完成检查的摘要。使用下拉分支菜单选择不同的分支。点击特定检查以查看更详细的信息。
检查选项卡还将包括为你的库定义的任何单元测试的输出。你可以为Python和Java定义单元测试。
如果你的堆栈上启用了AIP,错误增强微件将补充失败检查的详细视图,帮助你更好地理解和解决出现的问题。
在设置选项卡中,代码作者可以配置个人编辑器偏好,库管理员可以控制库的行为和策略。要了解有关设置选项卡的更多信息,请参阅管理代码库。
设置选项卡中的大多数选项是针对管理员的,并且只对具有适当权限的用户可用(默认情况下,库所有者)。