使用 BigQuery JupyterLab 外掛程式

如要尋求支援或針對這項功能提供意見回饋，請傳送電子郵件至 bigquery-ide-plugin@google.com。

本文說明如何安裝及使用 BigQuery JupyterLab 外掛程式，以執行下列操作：

BigQuery JupyterLab 外掛程式包含 Dataproc JupyterLab 外掛程式的所有功能，例如建立 Dataproc Serverless 執行階段範本、啟動及管理筆記本、使用 Apache Spark 開發、部署程式碼，以及管理資源。

安裝 BigQuery JupyterLab 外掛程式

如要安裝及使用 BigQuery JupyterLab 外掛程式，請按照下列步驟操作：

在本機終端機中，確認系統已安裝 Python 3.8 以上版本：
```
python3 --version
```
安裝 gcloud CLI。
在本機終端機中初始化 gcloud CLI：
```
gcloud init
```
安裝 Python 虛擬環境工具 Pipenv：
```
pip3 install pipenv
```
建立新的虛擬環境：
```
pipenv shell
```
在新虛擬環境中安裝 JupyterLab：
```
pipenv install jupyterlab
```
安裝 BigQuery JupyterLab 外掛程式：
```
pipenv install bigquery-jupyter-plugin
```
如果安裝的 JupyterLab 版本早於 4.0.0，請啟用外掛程式擴充功能：
```
jupyter server extension enable bigquery_jupyter_plugin
```
啟動 JupyterLab：
```
jupyter lab
```
JupyterLab 會在瀏覽器中開啟。

根據預設，工作階段會在您執行 gcloud init 時設定的專案和區域中執行。如要變更工作階段的專案和區域設定，請按照下列步驟操作：

您必須重新啟動外掛程式，變更才會生效。

如要在 JupyterLab 中處理 BigQuery 資料，請按照下列步驟操作：

如要從 JupyterLab 查詢 BigQuery 資料，請按照下列步驟操作：

如要開啟啟動器頁面，請依序點選「File」>「New Launcher」。
在「BigQuery Notebooks」部分，按一下「BigQuery DataFrames」資訊卡。系統會開啟新筆記本，說明如何開始使用 BigQuery DataFrames。

BigQuery DataFrames 筆記本支援在本機 Python 核心中開發 Python。BigQuery DataFrames 作業會在 BigQuery 上遠端執行，但其餘程式碼會在您本機電腦上執行。在 BigQuery 中執行作業時，程式碼儲存格下方會顯示查詢作業 ID 和作業連結。

您可以使用 Dataproc Serverless 執行階段範本，將 BigQuery DataFrames 筆記本部署至 Cloud Composer。您必須使用 2.1 以上的執行階段版本。

成功排定筆記本的執行時間後，所選 Cloud Composer 環境的排定工作清單中就會顯示該筆記本。