使用 BigQuery 经典版网页界面

注意：BigQuery 即将迁移到 Google Cloud Console。在 2020 年 6 月之前，您可以继续使用本文中所述的经典版网页界面。

欢迎试用全新的 BigQuery 网页界面，并向我们发送反馈。 如需详细了解向 Google Cloud Console 迁移的相关信息，请参阅此处。

概览

BigQuery 提供两种图形网页界面，分别是 Cloud Console 中的 BigQuery 网页界面和经典版 BigQuery 网页界面；这两种界面都可用于创建和管理 BigQuery 资源以及运行 SQL 查询。本页介绍经典版网页界面。

如需了解如何在 Cloud Console 中使用网页界面，请参阅 BigQuery 网页界面快速入门。

准备工作

您必须先使用 Cloud Console 创建或选择项目，然后才能使用经典版 BigQuery 网页界面。

1. 登录您的 Google 帐号。

   如果您还没有 Google 帐号，请注册一个新帐号。

2. 在 Google Cloud Console 的项目选择器页面上，选择或创建一个 Google Cloud 项目。

   注意：如果您不打算保留在此过程中创建的资源，请创建新的项目，而不要选择现有的项目。完成本教程介绍的步骤后，您可以删除所创建的项目，并移除与该项目关联的所有资源。

   转到项目选择器页面

3. 新项目中会自动启用 BigQuery。如需在先前存在的项目中激活 BigQuery，请转到 启用 BigQuery API。

   启用 API

4. 如果您不想在项目中使用信用卡或启用结算功能，BigQuery 提供了沙盒机制。无论您的项目是否启用了结算功能，本主题中的步骤都适用。如果您想启用结算功能，请参阅了解如何启用结算功能。

打开经典版网页界面

要打开经典版网页界面，请在浏览器中输入以下网址，并将 project_id 替换为您要在经典版网页界面中打开的项目的 ID：

https://bigquery.cloud.google.com/queries/project_id

点击下面的按钮后，该网页界面即会打开并显示您最近访问的项目。

转到经典版网页界面

经典版网页界面概览

经典版网页界面有三个主要部分：

1. 页面左侧（导航窗格）：

   导航窗格的上半部分列出了您要执行的各项操作：编写查询、查看查询历史记录或查看作业历史记录。

   导航窗格的下半部分会列出当前项目中您可访问的数据集，以及 BigQuery 公共数据集。界面设有一个过滤框，可让您按数据集 ID 或标签进行过滤。

2. 详细信息窗格：

   包含对应于导航窗格中所选操作的信息。例如，如果您在导航窗格中点击某个数据集，则详细信息窗格会显示该数据集的相关信息。

3. 查询窗口：

   当您点击 Compose Query 时，详细信息窗格上方会出现一个 New Query 窗口。如果您不再需要此窗口，可以将其关闭。

显示资源

导航窗格会列出您在当前项目中可以浏览的数据集。点击任意数据集旁边的 图标或点击数据集名称，即可展开该数据集并显示其中包含的表。

点击某个表后，其相关信息会显示在详细信息窗格中。 然后，您可以点击窗格右侧的 Query Table 按钮，在查询框中填入对该表的基本查询。您可以手动修改查询以指定字段，也可以根据需要自定义查询。您并非只能查询当前选定的表。如需详细了解如何查询表，请参阅运行交互式查询。

添加和移除项目

您的所有 BigQuery 工作都是在项目中完成。该项目的名称会显示在导航窗格中的数据集列表上方。您在项目中执行所有工作时产生的费用都将计入与该项目关联的结算帐号。如需详细了解 BigQuery 费用，请参阅价格页面。

在经典版网页界面中，您可以：

• 添加（或固定）其他项目
• 移除固定的项目
• 切换到其他项目

添加项目

在经典版网页界面中，您可以使用项目菜单添加项目或将项目置顶。

如需向经典版界面添加项目，请执行以下操作：

1. 在导航窗格中，点击项目名称旁边的向下箭头 。

2. 在菜单中，依次点击 Switch to project > Display project。

