管理 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 依赖服务的功能,不包括 cloudaicompanioncomposerdatalineage 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 未列在“Scheduling”(安排)页面上,并且会停止运行。
  • 现有 Cloud Composer 环境无法运行,会停止工作并返回错误状态。
datalineage.googleapis.com
  • 系统未捕获项目的数据谱系。
  • 您无法查看沿袭图。

手动启用 BigQuery 代码资产

如需在 BigQuery 中管理代码资产(例如笔记本和已保存的查询),您必须启用以下 API:

  • Compute Engine API
  • Dataform API
  • Vertex AI API

在 2024 年 3 月之前,这些 API 默认不会自动启用。如果 2024 年 3 月之前的自动化脚本依赖于这些 API 的状态,则可能需要更新它们。如果您已启用这些 API,则会在 BigQuery 的探索器窗格中看到新的笔记本查询文件夹。

准备工作

如需手动启用代码资产管理,您必须具有 Identity and Access Management (IAM) Owner (roles/owner) 角色

手动启用 BigQuery 代码资产

如需为代码资源启用必需的 API 依赖项,请按以下步骤操作:

  1. 转到 BigQuery 页面。

    转到 BigQuery

  2. Studio 的“Editor”窗格的标签页栏中,点击 + 号旁边的 下拉箭头,将指针悬停在 Notebook 上方,然后选择 BigQuery 模板

  3. 在编辑器窗格的标签页栏下方显示的横幅中,点击启用

    如果您没有看到该横幅,请检查您是否具有所需的 IAM Owner 角色。

  4. 启用功能窗格的核心功能 API 部分中,执行以下操作:

    1. 如需启用代码资产的版本记录和共享,请在版本记录和共享部分中点击启用
    2. 如需启用笔记本,请点击 Python 笔记本下方的全部启用
    3. 启用 API 后,点击下一步
  5. 可选:在权限部分中设置用户权限:

    • 如需使主账号能够创建代码资源,以及读取、修改自己创建的代码资源和设置权限,请在创建者字段中输入其用户或群组名称。
    • 如需使主账号能够读取、修改与其共享的所有代码资源和设置权限,请在所有者字段中输入其用户或群组名称。
  6. 点击下一步

  7. 可选:在其他 API 部分中,点击全部启用,以启用使用 BigQuery DataFrame 创建 BigQuery 远程过程所需的 API。

  8. 如果您选择不启用其他 API,请点击关闭以关闭启用功能窗格。

限制对代码资产的访问

您可以通过设置限制资源服务使用组织政策限制条件来帮助阻止启用其他 API。您可以随时停用选定的 API

后续步骤

  • 如需了解如何管理 Google Cloud 服务,请参阅启用和停用服务
  • 如需了解如何使用组织政策限制条件在精细级别管理 API 访问权限,请参阅限制资源使用
  • 如需了解如何使用 BigQuery 的 Identity and Access Management (IAM) 角色和权限控制对服务的访问权限,请参阅 BigQuery IAM 角色和权限