管理 BigQuery API 依附元件

如要管理 BigQuery 行為，請瞭解各項 API 如何影響依附於這些 API 的 Google Cloud 功能。您建立的每個 Google Cloud 專案都會預設啟用部分 API 服務，而使用 BigQuery 的所有 Google Cloud 專案則會自動啟用其他 API 服務。您必須明確啟用其餘 API 服務，才能使用這些服務的功能。

如果停用錯誤的依附元件，可能會影響 BigQuery 功能。瞭解這些依附元件，有助您在 Google Cloud 專案中啟用或停用服務時做出明智決策。

預設啟用的服務

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

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

注意：通常在完成資料遷移後，即可停用這項服務。
bigquerydatapolicy.googleapis.com
  • 您無法管理資料遮蓋政策。
  • 資料遮蓋政策不會遭到刪除，但查詢套用資料遮蓋的資料表時會失敗。
bigquerydatatransfer.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 為 Managed Service for Apache Spark 和 Gemini Enterprise Agent Platform 提供的所有功能，提供執行階段環境。
  • Colab 筆記本、遠端機器學習模型、Apache Spark、SparkSQL 和 PySpark 工作會停止。
  • 原始碼仍可使用。
  • Dataproc API 會停用。
dataproc.googleapis.com
  • 您無法建立 Managed Service for Apache Spark 叢集，執行開放原始碼資料分析。
  • 您無法執行 Managed Service for Apache Spark 工作負載。
  • 您無法在 BigQuery 工作負載中執行 Spark。
datastream.googleapis.com
  • 所有資料串流都會暫停，且無法存取。

預設停用的服務

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

服務 哪些功能需要這項服務 停用這項服務的影響
cloudaicompanion.googleapis.com
  • Gemini in BigQuery 功能
composer.googleapis.com
  • 現有的 Managed Service for Apache Airflow DAG 不會列在「Scheduling」(排程) 頁面上，且會停止。
  • 現有的 Managed Airflow 環境會停止運作，並傳回錯誤狀態。
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 的編輯器窗格分頁列中，按一下「+」符號旁的向下箭頭 ，將指標懸停在「筆記本」上，然後選取「空白筆記本」。

  3. 點按「啟用 API」。

    如果沒有看到這個選項，請檢查您是否具備必要的 IAM 擁有者角色 (roles/owner)。如果開啟空白的筆記本，表示您已啟用必要的 API。

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

    1. 如要啟用資料串流、排程和筆記本的所有 BigQuery 依附元件，請按一下「BigQuery Unified API」旁的「啟用」。
    2. 選用：如要選擇要啟用的 API，請按一下「查看及啟用個別 API」，然後按一下要啟用 API 旁的「啟用」。
    3. 啟用 API 後，請按一下「下一步」。

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

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

  6. 點選「下一步」。

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

  8. 如果選擇不啟用其他 API，請點選「關閉」關閉「啟用核心功能」窗格。

限制程式碼資產的存取權

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

後續步驟

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