使用 BigQuery 網頁版 UI

BigQuery 提供圖形化網頁版 UI,您可以用來建立和管理 BigQuery 資源,以及執行 SQL 查詢。此頁面提供 BigQuery 網頁版 UI 的使用總覽。

如要瞭解如何使用網頁版 UI,請參閱: BigQuery 網頁版 UI 快速入門導覽課程

事前準備

如要使用 BigQuery 瀏覽器工具,您的帳戶必須有權存取 Cloud Console 中啟用 BigQuery 的專案。您建立的新專案均預設為啟用 BigQuery。如果您想要有 Google Cloud Platform 免費版使用限制以外的服務,則必須為您的專案啟用計費功能

  1. 登入您的 Google 帳戶。

    如果您沒有帳戶,請申請新帳戶

  2. 選取或建立 Google Cloud Platform 專案。

    前往「Manage resources」(管理資源) 頁面

  3. 請確認您已啟用 Google Cloud Platform 專案的計費功能。

    瞭解如何啟用計費功能

  4. 新專案會自動啟用 BigQuery。 若要在預先存在的專案中啟用 BigQuery: 啟用 BigQuery API。

    啟用 API

開啟網頁版 UI

如要開啟網頁版 UI,請在瀏覽器中輸入下列網址,並將 project_id 替換成您要在網頁版 UI 中開啟的專案 ID:

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

點選下面的按鈕即會在網頁版 UI 中開啟您最近存取過的專案。

前往網頁版 UI

網頁版 UI 總覽

網頁版 UI 分為三個主要部分:

  1. 頁面左側 (導覽窗格):
    導覽窗格的上半部提供您可執行的動作項目清單:撰寫查詢、查看查詢記錄,或查看工作記錄。
    導覽窗格的下半部提供您目前有專案存取權的資料集清單,以及 BigQuery 公開資料集。您可以在提供的篩選框中依資料集 ID 或標籤來篩選資料集。
  2. 詳細資料窗格:
    提供您在導覽窗格中所選取動作的相關資訊。例如,如果您在導覽窗格中按一下資料集,詳細資料窗格就會顯示該資料集的相關資訊。
  3. 查詢視窗:
    按一下 [Compose Query] 即會在詳細資料窗格的上方加入「New Query」視窗。當您不再需要使用這個視窗時,可以將其關閉。

BigQuery 網頁版 UI 螢幕擷取畫面

顯示資源

導覽窗格會列出目前專案中您可以瀏覽的資料集。點選任何資料集旁的 展開資料集圖示 圖示或按一下資料集名稱,就能展開該資料集並顯示其中的資料表。

按一下資料表即可在詳細資料窗格中顯示該資料表的相關資訊。接著,您可以按一下窗格右側的 [Query Table] 按鈕,在查詢方塊中填入針對該資料表的基本查詢。如果您想要指定欄位或視您個人需求自訂查詢,可以手動修改查詢。此外,系統不會規定您一定要查詢目前選取的資料表。如要深入瞭解如何查詢資料表,請參閱執行互動式查詢一文。

新增與移除專案

所有的 BigQuery 工作都是在專案中完成,專案名稱會顯示在資料集清單上方的導覽窗格中。您在專案中的所有工作都會向與此專案連結的帳單帳戶收費。如要深入瞭解 BigQuery 費用,請參閱計價頁面。

在網頁版 UI 中,您可以:

  • 新增 (或固定) 額外的專案
  • 移除固定的專案
  • 切換至不同的專案

新增專案

您可以使用專案的下拉式選單,在網頁版 UI 中新增或「固定」專案。將專案固定在導覽窗格可讓您瀏覽及查詢另一個專案中的資源。如果您在固定的專案中查詢資源,系統會向連結至您專案的帳單帳戶收取查詢費用,固定的專案則不計費。

如何在 UI 中新增專案:

  1. 在導覽窗格中,點選專案名稱旁的向下箭號圖示 向下箭號圖示

  2. 在下拉式選單中,按一下 [Switch to project] > [Display project]

  3. 在「Display Project」對話方塊中:

    • 輸入專案 ID。
    • 保留選取「Display project in navigation panel」
    • 按一下 [OK],將專案新增至導覽面板。

    顯示專案對話方塊

從 UI 中移除專案

