管理 BigQuery API 依附元件

本文說明 BigQuery 依附的 Google Cloud 服務和 API。此外，本文也會說明停用這些服務後，對 BigQuery 行為的影響。在專案中啟用或停用服務前，請先詳閱這份文件。

您建立的每個 Google Cloud 專案預設都會啟用部分服務。使用 BigQuery 的所有專案都會自動啟用其他 API。 Google Cloud 您必須明確啟用其餘服務，才能使用這些服務的功能。詳情請參閱下列資源：

本文適用對象為管理員。

預設啟用的服務

每個新專案預設會啟用下列服務：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 專案。
  • 現有的排定管道、筆記本或 Dataform 專案會停止。
  • 現有的管道、已儲存的查詢、Colab 筆記本、資料畫布、資料準備或 Dataform 專案都將無法存取。
dataplex.googleapis.com
  • 無法搜尋 BigQuery 資料資產。
  • 無法搜尋共用房源。
  • 您無法建立新的設定檔洞察、資料品質掃描或查詢建議，也無法存取先前建立的項目。
  • 您無法在沿襲圖中查看資料資產詳細資料。
  • 您無法在資料畫布中搜尋資料資產。

停用 BigQuery API 的影響

停用 BigQuery API 時，下列依附於 BigQuery API 的服務也會停用：

  • binaryauthorization.googleapis.com
  • container.googleapis.com
  • cloudapis.googleapis.com
  • dataprep.googleapis.com
  • servicebroker.googleapis.com
  • telecomdatafabric.googleapis.com

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 in 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」窗格中會顯示新的「Notebooks」和「Queries」資料夾。

事前準備

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

手動啟用 BigQuery 程式碼資產

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

  1. 前往「BigQuery」頁面

    前往 BigQuery

  2. 在 Studio 的編輯器窗格分頁列中，按一下「+」符號旁的向下箭頭 ，將指標懸停在「Notebook」上，然後選取「BigQuery template」。

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

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

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

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

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

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

  6. 點選「下一步」。

  7. 選用：在「其他 API」部分，按一下「全部啟用」，啟用使用 BigQuery DataFrames 建立 BigQuery 遠端程序的 API。

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

限制存取程式碼資產

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

後續步驟

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