创建自定义查询配额

本文档介绍了如何设置或修改自定义查询配额以控制费用。如需了解 BigQuery 分析师如何估算和控制费用，请参阅估算和控制费用。

如果您有多个 BigQuery 项目和用户，可以通过申请自定义配额指定每天处理的数据量限额来管理费用。每日配额将在太平洋时间午夜重置。

自定义配额是主动式的，因此配额为 10 TB 时，无法运行 11 TB 的查询。 通过为处理的数据量创建自定义配额，您可以在项目级别或用户级别控制费用。

如需设置自定义费用控制，您可以更新以下一项或两项查询配额：

  • QueryUsagePerDay：项目级自定义配额会限制该项目中所有用户的总用量。

  • QueryUsagePerUserPerDay：用户级自定义配额会分别应用于项目中的所有用户和服务账号。

如需详细了解您可以设置的 BigQuery 配额，请参阅配额和限制。

所需角色

如需获得更改配额所需的权限，请让您的管理员为您授予项目的 Quota Administrator (role/servicemanagement.quotaAdmin) IAM 角色。如需详细了解如何授予角色，请参阅管理对项目、文件夹和组织的访问权限。

此预定义角色包含更改配额所需的 serviceusage.quotas.update 权限。

您也可以使用自定义角色或其他预定义角色来获取此权限。

设置或修改自定义配额

您可以为 Google Cloud 控制台的配额和系统限制页面上显示的任何配额设置自定义配额或修改现有自定义配额。当您申请更低的配额时，更改将在几分钟内生效。如果您申请了更高的配额，则请求会进入审批流程，这可能需要更多时间。如需了解详情，请参阅申请配额调整。

如需设置或更新自定义费用控制（例如，限制每天可处理的 BigQuery 数据量），请执行以下操作：

  1. 在 Google Cloud 控制台中，打开 IAM 和管理 > 配额和系统限制页面：

    进入“配额和系统限制”

  2. 使用过滤条件搜索框中的服务过滤条件来过滤 BigQuery API。

  3. 选择要调整的配额。例如，如需在项目级层和用户级层限制每天查询的数据量，请选择每天的查询用量和每位用户每天的查询用量。您可能需要浏览列表才能找到它们。选择配额后，系统会显示一个工具栏。

  4. 点击工具栏中的 修改。系统会打开配额更改对话框。

  5. 如果已选择无限制，请取消选择。

  6. 在新值字段中，输入所需的配额值（以 TiB 为单位）。

  7. 点击完成。

  8. 点击提交请求。

如需详细了解如何查看和管理配额，请参阅查看和管理配额。

返回的错误消息

在您设置自定义配额后，BigQuery 会在您超出此配额时返回错误：

  • 如果您超出项目级自定义配额，BigQuery 会返回 usageQuotaExceeded 错误：

    Custom quota exceeded: Your usage exceeded the custom quota for
QueryUsagePerDay, which is set by your administrator. For more information,
see https://cloud.google.com/bigquery/cost-controls

  • 如用户超出用户级自定义配额，BigQuery 同样会返回 usageQuotaExceeded 错误，只是给出不同的错误消息：

    Custom quota exceeded: Your usage exceeded the custom quota for
QueryUsagePerUserPerDay, which is set by your administrator. For more
information, see https://cloud.google.com/bigquery/cost-controls

您可以通过另一个可访问您的数据集并且未设置自定义配额或尚未超出该配额的项目，来运行查询。

示例

假设您为含有 10 个用户（其中一个是服务账号）的项目设置了以下自定义配额：

  • 项目级：每天 50 TB
  • 用户级：每天 10 TB

项目级自定义配额会限制该项目中所有用户的总用量。用户级自定义配额会分别应用于项目中的每个用户或服务账号。

下表列出了这 10 个用户在一天中运行完查询后的剩余配额。

用量 剩余配额
10 个用户每个查询了 4 TB 项目级：剩余 10 TB。
用户级：每个用户剩余 6 TB，但总共最多只能再查询 10 TB。
服务账号另外查询了 6 TB 项目级：剩余 4 TB。
用户级：该服务账号无法再使用 BigQuery。其他每个用户剩余 6 TB，但总共最多只能再查询 4 TB。
一个用户又另外查询了 4 TB 项目级：剩余 0 TB。
用户级：每个用户剩余 TB 数各不相同，但由于已超出项目级配额，所有用户都无法再使用 BigQuery。

由于已没有剩余配额，因此该项目中的任何人均无法再使用 BigQuery。

后续步骤