使用表探索器创建查询

如需请求支持或对此功能提供反馈，请发送电子邮件至 bigquery-explorer-feedback@google.com。

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

表探索器简介

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

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

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

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

限制

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

价格

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

如果您运行表探索器生成的查询，也可能会产生计算费用。

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

准备工作

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

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  2. Verify that billing is enabled for your Google Cloud project.

  3. Enable the BigQuery API.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the API

所需的角色和权限

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

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

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

所需权限

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

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

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

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

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

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

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

    进入 BigQuery Studio

  2. 在左侧窗格中，点击 探索器：

    突出显示的“探索器”窗格按钮。

  3. 在 Explorer 窗格中，展开您的项目，然后点击数据集 。

  4. 点击概览 > 表，然后选择要为其创建查询的表。

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

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

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

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

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

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

  8. 点击保存。

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

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

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

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

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

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

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

问题排查

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

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

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

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

后续步骤