使用 Google Cloud 擴充功能 (適用於 Visual Studio Code)

Google Cloud Visual Studio Code (VS Code) 擴充功能可讓您在 VS Code 中執行下列操作：

  • 開發及執行 BigQuery 筆記本。
  • 瀏覽、檢查及預覽 BigQuery 資料集。

事前準備

  1. 在本機終端機中，確認系統已安裝 Python 3.11 以上版本：

    python3 --version

  2. 安裝 Google Cloud CLI。

  3. 在本機終端機中初始化 gcloud CLI：

    gcloud init

  4. 設定預設專案：

    gcloud config set project PROJECT_ID

    將 PROJECT_ID 替換為預設專案。

  5. 設定應用程式預設憑證：

    gcloud auth application-default login

  6. 下載並安裝 VS Code。

  7. 開啟 VS Code，然後在活動列中按一下「擴充功能」。

  8. 使用搜尋列找出 Jupyter 擴充功能，然後按一下「安裝」。VS Code 中的 BigQuery 功能需要 Microsoft 的 Jupyter 擴充功能做為依附元件。

    VS Code 控制台中的 Jupyter 擴充功能清單。

安裝 Google Cloud 擴充功能

  1. 開啟 VS Code，然後在活動列中按一下「擴充功能」。

  2. 使用搜尋列尋找 Google Cloud Code 擴充功能，然後按一下「安裝」。

    VS Code 控制台中的 Google Cloud Code 擴充功能。

  3. 如果系統提示，請重新啟動 VS Code。

活動列中現在會顯示 Google Cloud Code 圖示。

設定擴充功能

  1. 開啟 VS Code，然後在活動列中點按「Google Cloud Code」。
  2. 開啟「BigQuery Notebooks」部分。
  3. 按一下「Login to Google Cloud」，系統會將您重新導向至登入頁面，請輸入憑證。
  4. 使用頂層應用程式工作列，依序前往「Code」>「Settings」>「Settings」>「Extensions」。
  5. 找到「Google Cloud Code」，然後點選「管理」圖示開啟選單。
  6. 選取 [設定]。
  7. 在「Cloud Code: Project」(Cloud Code：專案) 設定中，輸入要用於執行 Notebook 和顯示 BigQuery 資料集的Google Cloud 專案名稱。
  8. 在「Cloud Code > Beta: BigQuery Region」設定中，輸入 BigQuery 位置。 擴充功能會顯示這個位置的資料集。

開發 BigQuery 筆記本

  1. 開啟 VS Code，然後在活動列中點按「Google Cloud Code」。
  2. 開啟「BigQuery Notebooks」(BigQuery 筆記本) 專區，然後按一下「BigQuery Notebook」(BigQuery 筆記本)。系統會建立新的 .ipynb 檔案，其中包含範例程式碼，並在編輯器中開啟。

  3. 在新筆記本中，按一下「Select Kernel」，然後選取 Python 核心。 BigQuery 筆記本需要本機 Python 核心才能執行。您可以建立新的虛擬環境，或使用現有環境。

    VS Code 控制台中的選取核心介面。

  4. 如果虛擬環境中尚未安裝，請安裝 bigframes 用戶端程式庫：

    1. 開啟「終端機」視窗。
    2. 請執行 pip install bigframes 指令。

現在您可以在 BigQuery 筆記本中編寫及執行程式碼。

探索及預覽 BigQuery 資料集

  1. 開啟 VS Code，然後在活動列中點按「Google Cloud Code」。
  2. 如要查看指定專案和區域的資料集和資料表，請開啟「BigQuery Datasets」(BigQuery 資料集) 區段。您也可以看到 BigQuery 公開資料集。
  3. 如要在編輯器中開啟新分頁，請按一下任何表格名稱。這個分頁包含資料表詳細資料、結構定義和預覽畫面。

定價

Visual Studio Code 擴充功能免費，但您需要為使用的任何Google Cloud 服務 (BigQuery、Dataproc、Cloud Storage) 付費。

後續步驟