3. 在 Display Project 对话框中，执行以下操作：

   • 输入项目 ID。
   • 将 Display project in navigation panel 保持选中状态。

   • 点击 OK，将该项目添加到导航面板中。

     

从经典版界面中移除项目

如需移除之前添加（或置顶）的项目，请执行以下操作：

1. 在导航窗格中，点击项目名称旁边的向下箭头 。

2. 在菜单中，点击 Remove project from panel。

切换项目

如果您希望切换到另一个项目（而不是在界面中将其置顶），可以使用上下文菜单。

如需切换项目，请执行以下操作：

1. 在导航窗格中，点击项目名称旁边的向下箭头 。

2. 在菜单中，点击 Switch to project，然后从列表中选择项目。这会将界面中先前的项目替换为您所选的项目。

添加共享数据集

其他用户可能与您共享数据集，但未授予您对相应项目的访问权限。如果发生这种情况，您应该会收到一封电子邮件，其中显示包含共享数据集的项目的名称。该项目和数据集不会自动显示在经典版界面中。

如果您点击电子邮件中的 browser tool 链接，系统即会打开网页界面并显示相应的项目。如果您希望将包含此共享数据集的项目固定，请按照添加项目中所述的步骤操作。

查看作业和查询记录

当您使用经典版网页界面运行作业和运行查询时，系统会将您的记录保留在导航窗格中。查询也是一种作业类型，但为了便于使用，系统会单独保留您的查询历史记录。

界面中的作业和查询历史记录包括您在过去 6 个月内提交的所有加载、导出、复制和查询作业（最多 1000 个条目）。所有作业类型累计的作业数量不得超过 1000 个。

查看作业历史记录

要查看您的作业历史记录，可执行以下操作之一：

• 点击导航窗格中的 Job History 链接。

• 在浏览器中输入以下网址：

  https://bigquery.cloud.google.com/jobs/project_id

您可以使用此网页界面重复运行加载作业，但无法重复运行导出或复制作业。

查看查询历史记录

要查看查询历史记录，您可以执行以下操作之一：

• 点击导航窗格中的 Query History 链接。

• 在浏览器中输入以下网址：

  https://bigquery.cloud.google.com/queries/project_id

您可以使用此网页界面重复运行查询作业。

搜索作业和查询历史记录

您可以过滤（或搜索）查询记录或作业记录，使系统仅显示符合条件的特定作业。返回的结果仅限于经典版界面检索的作业池中的作业。默认情况下，您可以通过经典版界面搜索最近的 1000 个作业。

如需列出历史记录中的所有可用作业，请使用 jobs.list API 方法或 bq ls 命令行界面命令。87

如需过滤您的查询或作业历史记录，请执行以下操作：

1. 在导航窗格中，点击 Job History 或 Query History。
2. 点击过滤条件框向下箭头 ，打开过滤条件表达式框。

3. 在过滤条件表达式框中执行以下操作：

   • 点击 Any 以选择过滤条件。
   • 点击运算符列表并选择一个运算符。您所选的条件不同，系统显示的运算符列表也会不一样。例如，如果您选择文本条件，则运算符列表会包含 substring 和 regex。

   • 在框中输入一个值。

     

4. 点击 And，视情况添加其他过滤条件。

5. 点击 Search。

您可以使用以下任何作业属性过滤查询作业：

• Any - 任何属性。
• Job ID (jobid) - 作业的唯一不透明 ID。
• User (user) - 提交作业的用户。
• Start Time (start) - 作业的开始时间（以毫秒为单位，从 Epoch 起算）。当作业从 PENDING 状态转换为 RUNNING 或 DONE 时，系统会显示此属性。
• End Time (end) - 作业的结束时间（以毫秒为单位，从 Epoch 起算）。只要作业处于 DONE 状态，系统就会显示此属性。
• Destination table (dest) - 作业操作（加载、复制或查询）的目标表名称。
• Query text - 提交的 SQL 查询的文本。
• Bytes processed - SQL 查询处理的字节总数。
• UDF code - 包含用户定义函数 (UDF) 的代码的内嵌资源。