如何移除您之前新增 (或「固定」) 的專案:

  1. 在導覽窗格中,點選專案名稱旁的向下箭號圖示 向下箭號圖示

  2. 在下拉式選單中,按一下 [Remove project from panel]

切換專案

如果想要切換至另一個專案 (而不是將專案固定在 UI 中),您可以使用內容選單。

如何切換專案:

  1. 在導覽窗格中點選專案名稱旁的向下箭號圖示 向下箭號圖示

  2. 在下拉式選單中,按一下 [Switch to project],然後從清單中選擇專案。系統就會以您選擇的專案取代之前在 UI 中的專案。

新增共用資料集

另一位使用者能在不提供對應專案存取權的情況下與您共用資料集。如果為此種情況,系統會向您傳送一封電子郵件,提供含有該共用資料集的專案名稱。專案和資料集並不會自動出現在 UI 中。

如果您按一下電子郵件中的 browser tool 連結,即會開啟網頁版 UI 並顯示該專案。如果您想要固定含有共用資料集的專案,請遵循新增專案中的步驟。

查看工作和查詢記錄

當您使用網頁版 UI 執行工作執行查詢時,記錄會保留在導覽窗格中。查詢也是一種工作類型,但查詢記錄會分開保存以便使用。

UI 中的工作和查詢記錄包含您在過去 6 個月內提交的所有載入、匯出、複製及查詢工作 (最多 1,000 個項目)。1,000 個工作的上限是所有工作類型的累計值。

查看工作記錄

如要查看記錄,您可以執行下列其中一項操作:

  • 在導覽窗格中按一下 [Job History] 連結。

  • 在瀏覽器中輸入下列網址:

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

您可以使用網頁版 UI 重複執行載入工作,但不能重複執行匯出或複製工作。

查看查詢記錄

如要查看查詢記錄,您可以執行下列其中一項操作:

  • 在導覽窗格中按一下 [Query History] 連結。

  • 在瀏覽器中輸入下列網址:

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

您可以使用網頁版 UI 重複執行查詢工作

搜尋工作與查詢記錄

您可以篩選 (或搜尋) 查詢記錄或工作記錄,只讓符合條件的特定工作顯示。傳回的結果僅限於 UI 擷取的工作集區。根據預設,您可以在 UI 搜尋 1,000 個最新的工作。

如要列出記錄中所有可用工作,請使用 jobs.list API 方法或 bq ls CLI 指令。

如何篩選查詢或工作記錄:

  1. 在導覽窗格中,按一下 [Job History] 或 [Query History]
  2. 按一下「Filter jobs」的下拉式選單按鈕以開啟篩選器運算式方塊。
  3. 在篩選器運算式方塊中:

    • 按一下 [Any],選擇一個篩選條件。
    • 按一下運算子下拉式選單並選擇運算子。依據您選擇的條件,運算子清單也會隨之變更。舉例來說,如果您選擇文字條件,則運算子清單會包含「substring」和「regex」
    • 在方塊中輸入值。

      篩選器運算式製作工具

  4. 按一下 [And],將其他選用的條件加入篩選器。

  5. 按一下 [Search]

您可以使用下列任一工作屬性來篩選查詢工作:

  • Any:任何屬性。
  • Job ID (jobid):工作的唯一不透明 ID。
  • User (user):提交工作的使用者。
  • Start Time (start):工作的開始時間,以紀元後毫秒為單位。工作狀態從 PENDING 轉換成 RUNNINGDONE 時,即會出現此屬性。
  • End Time (end):工作的結束時間,以紀元後毫秒為單位。此屬性會在工作處於 DONE 狀態時出現。
  • Destination table (dest):工作作業 (載入、複製或查詢) 的目的地資料表名稱。
  • Query text:提交的 SQL 查詢文字。
  • Bytes processed:SQL 查詢處理的位元組總數。
  • UDF code:含有使用者定義函式 (UDF) 程式碼的內嵌資源。

您可以使用下列任一工作屬性篩選載入、複製和擷取工作:

  • Any:任何屬性。
  • Job ID (jobid):工作的唯一不透明 ID。
  • User (user):提交工作的使用者。
  • Start Time (start):工作的開始時間,以紀元後毫秒為單位。工作狀態從 PENDING 轉換成 RUNNINGDONE 時,即會出現此屬性。
  • End Time (end):工作的結束時間,以紀元後毫秒為單位。此屬性會在工作處於 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] 排序 UI 中的查詢記錄。在導覽窗格按一下 [Query History] 即會開啟「Queries」窗格。

