管理 BigQuery API 依附元件

本文說明 BigQuery 所依賴的 Google Cloud 服務和 API。並說明停用這些服務時，對 BigQuery 行為的影響。請先詳閱這份文件，再啟用或停用專案中的服務。

在您建立的每個 Google Cloud 專案中，系統預設會啟用部分服務。對於所有使用 BigQuery 的 Google Cloud 專案，系統會自動啟用其他 API。您必須明確啟用其餘服務，才能使用相關功能。如需更多資訊，請參閱下列資源：

本文適用對象為管理員。

預設啟用的服務

系統會預設為每個新Google Cloud 專案啟用下列服務：

服務 哪些功能會依賴此功能 停用這項服務的影響
analyticshub.googleapis.com
  • 您無法建立或管理資料交換、資訊清單、資料無塵室或訂閱項目。
  • 你無法搜尋及瀏覽其他供應商建立的廣告交易平台或房源。
  • 建立的訂閱項目會保留，但無法存取。
  • 只要啟用 BigQuery API，即可存取已連結的資料集。
  • 無法建立新的訂閱項目
bigqueryconnection.googleapis.com
  • 無法管理外部連結。
  • 無法建立遠端模型。
  • 您無法建立遠端函式。
  • 您無法查詢 BigLake 資料表和物件資料表。
bigquerymigration.googleapis.com
  • 您無法建立遷移作業或評估作業。
  • 無法使用現有的工作或評估。

注意：通常在完成資料遷移後，您可以停用這項服務。
bigquerydatapolicy.googleapis.com
  • 您無法管理資料遮蓋政策。
  • 資料遮蓋政策不會遭到刪除，但針對套用資料遮蓋的資料表進行查詢時會失敗。
bigqueryreservation.googleapis.com
  • 您無法建立或管理容量承諾、預訂或指派項目。
  • 您無法監控運算單元用量。
  • 無法使用災難復原容錯移轉功能。
  • 運算單元自動調度功能停止。
bigquerystorage.googleapis.com
dataform.googleapis.com
  • 您無法建立管道、已儲存的查詢、Colab 筆記本、資料畫布、資料準備或 Dataform 專案。
  • 現有的排程管道、Notebook 或 Dataform 專案會停止。
  • 任何現有的管道、已儲存的查詢、Colab 筆記本、資料畫布、資料準備或 Dataform 專案都無法存取。
dataplex.googleapis.com
  • 無法搜尋 BigQuery 資料資產。
  • 無法使用商家資訊搜尋分享功能。
  • 您無法建立新的剖析資料洞察資料、資料品質掃描或查詢建議，也無法存取先前建立的剖析資料洞察資料。
  • 您無法在沿革圖上查看資料資產詳細資料。
  • 您無法在資料資訊圖中搜尋資料資產。

由 BigQuery Unified API 啟用的服務

BigQuery Unified API (bigqueryunified.googleapis.com) 包含精選的服務集合，這些服務是各種 BigQuery 功能運作所需的必要服務。如果您啟用 BigQuery Unified API，所有這些服務都會同時啟用。Google 可以更新這個集合中的服務，這些服務會在啟用此 API 的專案中自動啟用。您可以停用個別服務和 API。

如要瞭解如何啟用 bigqueryunified.googleapis.com，請參閱「啟用及停用服務」。

服務 哪些功能會依賴此功能 停用這項服務的影響
aiplatform.googleapis.com
  • 你將無法執行筆記本。
  • 所有現有的 BigQuery ML 遠端模型都會停止運作。
  • 你仍可編輯現有的筆記本。
bigqueryunified.googleapis.com
  • 提供單鍵啟用此文件所列 BigQuery 依附服務的功能，但不包括 cloudaicompanion、composer 和 datalineage API。
  • 確認專案中已啟用新的 BigQuery 依附元件。
  • 日後依附元件不會自動在專案中啟用。
