管理 BigQuery API 依赖项
本文档介绍了 BigQuery 依赖的 Google Cloud 服务和 API。此外,其中还说明了停用这些服务对 BigQuery 行为的影响。在项目中启用或停用服务之前,请先查看本文档。
您创建的每个 Google Cloud 项目中都默认启用了部分服务。系统会自动为使用 BigQuery 的所有 Google Cloud 项目启用其他 API。您必须先明确启用其余服务,然后才能使用其功能。如需了解详情,请参阅以下资源:
本文档面向管理员。
默认启用的服务
默认情况下,系统会为每个新Google Cloud 项目启用以下服务:
服务 | 哪些功能依赖于它 | 停用此服务的影响 |
---|---|---|
analyticshub.googleapis.com |
|
|
bigqueryconnection.googleapis.com |
|
|
bigquerymigration.googleapis.com |
注意:通常,您可以在完成数据迁移后停用此服务。 |
|
bigquerydatapolicy.googleapis.com |
|
|
bigqueryreservation.googleapis.com |
|
|
bigquerystorage.googleapis.com |
|
|
dataform.googleapis.com |
|
|
dataplex.googleapis.com |
|
BigQuery Unified API 支持的服务
BigQuery Unified API (bigqueryunified.googleapis.com
) 包含一系列精选服务,这些服务是各种 BigQuery 功能正常运行所必需的。如果您启用 BigQuery Unified API,则所有这些服务都会同时激活。Google 可以更新此集合中的服务,并且在启用了此 API 的项目中,这些服务会自动启用。您可以停用个别服务和 API。
如需了解如何启用 bigqueryunified.googleapis.com
,请参阅启用和停用服务。
服务 | 哪些功能依赖于它 | 停用此服务的影响 |
---|---|---|
aiplatform.googleapis.com |
|
|
bigqueryunified.googleapis.com |
|
|
compute.googleapis.com |
|
|
dataproc.googleapis.com |
|
|
datastream.googleapis.com |
|
默认处于停用状态的服务
您必须手动启用以下服务,才能使用相应功能:
服务 | 哪些功能依赖于它 | 停用此服务的影响 |
---|---|---|
cloudaicompanion.googleapis.com |
|
|
composer.googleapis.com |
|
|
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 依赖项,请按以下步骤操作:
转到 BigQuery 页面。
在 Studio 的“Editor”窗格的标签页栏中,点击 + 号旁边的
下拉箭头,将指针悬停在 Notebook 上方,然后选择 BigQuery 模板。在编辑器窗格的标签页栏下方显示的横幅中,点击启用。
如果您没有看到该横幅,请检查您是否具有所需的 IAM Owner 角色。
在启用功能窗格的核心功能 API 部分中,执行以下操作:
- 如需启用代码资产的版本记录和共享,请在版本记录和共享部分中点击启用。
- 如需启用笔记本,请点击 Python 笔记本下方的全部启用。
- 启用 API 后,点击下一步。
可选:在权限部分中设置用户权限:
- 如需使主账号能够创建代码资源,以及读取、修改自己创建的代码资源和设置权限,请在创建者字段中输入其用户或群组名称。
- 如需使主账号能够读取、修改与其共享的所有代码资源和设置权限,请在所有者字段中输入其用户或群组名称。
点击下一步。
可选:在其他 API 部分中,点击全部启用,以启用使用 BigQuery DataFrame 创建 BigQuery 远程过程所需的 API。
如果您选择不启用其他 API,请点击关闭以关闭启用功能窗格。
限制对代码资产的访问
您可以通过设置限制资源服务使用组织政策限制条件来帮助阻止启用其他 API。您可以随时停用选定的 API。
后续步骤
- 如需了解如何管理 Google Cloud 服务,请参阅启用和停用服务。
- 如需了解如何使用组织政策限制条件在精细级别管理 API 访问权限,请参阅限制资源使用。
- 如需了解如何使用 BigQuery 的 Identity and Access Management (IAM) 角色和权限控制对服务的访问权限,请参阅 BigQuery IAM 角色和权限。