已保存的查询简介

本文档介绍了 BigQuery 中已保存的查询和传统版已保存的查询。

已保存的查询

本文档介绍了 BigQuery 中已保存的查询。您可以使用已保存的查询来创建和管理 SQL 脚本。已保存的查询可通过以下选项改进协作和查询管理：

使用 Identity and Access Management (IAM) 与特定用户和群组共享查询。
查看查询版本历史记录。
还原到先前的查询版本或从先前的查询版本创建分支。

已保存的查询会同时保存查询文本和查询设置。

已保存的查询是由 Dataform 提供支持的 BigQuery Studio 代码资产。笔记本也是代码资产。所有代码资产都存储在默认区域中。更新默认区域会更改此后创建的所有代码资产的区域。

已保存的查询功能仅在 Google Cloud 控制台中提供。

已保存的查询安全

您可以使用 Identity and Access Management (IAM) 角色来控制对已保存查询的访问权限。如需了解详情，请参阅授予对已保存的查询的访问权限。

支持的区域

借助 BigQuery Studio，您可以保存、共享和管理已保存的查询。下表列出了可使用 BigQuery Studio 的区域：

	区域说明	区域名称	详细信息
非洲
	约翰内斯堡	`africa-south1`
美洲
	哥伦布	`us-east5`
	达拉斯	`us-south1`	二氧化碳排放量低
	艾奥瓦	`us-central1`	二氧化碳排放量低
	洛杉矶	`us-west2`
	拉斯维加斯	`us-west4`
	蒙特利尔	`northamerica-northeast1`	二氧化碳排放量低
	北弗吉尼亚	`us-east4`
	俄勒冈	`us-west1`	二氧化碳排放量低
	圣保罗	`southamerica-east1`	二氧化碳排放量低
	南卡罗来纳	`us-east1`
亚太地区
	香港	`asia-east2`
	雅加达	`asia-southeast2`
	孟买	`asia-south1`
	首尔	`asia-northeast3`
	新加坡	`asia-southeast1`
	悉尼	`australia-southeast1`
	台湾	`asia-east1`
	东京	`asia-northeast1`
欧洲
	比利时	`europe-west1`	二氧化碳排放量低
	法兰克福	`europe-west3`	二氧化碳排放量低
	伦敦	`europe-west2`	二氧化碳排放量低
	马德里	`europe-southwest1`	二氧化碳排放量低
	荷兰	`europe-west4`	二氧化碳排放量低
	都灵	`europe-west12`
	苏黎世	`europe-west6`	二氧化碳排放量低
中东
	多哈	`me-central1`
	Dammam	`me-central2`

配额和限制

如需了解详情，请参阅已保存查询配额和限制。

限制

已存储的查询存在以下限制：

您只能向 allAuthenticatedUsers 正文授予对已保存查询的公开访问权限。您无法向 allUsers 主账号授予对已保存查询的访问权限。
如果您的 Google Cloud 项目包含超过 2500 个传统版已保存的查询，则无法使用批量迁移（预览）将传统版已保存的查询迁移到已保存的查询。

传统版已保存的查询

传统版已保存的查询是保存和共享 SQL 查询的较早方式。传统版已保存的查询提供查询文本，并且传统版已保存的查询保留的唯一查询设置是 SQL 版本。此设置控制查询是使用旧版 SQL 还是 GoogleSQL。如需查询数据，用户必须有权访问已保存的查询所访问的数据。如需了解详情，请参阅授予对已保存的查询的访问权限。

传统版已保存的查询有以下 3 种类型：

个人。 个人的传统版已保存的查询仅对创建它们的用户可见。它们由图标标识。
项目级。项目级已保存的查询对拥有所需权限的主账号可见。它们由图标标识。
公开。 公开的传统版已保存的查询对知道查询链接的任何人都可见。它们由图标标识。

您可以将传统版已保存的查询迁移到已保存的查询以利用新功能，也可以在 2025 年之前作为传统版已保存的查询继续保留它们。

经典的已保存查询功能仅在 Google Cloud 控制台中提供。

弃用传统版已保存的查询

BigQuery Studio 已保存的查询功能将在 2025 年 3 月之前取代传统版已保存的查询。如需在 2024 年之后修改现有的传统版已保存的查询，您必须将传统版查询迁移到 BigQuery Studio 保存的查询。

如果用户（包括您自己）的个人查询包含的信息不应提供给有权访问项目中的数据的其他人，则查询的所有者必须在 2025 年 3 月之前删除该查询或信息。

为了支持此转换，我们于 2024 年 2 月更新了以下 BigQuery IAM 角色：

BigQuery Admin (roles/bigquery.admin) 将获得 Dataform Admin (roles/dataform.admin) 权限。
BigQuery Job User (roles/bigquery.jobUser) 将获得以下权限：
- dataform.locations.get
- dataform.locations.list
- dataform.repositories.create
- dataform.repositories.list
BigQuery User (roles/bigquery.user) 将获得以下权限：
- dataform.locations.get
- dataform.locations.list
- dataform.repositories.create
- dataform.repositories.list

如需允许没有 BigQuery Admin、BigQuery Job User 或 BigQuery User 角色的用户使用已保存的查询，请在 IAM 中为他们授予所需的权限。

自定义角色不会自动更新。如需更新具有所需权限的自定义角色，请参阅修改现有自定义角色。

后续步骤

如需了解如何创建已保存的查询，请参阅创建已保存的查询。
如需了解如何管理已保存的查询，请参阅管理已保存的查询。