Crea cuotas de consultas personalizadas

En este documento, se describe cómo configurar o modificar las cuotas de consultas personalizadas para controlar los costos. Para obtener información sobre cómo los analistas de BigQuery pueden estimar y controlar los costos, consulta Estima y controla los costos.

Si tienes varios usuarios y proyectos de BigQuery, y deseas administrar los costos, puedes solicitar una cuota personalizada que especifique un límite para la cantidad de datos que se pueden procesar al día. Las cuotas diarias se restablecen a la medianoche, hora del Pacífico.

Las cuotas personalizadas son proactivas, por lo que no puedes ejecutar una consulta de 11 TB si tienes una cuota de 10 TB. Crear una cuota personalizada para los datos procesados te permite controlar los costos en el nivel de proyecto o en el nivel de usuario.

Para establecer controles de costos personalizados, puedes actualizar una o ambas de las siguientes cuotas de consultas:

  • QueryUsagePerDay: Las cuotas personalizadas a nivel de proyecto limitan el uso total de todos los usuarios en ese proyecto.

  • QueryUsagePerUserPerDay: La cuota personalizada a nivel de usuario se aplica de manera independiente a todos los usuarios y cuentas de servicio de un proyecto. Independientemente del límite por usuario, el uso total de todos los usuarios del proyecto combinados nunca puede superar el límite de uso de consultas por día.

El límite predeterminado para la cuota QueryUsagePerDay es de 200 tebibytes (TiB) de datos procesados por proyecto por día. El límite predeterminado para QueryUsagePerUserPerDay es ilimitado. Para verificar tus límites actuales, consulta la página Cuotas. Puedes cambiar los límites en cualquier momento. Las anulaciones personalizadas reemplazan los límites predeterminados.

Las cuotas de uso de consultas solo se aplican al modelo de precios de consultas según demanda.

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

Rol requerido

Si quieres obtener el permiso que necesitas para cambiar tu cuota, pídele a tu administrador que te otorgue el rol de IAM de administrador de cuotas (role/servicemanagement.quotaAdmin) en el proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

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

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

Configura o modifica las cuotas personalizadas

Puedes configurar una cuota personalizada o modificar una existente 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 más baja, el cambio se aplica en unos minutos. Si solicitas una cuota mayor, tu solicitud pasa por un proceso de aprobación que puede tardar más. Para obtener más información, consulta Solicita un ajuste de cuota.

Para establecer o actualizar un control de costos personalizado, como limitar la cantidad de datos de BigQuery que se pueden procesar cada día, haz lo siguiente:

  1. En la consola de Google Cloud , 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 Filtrar para filtrar por la API de BigQuery.

  3. Selecciona las cuotas que deseas ajustar. Por ejemplo, para limitar la cantidad de datos que se consultan por día tanto a nivel de proyecto como de usuario, selecciona Uso de consultas por día y Uso de consultas por día por usuario. Es posible que debas desplazarte por la lista para encontrarlos. Después de seleccionar una cuota, aparecerá una barra de herramientas.

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

  5. Si la opción Ilimitado está seleccionada, anula la selección.

  6. Ingresa el valor de cuota en TiB que deseas en el campo Valor nuevo.

  7. Haz clic en Listo.

  8. Haz clic en Enviar solicitud.

Para obtener más información sobre cómo ver y administrar las cuotas, consulta Visualiza y administra las cuotas.

Mensajes de error devueltos

Después de configurar una cuota personalizada, BigQuery muestra un error quotaExceeded cuando la excedes. En el mensaje, se indica la cuota que excediste: QueryUsagePerDay para una cuota personalizada a nivel de proyecto o QueryUsagePerUserPerDay para una cuota personalizada a nivel de usuario:

  • Custom quota exceeded: Your usage exceeded the custom quota for QueryUsagePerDay, which is set by your administrator.
  • Custom quota exceeded: Your usage exceeded the custom quota for QueryUsagePerUserPerDay, which is set by your administrator.

Para diagnosticar y resolver estos errores, consulta Soluciona problemas de errores de cuota de consultas diarias personalizadas.

Ejemplo

Supón que configuras las siguientes cuotas personalizadas para un proyecto con 10 usuarios, y uno de ellos corresponde a una cuenta de servicio:

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

Las cuotas personalizadas en el nivel de proyecto limitan el uso total de todos los usuarios en ese proyecto. Las cuotas personalizadas en el nivel de usuario se aplican, de manera independiente, a cada usuario o cuenta de servicio dentro de un proyecto.

En la siguiente tabla, se describe la cuota restante después de que 10 usuarios ejecuten consultas durante el día:

Uso Cuota restante
Cada uno de los 10 usuarios consulta 4 TB. Nivel de proyecto: Quedan 10 TBs.
Nivel de usuario: Quedan 6 TB por usuario, pero solo hasta 10 TB en total.
La cuenta de servicio consulta otros 6 TB. Nivel de proyecto: Quedan 4 TBs.
Nivel de usuario: La cuenta de servicio ya no puede usar BigQuery. Quedan 6 TB por usuario para los otros usuarios, pero solo hasta 4 TB en total.
Un usuario consulta otros 4 TB Nivel de proyecto: Quedan 0 TB.
Nivel de usuario: Quedan varios TB, pero nadie puede usar BigQuery debido a que se excedió la cuota en el nivel de proyecto.

Si se agotan todas las cuotas, BigQuery dejará de funcionar para todos los usuarios del proyecto.

¿Qué sigue?