创建开发工作区

本文档可帮助您执行以下操作:

开发工作区概览

在 Dataform 中,您可以在开发工作区中与工作流代码进行交互,开发工作区是您自己的代码库可修改副本。在工作区中,您可以创建、修改或删除代码库的内容,而不会影响在同一代码库中工作的其他人,然后提交更改并将其推送到代码库。

您可以使用 Dataform 核心JavaScript开发工作流。Dataform 会实时将您的代码编译为 SQL 查询。

在开发工作区中,您可以执行以下任务:

开发工作区的组件

Dataform 开发工作区由以下部分中介绍的标签页组成。

“代码”标签页

您可以使用代码 标签页中的开发环境来浏览文件、开发查询、对更改进行版本控制,以及触发对 BigQuery 的执行。该标签页包含以下组件,可让您开发工作流:

  • 文件 窗格:显示工作区的文件结构,并自动将您对文件结构所做的修改保存到文件结构中。所选文件会在开发窗格的标签页中打开。在输入以搜索 字段中,您可以按路径搜索工作区中的文件或目录。
  • 版本控制 窗格:显示工作区的版本控制状态和版本控制选项。
  • 开发 窗格:在标签页中显示打开的文件。自动将您对已修改文件所做的更改保存到文件中。
  • 运行 按钮:运行已编译的 SQL 查询的 预览
  • 格式 按钮:设置 Dataform 核心或 JavaScript 代码的格式。
  • 编译 状态:显示工作区中代码的编译状态。
  • 元数据 窗格:显示已修改文件的元数据。
  • 已编译的查询 窗格:将已修改文件中的查询编译为 SQL。如果查询编译失败,该窗格会显示编译错误。如果查询编译成功,该窗格会显示已编译的查询,并通过针对 BigQuery 的试运行来验证这些查询。如果查询验证失败,该窗格会显示验证错误。如果查询验证成功,该窗格会显示将查询执行到 BigQuery 所需的字节数。
  • 开始执行 菜单:显示用于触发工作区中整个工作流或其所选元素的执行的选项。

“已编译的图表”标签页

已编译的图表 标签页中,您可以将工作区中定义的已编译工作流视为交互式有向无环图 (DAG)。该图显示了工作流中的所有操作以及它们之间的关系。如果工作流中存在编译错误,该标签页会显示错误消息,而不是图。

您可以在图表中放大和缩小,并使用拖放导航。

您可以按以下属性过滤图表:

  • 名称
  • 标记
  • 类型
    • 断言
    • 声明
    • 增量表
    • 物化视图
    • 运维
    • 未知
    • 查看

您可以一次选择多个过滤器。Dataform 会使用 OR 条件应用这些过滤器。

您可以点击图表中的操作,以在以下窗格中查看其详细信息:

  • 元数据 窗格:显示所选操作的完整名称、类型、依赖项和被依赖项。
  • 查询 窗格:显示所选操作的已编译 SQL 查询。

“执行”标签页

此标签页显示在工作区中触发的所有执行的日志。您还可以查看所选执行的操作及其详细信息。如需了解详情,请参阅 监控执行日志

工作区中的版本控制

在工作区中,您可以通过基于 Git 的版本控制与代码库进行交互。您对工作区中的文件所做的修改最初是未提交的本地更改,您可以提交这些更改,然后将其推送到代码库,以便所有代码库用户都可以使用这些更改。

如果您的代码库已连接到远程 Git 提供商,您可以将工作区中的更改推送到主开发分支。在将代码库连接到远程 Git 提供商时,您可以选择主分支。在未连接的 Dataform 代码库中,您可以将更改推送到默认分支。