跳轉至

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 控制台左側探索器面板中的 + Add data（新增資料）按鈕。

    bigquery_03.png

  2. 點擊左下方的 Star a project by name（依名稱為專案加上星號）。

  3. 在 Star a project 彈出視窗的 Project name 中輸入 habq-storage，並點擊 Star 按鈕。

    bigquery_04.png

  4. 點擊左側探索器中新增的 habq-storage 專案旁的箭頭，確認可存取的資料集與表格。

    bigquery_05.png

    資料集與表格的結構請參閱 BigQuery 表格。

執行 SQL

若要執行 SQL，執行查詢的 Google Cloud 專案中必須具有 BigQuery 工作使用者（BigQuery Job User）角色。在沙箱環境中建立的專案，無需額外設定權限即可在免費使用量範圍內查詢資料。

  1. 在 BigQuery 控制台左上角 Google Cloud 旁的專案選擇區域中，確認已選擇要執行 SQL 的 Google Cloud 專案。若未選擇，請點擊專案選擇區域，選擇具有 BigQuery 工作使用者角色的專案。

    bigquery_06.png

  2. 點擊 + 按鈕開啟 SQL 編輯器並撰寫查詢。

  3. 點擊查詢上方的 Run（執行）按鈕查詢資料。

    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 為基準進行每日分區。為降低查詢費用，請一併指定日期條件。

相關菜單