预览 SQL 查询

本文档介绍了如何在 在对 BigQuery 执行查询之前的 Dataform 工作区。

Dataform 中的查询预览简介

当您使用 Dataform core、Dataform 会将查询实时编译为 SQL。测试已编译的 SQL 的输出 对 BigQuery 执行查询之前,可以运行 Dataform 工作区中的查询。

当您运行查询预览时,Dataform 会在 BigQuery 在临时目标位置执行编译的查询 并在工作区中显示查询结果。您可以使用 执行将表发布到 BigQuery。包含预览查询的临时表会自动 最多 24 小时内删除。如需详细了解 BigQuery 作业 请参阅 BigQuery 作业简介

在 Dataform 中运行查询预览会在 BigQuery 中产生费用。 如需详细了解 BigQuery 价格,请参阅 BigQuery 价格

在查询预览期间,Dataform 会使用您的用户凭据来运行作业 数据。然而,在执行工作流的过程中,Dataform 会使用 创建或更新资产所需的服务账号凭据 BigQuery。

Dataform 会显示当前期间预览的所有查询的结果 查询结果面板中查看该浏览器会话。在查询 结果面板中,您可以查看每个查询的以下信息 预览:

  • 作业信息 <ph type="x-smartling-placeholder">
      </ph>
    • BigQuery 作业 ID
    • 运行预览的用户
    • 运行作业的位置,从您的 工作流设置文件
    • BigQuery 作业的创建、开始时间和结束时间
    • BigQuery 作业的时长
    • 处理的字节数
    • BigQuery 中的结算字节数
    • 作业优先级
    • 使用旧版 SQL 在查询中
    • 查询的临时目标表
  • 查询结果
  • 查询输出的 JSON 表示法

此外,在“查询结果”面板中,您可以导航到 然后进入 BigQuery Studio 查看预览 作业。

准备工作

  1. 在 Google Cloud 控制台中,前往 Dataform 页面。

    转到 Dataform 页面

  2. 选择或创建代码库

  3. 选择或创建开发工作区

  4. 创建一个 SQL 查询,例如定义一个 表格

所需的角色

如需获取预览查询所需的权限 请让管理员向您授予 项目的以下 IAM 角色:

  • Dataform Editor (roles/dataform.editor) - 工作区
  • BigQuery 作业用户 (roles/bigquery.jobUser) - 项目

如需详细了解如何授予角色,请参阅管理访问权限

您也可以通过自定义角色或其他预定义角色来获取所需的权限。

预览查询

要在执行之前检查 Dataform 中的查询结果,请运行 查询。如果当前修改的文件包含多个查询, 选择要预览的查询。您一次可以预览一个查询。

对于包含断言的表,运行预览略有不同。有关 相关信息,请参阅预览包含断言的表

预览 SQL 查询并以 Dataform 查看查询结果 请按照以下步骤操作:

  1. Files 窗格中,展开 definitions/
  2. 选择 SQLX 或 JavaScript 文件。
  3. 点击运行
    1. 如果文件包含多个查询,请在下拉菜单中选择 要预览的查询
  4. 查询结果面板中检查预览结果。
    1. 如需检查作业详情,请选择作业信息标签页。
    2. 如需检查查询结果,请选择结果标签页。
    3. 如需查看查询的 JSON 输出,请选择 JSON 标签页。
    4. 如需在 SQL 工作区中查看预览作业,请点击 更多菜单 >在 SQL 工作区中查看作业

预览包含断言的表

在包含断言的 SQLX 表定义文件中,您可以预览表 和已定义的断言查询

Dataform 会将表定义查询视为默认查询。接收者 预览表创建查询,请点击工作区中的运行。要预览 您需要从 Run 按钮。您一次可以预览一个查询。

要在表格定义文件中预览包含断言的 Dataform 工作区中,请按以下步骤操作:

  1. Files 窗格中,展开 definitions/
  2. 选择包含断言的表的定义文件。
  3. 运行预览: <ph type="x-smartling-placeholder">
      </ph>
    • 如需预览表创建查询,请点击运行
    • 要预览断言查询,请点击 运行,然后选择要预览的查询。
  4. 查询结果面板中检查预览结果。
    1. 如需检查作业详情,请选择作业信息标签页。
    2. 如需检查查询结果,请选择结果标签页。
    3. 如需查看查询的 JSON 输出,请选择 JSON 标签页。
    4. 如需在 SQL 工作区中查看预览作业,请点击 更多菜单 >在 SQL 工作区中查看作业

后续步骤