compute.googleapis.com
  • Google Compute Engine 為 Dataproc 和 Vertex AI 提供的所有功能提供執行階段環境。
  • Colab 筆記本、遠端機器學習模型、Apache Spark、SparkSQL 和 PySpark 工作會停止。
  • 原始碼仍可供使用。
  • Dataproc API 會停用。
dataproc.googleapis.com
  • 您無法建立 Dataproc 叢集來執行開放原始資料分析。
  • 您無法執行 Dataproc Serverless 工作負載。
  • 您無法在 BigQuery 工作負載中執行 Spark。
datastream.googleapis.com
  • 所有資料串流都已暫停，無法存取。

預設停用的服務

您必須手動啟用下列服務，才能使用對應的功能：

服務 哪些功能會依賴此功能 停用這項服務的影響
cloudaicompanion.googleapis.com
  • Gemini 版 BigQuery 功能
composer.googleapis.com
  • 現有的 Cloud Composer DAG 不會列於排程頁面，且會停止。
  • 現有的 Cloud Composer 環境會停止運作，並傳回錯誤狀態。
datalineage.googleapis.com
  • 專案未擷取資料沿革。
  • 您無法查看系譜圖。

手動啟用 BigQuery 程式碼資產

如要管理 BigQuery 中的程式碼資產 (例如筆記本和儲存的查詢)，您必須啟用下列 API：

  • Compute Engine API
  • Dataform API
  • Vertex AI API

在 2024 年 3 月前，這些 API 並未預設為自動啟用。如果您在 2024 年 3 月前建立的自動化指令碼依賴這些 API 的狀態，可能就需要更新這些指令碼。如果您已啟用這些 API，就會在 BigQuery 的「Explorer」窗格中看到新的「Notebook」和「Queries」資料夾。

事前準備

如要手動啟用程式碼資產管理功能，您必須具備 Identity and Access Management (IAM) 的Owner (roles/owner) 角色。

手動啟用 BigQuery 程式碼資產

如要為程式碼資產啟用必要的 API 依附元件，請按照下列步驟操作：

  1. 前往「BigQuery」頁面

    前往 BigQuery

  2. 在 Studio 的編輯器窗格分頁列中，按一下「+」號旁的 箭頭下拉式選單，將游標懸停在「Notebook」上，然後選取「BigQuery 範本」。

  3. 在編輯器窗格的分頁列下方顯示的橫幅中，按一下「啟用」。

    如果您沒有看到橫幅，請檢查自己是否具有必要的 IAM 擁有者角色。

  4. 在「啟用功能」窗格中的「核心功能 API」部分，執行下列操作：

    1. 如要啟用程式碼資產的版本記錄和共用功能，請在「版本記錄與共用」部分按一下「啟用」。
    2. 如要啟用筆記本，請在「Python 筆記本」下方，按一下「全部啟用」。
    3. 啟用 API 後，請按一下「Next」。

  5. 選用：在「Permissions」部分設定使用者權限：

    • 如要授予主體建立程式碼資產的權限，以及讀取、編輯及設定所建立的程式碼資產的權限，請在「Creator」欄位中輸入使用者或群組名稱。
    • 如要授予原始擁有者權限，讓他們能夠讀取、編輯及設定與他們共用的所有程式碼資產，請在「Owner」欄位中輸入使用者或群組名稱。

  6. 點選「下一步」。

  7. 選用：在「其他 API」部分，按一下「啟用所有」，即可啟用您需要用來使用 BigQuery DataFrame 建立 BigQuery 遠端程序的 API。

  8. 如果您選擇不啟用其他 API，請按一下「關閉」關閉「啟用功能」窗格。

限制程式碼資產的存取權

您可以設定限制資源服務用量機構政策限制，避免啟用其他 API。您隨時可以關閉所選 API。

後續步驟

  • 如要瞭解如何管理 Google Cloud 服務，請參閱「啟用及停用服務」。
  • 如要瞭解如何使用機構政策限制來精細管理 API 存取權，請參閱「限制資源用量」。
  • 如要瞭解如何使用 BigQuery 的 Identity and Access Management (IAM) 角色和權限控管服務存取權，請參閱「BigQuery IAM 角色和權限」。