本文档介绍了如何在 在对 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">
- 查询结果
- 查询输出的 JSON 表示法
此外,在“查询结果”面板中,您可以导航到 然后进入 BigQuery Studio 查看预览 作业。
准备工作
所需的角色
如需获取预览查询所需的权限 请让管理员向您授予 项目的以下 IAM 角色:
-
Dataform Editor (
roles/dataform.editor
) - 工作区 -
BigQuery 作业用户 (
roles/bigquery.jobUser
) - 项目
如需详细了解如何授予角色,请参阅管理访问权限。
预览查询
要在执行之前检查 Dataform 中的查询结果,请运行 查询。如果当前修改的文件包含多个查询, 选择要预览的查询。您一次可以预览一个查询。
对于包含断言的表,运行预览略有不同。有关 相关信息,请参阅预览包含断言的表。
预览 SQL 查询并以 Dataform 查看查询结果 请按照以下步骤操作:
- 在 Files 窗格中,展开
definitions/
。 - 选择 SQLX 或 JavaScript 文件。
- 点击运行。
- 如果文件包含多个查询,请在下拉菜单中选择 要预览的查询
- 在查询结果面板中检查预览结果。
- 如需检查作业详情,请选择作业信息标签页。
- 如需检查查询结果,请选择结果标签页。
- 如需查看查询的 JSON 输出,请选择 JSON 标签页。
- 如需在 SQL 工作区中查看预览作业,请点击 更多菜单 >在 SQL 工作区中查看作业。
预览包含断言的表
在包含断言的 SQLX 表定义文件中,您可以预览表 和已定义的断言查询
Dataform 会将表定义查询视为默认查询。接收者 预览表创建查询,请点击工作区中的运行。要预览 您需要从 Run 按钮。您一次可以预览一个查询。
要在表格定义文件中预览包含断言的 Dataform 工作区中,请按以下步骤操作:
- 在 Files 窗格中,展开
definitions/
。 - 选择包含断言的表的定义文件。
- 运行预览:
<ph type="x-smartling-placeholder">
- </ph>
- 如需预览表创建查询,请点击运行。
- 要预览断言查询,请点击 运行,然后选择要预览的查询。
- 在查询结果面板中检查预览结果。
- 如需检查作业详情,请选择作业信息标签页。
- 如需检查查询结果,请选择结果标签页。
- 如需查看查询的 JSON 输出,请选择 JSON 标签页。
- 如需在 SQL 工作区中查看预览作业,请点击 更多菜单 >在 SQL 工作区中查看作业。
后续步骤
- 如需详细了解 BigQuery 价格,请参阅 BigQuery 价格。
- 如需详细了解 Dataform 价格,请参阅 定价。
- 如需详细了解 Dataform 中的工作区,请参阅简介 在工作区中进行开发。
- 如需了解如何使用断言测试表查询,请参阅使用 断言。