Creare quote di query personalizzate

Questo documento descrive come impostare o modificare le quote di query personalizzate per controllare i costi. Per scoprire in che modo gli analisti BigQuery possono stimare e controllare i costi, consulta Stimare e controllare i costi.

Se disponi di più utenti e progetti di BigQuery, puoi gestire i costi richiedendo una quota personalizzata che definisce un limite alla quantità giornaliera di dati elaborati. Le quote giornaliere vengono reimpostate alla mezzanotte del fuso orario del Pacifico.

La quota personalizzata è proattiva e pertanto non puoi eseguire una query da 11 TB se disponi di una quota di 10 TB. La creazione di una quota personalizzata per i dati elaborati consente di controllare i costi a livello di progetto o di utente.

  • QueryUsagePerDay: le quote personalizzate a livello di progetto limitano l'utilizzo complessivo di tutti gli utenti in un determinato progetto.

  • QueryUsagePerUserPerDay: la quota personalizzata a livello di utente viene applicata separatamente a tutti gli utenti e agli account di servizio all'interno di un progetto.

Ruolo richiesto

Per ottenere l'autorizzazione necessaria per modificare la quota, chiedi all'amministratore di concederti il ruolo IAM Amministratore quota (role/servicemanagement.quotaAdmin) nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito contiene l'autorizzazione serviceusage.quotas.update, necessaria per modificare la quota.

Potresti anche ottenere questa autorizzazione con ruoli personalizzati o altri ruoli predefiniti.

Impostare o modificare le quote personalizzate

Puoi impostare una quota personalizzata o modificarne una esistente per qualsiasi quota visualizzata nella pagina Quote di Google Cloud Console. Per ulteriori informazioni, consulta Visualizzare e gestire le quote. Quando richiedi una quota inferiore, la modifica diventa effettiva entro pochi minuti. Se richiedi una quota più alta, la tua richiesta viene sottoposta a una procedura di approvazione che può richiedere più tempo. Per ulteriori informazioni, consulta Richiedere un limite di quota più alto.

Puoi visualizzare i livelli di quota personalizzati nella pagina della console Google Cloud. Dopo aver impostato una quota personalizzata, BigQuery restituisce un errore nel caso in cui venga superata:

  • Se superi una quota personalizzata a livello di progetto, BigQuery restituisce l'errore 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

  • Se l'utente supera una quota personalizzata a livello di utente, BigQuery restituisce un errore usageQuotaExceeded con un messaggio diverso:

    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

Puoi eseguire la query da un altro progetto che ha accesso ai tuoi set di dati e che non presenta una quota personalizzata o che non l'ha ancora superata.

Esempio

Supponi di aver impostato le seguenti quote personalizzate per un progetto con 10 utenti, uno dei quali è un account di servizio:

  • A livello di progetto: 50 TB al giorno
  • A livello di utente: 10 TB al giorno

Le quote personalizzate a livello di progetto limitano l'utilizzo complessivo di tutti gli utenti in un determinato progetto. Le quote personalizzate a livello di utente vengono applicate separatamente a ciascun utente o account di servizio all'interno di un progetto.

La seguente tabella descrive le quote rimanenti quando i 10 utenti eseguono query durante il giorno.

Utilizzo Quota rimanente
Ognuno dei 10 utenti esegue query per 4 TB A livello di progetto: rimangono 10 TB.
A livello di utente: rimangono 6 TB per utente, ma solo fino a un totale di 10 TB.
L'account di servizio esegue query per altri 6 TB A livello di progetto: rimangono 4 TB.
A livello di utente: l'account di servizio non può più utilizzare BigQuery. Rimangono 6 TB per utente per gli altri utenti, ma solo fino a un totale di 4 TB.
Un utente esegue query per altri 4 TB A livello di progetto: rimangono 0 TB.
A livello di utente: rimangono vari TB, ma nessuno può utilizzare BigQuery poiché la quota a livello di progetto è stata superata.

In assenza di quota rimanente, BigQuery smette di funzionare per tutti gli utenti del progetto.

Passaggi successivi