您可以使用以下任一作业属性过滤加载、复制和提取作业：

• Any - 任何属性。
• Job ID (jobid) - 作业的唯一不透明 ID。
• User (user) - 提交作业的用户。
• Start Time (start) - 作业的开始时间（以毫秒为单位，从 Epoch 起算）。当作业从 PENDING 状态转换为 RUNNING 或 DONE 时，系统会显示此属性。
• End Time (end) - 作业的结束时间（以毫秒为单位，从 Epoch 起算）。只要作业处于 DONE 状态，系统就会显示此属性。
• Destination table (dest) - 作业操作（加载、复制或查询）的目标表名称。
• Title (title) - 历史记录中显示的标题，例如，加载作业的标题可能是“uploaded file to myproject:mydataset.mytable”。
• Type (type) - 作业类型：加载、查询、复制或提取（导出）。
• Copy source (copysrc) - 复制作业中的源表。
• Destination URI (desturi) - 提取（导出）作业对应的 Cloud Storage 目标 URI。
• Source table (srctable) - 提取作业中的源表。
• Source URI (srcuri) - 加载作业对应的 Cloud Storage 来源 URI。

对查询历史记录排序

在经典版界面中，您还可以使用 Queries 窗格中的 Sort By 选项对查询记录进行排序。点击导航窗格中的 Query History，即可打开 Queries 窗格。

排序选项包括：

• Date - 按运行日期对查询排序。
• Duration - 按总运行时间对查询排序。
• Duration/byte - 按持续时间（按输入字节数进行标准化）对查询排序。这样，您就可以比较输入大小不同的多个查询的运行时间。例如，如果有一组表随时间增大，并且您希望比较查询的效率（忽略仅由输入大小变化而造成的差异），此选项将非常有用。此选项假设输入大小和运行时之间的关系是线性的。
• Input bytes - 按读取的字节数对查询排序。
• Slot-ms - 按查询使用的所有槽中处于活跃状态的毫秒数总和对查询排序。按 slot-ms 排序是一种衡量处理工作量的更稳定方式，因为它受系统延迟和其他不确定因素的影响较小，这些不确定因素会影响观测到的持续时间。

• Slot-ms/byte - 与 Duration/byte 类似，Slot-ms/byte 是 slot-ms 的标准化表示形式。

  

经典版界面显示限制

经典版网页界面具有以下显示限制：

• 导航窗格中只能显示 1000 个数据集。
• 每个项目的导航窗格中最多可显示 3 万个表。

控制经典版界面显示性能

在极少数情况下，如果项目包含大量数据集，而数据集又包含大量表，则经典版网页界面的性能会受到影响。要在项目包含大量资源时提高界面性能，请使用 ?minimal 参数将显示的资源数限制为每个项目 10000 个表。例如，在浏览器中输入以下网址以限制显示的资源数量：

https://bigquery.cloud.google.com/queries/project_id?minimal.

键盘快捷键

经典版网页界面支持以下键盘快捷键：

组合键 (Windows/Linux)	组合键（Mac 操作系统）	操作
Ctrl+Space	Ctrl+Space	如果没有已打开的查询：编写新查询 如果查询编辑器已打开：自动填充当前字词
Ctrl+Enter	Cmd+Enter	运行当前查询
Tab	Tab	自动填充当前字词
Ctrl	Cmd	突出显示表名称
在按住 Ctrl 的同时点击表名称	在按住 Cmd 的同时点击表名称	打开表架构
Ctrl+E	Cmd+E	基于所选内容运行查询
Ctrl+/	Cmd+/	为当前行或选定行添加注释
Ctrl+Shift+F	Cmd+Shift+F	设置查询格式

示例

如需经典版网页界面示例，请参阅 BigQuery 文档中的方法指南部分。下文提供了指向常用网页界面任务（如创建、获取、列出、删除和修改 BigQuery 资源）的链接。

查询数据

如需了解如何使用经典版网页界面创建和运行查询，请参阅以下内容：

