Crear cuotas de consulta personalizadas

En este documento se describe cómo definir o modificar cuotas de consultas personalizadas para controlar los costes. Para saber cómo pueden los analistas de BigQuery estimar y controlar los costes, consulta el artículo Estimar y controlar los costes.

Si tienes varios proyectos y usuarios de BigQuery, puedes gestionar los costes solicitando una cuota personalizada que limite la cantidad de datos que se procesan al día. Las cuotas diarias se reinician a medianoche (UTC-8).

La cuota personalizada es proactiva, por lo que no puedes realizar una consulta de 11 TB si tienes una cuota de 10 TB. Si creas una cuota personalizada para los datos procesados, podrás controlar los costes a nivel de proyecto o de usuario.

Para definir controles de costes personalizados, puede actualizar una o ambas de las siguientes cuotas de consulta:

  • QueryUsagePerDay: Las cuotas personalizadas a nivel de proyecto limitan el uso global de todos los usuarios del proyecto en cuestión.

  • QueryUsagePerUserPerDay: Las cuotas personalizadas a nivel de usuario se aplican por separado a todos los usuarios y cuentas de servicio de un proyecto.

Las cuotas de uso de consultas solo se aplican al modelo de precios de consultas bajo demanda.

Para obtener más información sobre las cuotas de BigQuery que puedes definir, consulta Cuotas y límites.

Rol necesario

Para obtener el permiso que necesitas para cambiar tu cuota, pide a tu administrador que te conceda el rol de gestión de identidades y accesos Administrador de cuota (role/servicemanagement.quotaAdmin) en tu proyecto. Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar el acceso a proyectos, carpetas y organizaciones.

Este rol predefinido contiene el permiso serviceusage.quotas.update , que es necesario para cambiar tu cuota.

También puedes obtener este permiso con roles personalizados u otros roles predefinidos.

Fijar o modificar cuotas personalizadas

Puedes fijar o modificar una cuota personalizada para cualquier cuota que se muestre en la página Cuotas y límites del sistema de la consola de Google Cloud . Cuando solicitas una cuota inferior, el cambio se aplica en cuestión de minutos. Si solicitas una cuota más alta, tu solicitud pasará por un proceso de aprobación que puede llevar más tiempo. Para obtener más información, consulta Solicitar un ajuste de cuota.

Para definir o actualizar un control de costes personalizado, como limitar la cantidad de datos de BigQuery que se pueden procesar cada día, sigue estos pasos:

  1. En la Google Cloud consola, abre la página IAM y administración > Cuotas y límites del sistema:

    Ir a Cuotas y límites del sistema

  2. Usa el filtro Servicio en el cuadro de búsqueda Filtro para filtrar por la API de BigQuery.

  3. Selecciona las cuotas que quieras ajustar. Por ejemplo, para limitar la cantidad de datos que se pueden consultar por día tanto a nivel de proyecto como de usuario, seleccione Uso de consultas por día y Uso de consultas por día y usuario. Puede que tengas que desplazarte por la lista para encontrarlos. Después de seleccionar una cuota, aparece una barra de herramientas.

  4. En la barra de herramientas, haz clic en Editar. Se abrirá el cuadro de diálogo Cambios en la cuota.

  5. Si la opción Ilimitado está seleccionada, desmárcala.

  6. En el campo Valor nuevo, introduce el valor de cuota en TiB que quieras.

  7. Haz clic en Listo.

  8. Haz clic en Enviar solicitud.

Para obtener más información sobre cómo ver y gestionar las cuotas, consulta el artículo Ver y gestionar cuotas.

Mensajes de error devueltos

Cuando hayas establecido una cuota personalizada, BigQuery mostrará un error si la superas:

  • Si superas una cuota personalizada a nivel de proyecto, BigQuery devolverá el error 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

  • Si el usuario supera una cuota personalizada a nivel de usuario, BigQuery devolverá un error usageQuotaExceeded con otro mensaje:

    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

Puedes ejecutar la consulta desde otro proyecto que tenga acceso a tus conjuntos de datos y que no tenga cuota personalizada o que aún no la haya superado.

Ejemplo

Supongamos que estableces las siguientes cuotas personalizadas para un proyecto con 10 usuarios, uno de los cuales es una cuenta de servicio:

  • Nivel de proyecto: 50 TB al día
  • Nivel de usuario: 10 TB al día

Las cuotas personalizadas a nivel de proyecto limitan el uso conjunto de todos los usuarios de un proyecto determinado. Las cuotas personalizadas a nivel de usuario se aplican por separado a cada usuario o cuenta de servicio de un proyecto concreto.

En la tabla siguiente se describe la cuota restante a medida que los 10 usuarios van ejecutando consultas durante el día.

Uso Cuota restante
Cada uno de los 10 usuarios acumula 4 TB de consultas Nivel de proyecto: quedan 10 TB.
Nivel de usuario: quedan 6 TB por usuario, pero solo 10 TB en total como máximo.
La cuenta de servicio acumula 6 TB de consultas Nivel de proyecto: quedan 4 TB.
Nivel de usuario: la cuenta de servicio ya no puede usar BigQuery. Quedan 6 TB para cada uno de los demás usuarios, pero solo 4 TB en total como máximo.
Un usuario realiza otros 4 TB de consultas Nivel de proyecto: quedan 0 TB.
Nivel de usuario: quedan varios TB, pero nadie puede usar BigQuery porque se ha superado la cuota a nivel de proyecto.

Cuando se agota la cuota, ningún miembro puede usar BigQuery en ese proyecto.

Siguientes pasos