查詢記錄排序依據按鈕

排序選項包括:

  • [日期] — 依照執行日期為查詢排序。
  • [時間長度] — 依照總執行時間為查詢排序。
  • [時間長度/位元組] — 依照時間歷程為查詢排序,以輸入位元組為標準化格式。這可以讓您比較查詢的執行時間以及輸入量的變化。例如,您可能有一組資料表會隨時間變大,而您想要比較查詢的效率,又不想受到單純因為輸入量的變化而產生的差異所干擾。這是以輸入量與執行時間呈現線性關係為假設前提。
  • [輸入位元組] — 依照讀取的位元組數為查詢排序。
  • [運算單元-毫秒] — 依照查詢使用的所有運算單元計算的總毫秒數為查詢排序。依照「運算單元-毫秒」排序是較為穩定的處理成效測量方法,因為這比較不會受到系統延遲以及其他可能影響觀察時間的不確定因素所干擾。
  • 運算單元-毫秒/位元組:與「時間長度/位元組」類似,是「運算單元-毫秒」的標準格式。

    查詢記錄排序選項

網頁版 UI 顯示限制

網頁版 UI 的顯示限制如下:

  • 導覽窗格最多可以顯示 10,000 個專案。
  • 每個專案最多可以在導覽窗格中顯示 1,000 個資料集。
  • 每個資料集最多可以在導覽窗格中顯示 30,000 個資料表。所有資料集可以顯示的資料表累計總數為 75,000 個 (包括固定專案中的資料集)。

控制網頁版 UI 顯示效能

在罕見情況下,如果專案包含大量的資料集,而資料集又包含大量的資料表,網頁版 UI 效能就會受到影響。如要在專案含有大量資源時改善 UI 效能,請使用 ?minimal 參數,將顯示的資源數限制為每個專案 10,000 個資料表。例如,在瀏覽器中輸入下列網址以限制顯示的資源數。

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

鍵盤快速鍵

網頁版 UI 支援下列鍵盤快速鍵:

按鍵組合 (Windows/Linux) 按鍵組合 (Mac OS) 動作
Ctrl + 空格鍵 Ctrl + 空格鍵 如果沒有開啟任何查詢:撰寫新查詢
如果開啟查詢編輯器:自動完成目前文字
Ctrl + Enter 鍵 Cmd + Enter 鍵 執行目前查詢
Tab 鍵 Tab 鍵 自動完成目前文字
Ctrl 鍵 Cmd 醒目顯示資料表名稱
Ctrl + 點選資料表名稱 Cmd + 點選資料表名稱 開啟資料表結構定義
Ctrl + E Cmd + E 對選取範圍執行查詢
Ctrl + / Cmd + / 評論目前或選取行
Ctrl + Shift + F Cmd + Shift + F 格式化查詢

範例

如需網頁版 UI 範例,請參閱 BigQuery 說明文件的教學指南一節。以下是一般網頁版 UI 工作的連結,包含執行查詢及建立、取得、列出、刪除及修改 BigQuery 資源等。

查詢資料

如要瞭解如何使用網頁版 UI 建立和執行查詢,請參閱:

建立資源

如要瞭解如何使用網頁版 UI 建立資源,請參閱:

取得資源相關資訊

如要瞭解如何使用網頁版 UI 取得資源相關資訊,請參閱:

列出資源

如要瞭解如何使用網頁版 UI 列出資源,請參閱:

更新資源

如要瞭解如何使用網頁版 UI 更新資源,請參閱:

載入資料

如要瞭解如何使用網頁版 UI 載入資料,請參閱:

使用外部資料來源

如要瞭解如何使用網頁版 UI 查詢外部資料來源的資料,請參閱:

匯出資料

如要瞭解如何使用網頁版 UI 匯出資料,請參閱:

使用 BigQuery 資料移轉服務

如要瞭解如何使用網頁版 UI 搭配 BigQuery 資料移轉服務,請參閱:

本頁內容對您是否有任何幫助?請提供意見:

傳送您對下列選項的寶貴意見...

這個網頁