• 运行交互式查询
• 写入查询结果
• 保存和共享查询

创建资源

如需了解如何使用经典版网页界面创建资源，请参阅以下内容：

• 创建数据集
• 创建具有架构定义的空表
• 基于查询结果创建表
• 创建提取时间分区表
• 创建视图

获取资源相关信息

如需了解如何使用经典版网页界面获取资源的相关信息，请参阅以下内容：

• 获取数据集相关信息
• 获取表相关信息
• 获取视图相关信息

列出资源

如需了解如何使用经典版网页界面列出资源，请参阅以下内容：

• 列出数据集
• 列出表
• 列出视图

更新资源

如需了解如何使用经典版网页界面更新资源，请参阅以下内容：

• 更新数据集属性
• 更新表属性
• 更新视图属性

加载数据

如需了解如何使用经典版网页界面加载数据，请参阅以下内容：

• 从 Cloud Storage 加载 Avro 数据
• 从 Cloud Storage 加载 JSON 数据
• 从 Cloud Storage 加载 CSV 数据
• 从本地文件加载数据

使用外部数据源

如需了解如何使用经典版网页界面查询外部数据源中的数据，请参阅以下内容：

• 使用 JSON 架构文件创建表定义
• 使用永久外部表查询 Cloud Bigtable 数据
• 使用永久外部表查询 Cloud Storage 数据
• 使用永久外部表查询云端硬盘数据

导出数据

如需了解如何使用经典版网页界面导出数据，请参阅以下内容：

• 导出存储在 BigQuery 中的数据

使用 BigQuery Data Transfer Service

如需了解如何搭配使用经典版网页界面与 BigQuery Data Transfer Service，请参阅以下内容：

• 设置 Campaign Manager 转移作业
• 设置 Cloud Storage 转移作业（Beta 版）
• 设置 Google Ad Manager 转移作业
• 设置 Google Ads 转移作业
• 设置 Google Play 转移作业（Beta 版）
• 设置 Search Ads 360 转移作业（Beta 版）
• 设置 YouTube 频道转移作业
• 设置 YouTube 内容所有者转移作业
• 获取有关转移作业配置的信息
• 列出转移作业配置
• 查看运行记录
• 查看转移作业运行详情和日志消息
• 更新转移作业配置

迁移至 Google Cloud Console

Google Cloud Console 中的 BigQuery 网页界面已于 2019 年 4 月推出正式版 (GA)。Cloud Console 提供与 Google Cloud 的其余部分相同的功能，并可加快新功能的推出速度。此外，Cloud Console 具有易于使用的界面元素，例如用来对查询记录进行排序和过滤的控件以及用于共享数据集的控件。

Google Cloud Console 中的 BigQuery 网页界面现已推出正式版，因此我们不会再针对 BigQuery 经典版网页界面提供功能更新和支持，而是只会发布重要的安全修复程序。

以下是经典版 BigQuery 网页界面的迁移时间表：

• 2019 年 12 月：

  如果您尝试访问经典版网页界面，系统会将您重定向至 Cloud Console。 被重定向的用户可以选择停用未来的重定向。

• 2020 年 6 月：

  自 2020 年 6 月起，您只能使用 Google Cloud Console 中的 BigQuery 网页界面。

Google Cloud Console 中已经支持经典版网页界面的大多数功能。下面是经典版网页界面与 Cloud Console 之间主要差别的摘要：

经典版网页界面	Google Cloud Console
默认的查询语法为旧版 SQL。如需启用标准 SQL，您必须使用标准 SQL 查询前缀。	默认情况下，查询会以标准 SQL 运行，但是您可以使用查询设置菜单选项切换回旧版 SQL。用户定义的函数必须采用标准 SQL 编写。
支持将 Cloud Bigtable 用作外部数据源。	在经典版网页界面停用前至少三个月，您就可以在 Cloud Console 中查询 Cloud Bigtable 表了。
支持刷新项目中资源的列表。	在经典版网页界面停用前至少三个月，您就可以刷新项目中的资源列表了。