此页面由 Cloud Translation API 翻译。

预览 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 会显示当前期间预览的所有查询的结果 查询结果面板中查看该浏览器会话。在查询结果面板中，您可以查看每个查询的以下信息预览：

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

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

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

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

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

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

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

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

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

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

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

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