已保存的查询简介

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

已保存的查询

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

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

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

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

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

已保存的查询安全

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

支持的区域

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

区域说明 区域名称 详情
模型
美洲
爱荷华 us-central1 叶形图标 二氧化碳排放量低
俄勒冈 us-west1 叶形图标 二氧化碳排放量低
圣保罗 southamerica-east1 叶形图标 二氧化碳排放量低
南卡罗来纳 us-east1
亚太地区
孟买 asia-south1
新加坡 asia-southeast1
台湾 asia-east1
东京 asia-northeast1
欧洲
比利时 europe-west1 叶形图标 二氧化碳排放量低
法兰克福 europe-west3 叶形图标 二氧化碳排放量低
伦敦 europe-west2 叶形图标 二氧化碳排放量低
荷兰 europe-west4
苏黎世 europe-west6 叶形图标 二氧化碳排放量低

配额和限制

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

传统版已保存的查询

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

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

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

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

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

弃用传统版已保存的查询

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

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

为了支持这一转换，以下 BigQuery IAM 角色将于 2024 年 2 月更新：

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

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

后续步骤