管理 BigQuery API 依赖项
本文档介绍了 BigQuery 所依赖的 Trusted Cloud by S3NS 服务和 API。此外,本文还介绍了停用这些服务后对 BigQuery 行为的影响。在项目中启用或停用服务之前,请先查看此文档。
在您创建的每个 Trusted Cloud 项目中,某些服务默认处于启用状态。系统会自动为使用 BigQuery 的所有 Trusted Cloud 项目启用其他 API。您必须明确启用其余服务,然后才能使用它们的功能。如需了解详情,请参阅以下资源:
本文档面向管理员。
默认启用的服务
对于每个新Trusted 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 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 |
|
|
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 中,点击编辑器窗格标签页栏中 + 号旁边的
下拉箭头,将指针悬停在笔记本上,然后选择 BigQuery 模板。在编辑器窗格的标签页栏下方显示的横幅中,点击启用。
如果您没有看到该横幅,请检查您是否具有所需的 IAM Owner 角色。
在启用功能窗格的核心功能 API 部分中,执行以下操作:
- 如需启用代码资产的版本记录和共享,请在版本记录和共享部分点击启用。
- 如需启用笔记本,请点击 Python 笔记本下方的全部启用。
- 启用 API 后,点击下一步。
可选:在权限部分中设置用户权限:
- 如需使主账号能够创建代码资源,以及读取、修改自己创建的代码资源和设置权限,请在创建者字段中输入其用户或群组名称。
- 如需使主账号能够读取、修改与其共享的所有代码资源和设置权限,请在所有者字段中输入其用户或群组名称。
点击下一步。
可选:在其他 API 部分中,点击全部启用,以启用使用 BigQuery DataFrames 创建 BigQuery 远程过程所需的 API。
如果您选择不启用其他 API,请点击关闭以关闭启用功能窗格。
限制对代码资产的访问权限
您可以通过设置限制资源服务使用组织政策限制条件来帮助阻止启用其他 API。您可以随时停用选定的 API。
后续步骤
- 如需了解如何管理 Trusted Cloud 服务,请参阅启用和停用服务。
- 如需了解如何使用组织政策限制条件以精细的方式管理 API 访问权限,请参阅限制资源使用。
- 如需了解如何通过 BigQuery 的 Identity and Access Management (IAM) 角色和权限控制对服务的访问权限,请参阅 BigQuery IAM 角色和权限。