使用表探索器创建查询

预览

此功能须遵守服务专用条款的“通用服务条款”部分中的“非正式版产品条款”。 非正式版功能“按原样”提供，可能只能获得有限的支持。 如需了解详情，请参阅发布阶段说明。

如需针对此功能请求支持或提供反馈，请发送电子邮件至 [e-mail]。

本文档介绍了如何使用表探索器检查表数据和创建数据探索查询。

表探索器简介

表探索器提供了一种自动化方式，让您可以直观地探索表数据，并根据您选择的表字段创建查询。

在表格浏览器中，您可以选择要检查的表格字段。您一次最多可以选择 10 个表格字段。

表探索器会将所选字段显示为交互式卡片，其中包含每个字段最多 10 个最常见值的列表，按 count 列排序。您可以通过选择要更仔细检查的字段和不同值与卡片进行交互。表探索器会根据您的选择来创建数据探索查询。

您可以将此查询复制到查询编辑器中的新查询中，也可以在表探索器中应用此查询。应用查询时，表探索器会运行该查询，并使用查询结果刷新显示的卡片。如需继续探索表格数据，请从刷新的卡片中选择更多字段或值。

限制

• 表探索器适用于 BigQuery 表、BigLake 表、外部表和视图。
• 表探索器可让您一次探索一个表。此功能不支持同时探索多个表或生成跨表操作，例如 JOIN 操作。
• 表探索器会创建 SQL 查询，以直接反映您选择的表字段和不同值。您可以执行表格浏览器创建的查询，也可以在查询编辑器中手动修改这些查询。表探索器不提供依托 AI 技术的辅助功能来生成、补全或解释 SQL 查询。
• 如需探索表数据并针对具有列级访问权限控制 (ACL) 或受限用户权限的表生成查询，您必须拥有对所有所选字段的读取权限。如需运行生成的查询，您必须拥有足够的权限。

价格

表探索器会根据您选择的表字段和不同值运行查询，以显示表探索结果。这些查询会产生计算价格费用。在您确认选择的表字段并触发查询执行之前，表探索器会显示为每个查询处理的数据量。

如果您运行表格浏览器生成的查询，还可能会产生计算费用。

如需详细了解 BigQuery 计算价格，请参阅价格。

准备工作

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

4. Enable the BigQuery API.

   Enable the API

5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

6. Make sure that billing is enabled for your Google Cloud project.

7. Enable the BigQuery API.

   Enable the API

所需的角色和权限

如需获得使用表探索器查看表数据和生成查询所需的权限，请让您的管理员为您授予以下 IAM 角色：

• 针对项目的 BigQuery Job User (roles/bigquery.jobUser)。
• 针对要探索的所有表和视图的 BigQuery Data Viewer (roles/bigquery.dataViewer)。

如需详细了解如何授予角色，请参阅管理对项目、文件夹和组织的访问权限。

这些预定义角色可提供使用表探索器查看表数据和生成查询所需的权限。如需查看所需的确切权限，请展开所需权限部分：

所需权限

使用表探索器查看表数据和生成查询需要以下权限：

• 针对在其中运行查询的项目的 bigquery.jobs.create 权限（无论数据存储位置如何）。
• 针对您要探索的所有表和视图的 bigquery.tables.getData 权限。

您也可以使用自定义角色或其他预定义角色来获取这些权限。

如需详细了解 BigQuery Identity and Access Management (IAM)，请参阅使用 IAM 进行访问权限控制。

探索表中的数据以创建查询

如需探索表数据并根据您选择的表字段和值创建查询，请按照以下步骤操作：

1. 在 Google Cloud 控制台中，前往 BigQuery Studio。

   进入 BigQuery Studio

2. 在探索器窗格中，选择您要为其创建查询的表。

3. 点击表探索器标签页，然后点击选择字段。

4. 在选择字段窗格中，最多选择 10 个要探索的表字段。

5. 对于分区表，请在分区过滤条件部分中设置自定义分区过滤条件。在探索表时，分区过滤条件可以减少可结算的计算工作量。

   1. 选择应用自定义分区过滤条件。

   2. 在显示的设置字段中，配置分区过滤条件。

   过滤条件设置的显示取决于表的分区类型：小时、天、月、年或范围。

6. 点击保存。

   点击保存后，BigQuery 会运行查询以显示所选字段的常见值，从而产生费用。您可以在选择字段窗格的顶部查看要处理的数据量。

   表探索器会将所选字段显示为卡片，其中包含按 Count 列排序的最多 10 个最常见值的列表。在生成的查询部分，您可以看到一个查询，您可以运行该查询来显示相同的数据。

7. 可选：如需修改结果，您可以尝试执行以下操作：

   1. 在显示的所选字段卡片中，选择不同的值以进一步过滤数据。
   2. 如需还原所有更改，请点击重置。
   3. 在生成的查询部分中，点击复制到查询，将生成的代码复制到查询编辑器中新的未命名查询。在新创建的查询标签页中，您可以修改、运行和管理查询。

8. 如需运行生成的查询，请点击应用。

   BigQuery 会执行生成的查询，并使用查询结果刷新显示的卡片。

9. 如需继续探索表，请从刷新的显示卡片中选择新字段或不同值。

问题排查

Access Denied: Project [project_id]: User does not have bigquery.jobs.create
permission in project [project_id].

如果主账号缺少在项目中创建查询作业的权限，则会发生此错误。

解决方法：管理员必须为您授予要查询的项目的 bigquery.jobs.create 权限。除了访问查询的数据所需的任何权限之外，还需要拥有此权限。

如需详细了解 BigQuery 权限，请参阅使用 IAM 进行访问权限控制。

后续步骤

• 了解如何使用数据分析探索数据。
• 了解如何在 BigQuery 中借助 Gemini 编写查询。