跳转至

BigQuery 设置

概要

Google BigQuery 是 Google 的数据仓库服务，可使用 SQL 快速查询和分析大量数据。申请 BigQuery 访问权限并完成 Google Cloud 项目设置后，即可在 BigQuery 中直接查询存储在 Analytics 中的数据。

可按以下顺序使用 BigQuery。

  1. 创建 Google 账号
  2. 申请 BigQuery 访问权限
  3. 使用 BigQuery

获得权限后可查询的表，请参考 BigQuery 表。

创建 Google 账号

访问 BigQuery 需要 Google 账号。可在 Google 网站上创建 Google 账号。

申请 BigQuery 访问权限

拥有 Analytics 管理员 权限的用户可以注册用于访问 BigQuery 的 Google 账号并申请权限。

Note

仅授予申请权限时所在的 Analytics 控制台环境的数据集访问权限。如果要查询多个环境的数据，请在各环境中分别申请权限。

环境 可查询的数据集
正式环境 analytics_N_live
沙盒 analytics_N_sandbox

  1. 点击控制台右上角的账号图标，选择 BigQuery 访问权限管理。

    bigquery_01.png

  2. 在 BigQuery 访问权限管理 页面的 申请权限 区域中，在 Google 账号 中输入 Google 账号地址，然后点击 申请 按钮。

  3. 在下方 申请记录 中确认处理状态。处理最多需要 2 个工作日。

    • 可在 BigQuery 列中确认申请状态。

    bigquery_02.png

状态 说明
待处理 申请后等待处理
已批准 已授予权限
已拒绝 权限已被拒绝
已申请撤销 已申请撤销，正在处理中
已撤销 权限已被撤销
Note

如果不是 Gmail 账号或公司使用的 Google 账号，申请可能会被拒绝。

Tip

点击 Analytics 控制台顶部的 ⓘ 图标并选择 前往 Google BigQuery 控制台，即可直接进入 BigQuery 控制台。

使用 BigQuery

首次访问前确认事项

访问 BigQuery 至少需要一个 Google Cloud 项目。

如果是首次使用 BigQuery，请参考 使用 BigQuery 沙盒 指南，创建 Google Cloud 项目并在沙盒环境中访问 BigQuery。在沙盒环境中，可以在免费使用限额内查询数据。如需超出限额使用，需要从沙盒升级。

访问 BigQuery

准备好 Google Cloud 项目并获得 BigQuery 访问权限后，进入 BigQuery 控制台，完成以下设置即可使用 SQL 查询数据。

为项目加星标

为存储 Analytics 数据的 habq-storage 项目加星标，以便轻松访问数据集。

  1. 点击 BigQuery 控制台左侧探索器面板中的 + 添加数据 按钮。

    bigquery_03.png

  2. 点击左下角的 按名称为项目加星标。

  3. 在 为项目加星标 弹窗的项目名称中输入 habq-storage，然后点击 加星标 按钮。

    bigquery_04.png

  4. 点击左侧探索器中新增的 habq-storage 项目旁的箭头，确认可访问的数据集和表。

    bigquery_05.png

    数据集和表的结构请参考 BigQuery 表。

执行 SQL

执行 SQL 需要在执行查询的 Google Cloud 项目中拥有 BigQuery Job User 角色。在沙盒环境中创建的项目无需额外设置权限，即可在免费使用限额内查询数据。

  1. 在 BigQuery 控制台左上角 Google Cloud 旁的项目选择器中，确认已选择要执行 SQL 的 Google Cloud 项目。如果未选择，请点击项目选择器，选择拥有 BigQuery Job User 角色的项目。

    bigquery_06.png

  2. 点击 + 按钮打开 SQL 编辑器并编写查询。

  3. 点击查询上方的 运行 按钮查询数据。

    bigquery_07.png

在 FROM 子句中，以 habq-storage.数据集.表名 格式指定表。

-- 查询登录事件
SELECT userId, deviceId, appIdGroup, appId,
    DATETIME(TIMESTAMP_ADD(dateTime, INTERVAL 32400 SECOND)) AS dateTime_kst  -- 将以 UTC 存储的 dateTime 转换为 KST
FROM `habq-storage.analytics_N_live.t_raw_event_log`
WHERE identifierProvider = 'hive'  -- 用户标识符发放体系（始终为 hive）
  AND eventName = 'app_login'
  AND appIdGroup = 'com.sample.test'  -- 实际使用的 appIdGroup
  -- 按 KST 查询时
  AND dateTime >= TIMESTAMP_SUB(TIMESTAMP('2026-09-30 00:00:00'), INTERVAL 32400 SECOND)
  AND dateTime <  TIMESTAMP_SUB(TIMESTAMP('2026-10-07 00:00:00'), INTERVAL 32400 SECOND)
  -- 基于 checksum 去除重复时
  QUALIFY ROW_NUMBER() OVER (PARTITION BY checksum ORDER BY bigqueryRegistTimestamp DESC) = 1
LIMIT 100

撤销 BigQuery 访问权限

可以为已申请权限的 Google 账号申请撤销权限。

  1. 点击控制台右上角的账号图标，选择 BigQuery 访问权限管理。
  2. 在 申请记录 中，点击要撤销账号的 操作 列中的 申请撤销 按钮。

处理最多需要 2 个工作日，撤销完成后状态会变更为 已撤销。

注意事项 & Tips

  • 只有拥有 Analytics 管理员 权限的用户才能申请和撤销 BigQuery 访问权限。
  • 对于因离职、职务变更等原因不再需要 BigQuery 访问权限的账号，请撤销其权限。
  • 沙盒项目有免费使用限额。如果需要查询大量数据，请考虑升级 BigQuery。
  • t_raw_event_log 基于 dateTime 按日分区。为降低查询费用，请同时指定日期条件。

关联菜单