Benutzerdefinierte Abfragekontingente erstellen

In diesem Dokument wird beschrieben, wie benutzerdefinierte Abfragekontingente zur Kostenkontrolle festgelegt oder geändert werden. Informationen, wie BigQuery-Analysten Kosten schätzen und kontrollieren können, finden Sie unter Kosten schätzen und kontrollieren.

Wenn Sie mehrere BigQuery-Projekte und -Nutzer haben, können Sie die Kosten kontrollieren. Fordern Sie dafür ein benutzerdefiniertes Kontingent an, das die Menge der pro Tag verarbeiteten Daten begrenzt. Die Kontingente werden jeden Tag um Mitternacht (Pacific Standard Time) zurückgesetzt.

Benutzerdefinierte Kontingente sind proaktiv. Mit einem Kontingent von 10 TB können Sie also keine Abfrage mit 11 TB ausführen. Durch das Erstellen eines benutzerdefinierten Kontingents für verarbeitete Daten können Sie Kosten auf Projektebene oder auf Nutzerebene steuern.

Wenn Sie benutzerdefinierte Kostenkontrollen festlegen möchten, können Sie eines oder beide der folgenden Abfragekontingente aktualisieren:

  • QueryUsagePerDay: Benutzerdefinierte Kontingente auf Projektebene beschränken die Gesamtnutzung aller Nutzer in diesem Projekt.

  • QueryUsagePerUserPerDay: Benutzerdefinierte Kontingente auf Nutzerebene werden separat auf alle Nutzer und Dienstkonten innerhalb eines Projekts angewendet. Unabhängig vom Limit pro Nutzer darf die Gesamtnutzung aller Nutzer im Projekt das Limit für die Abfragenutzung pro Tag nicht überschreiten.

Das Standardlimit für das Kontingent QueryUsagePerDay beträgt 200 Tebibyte (TiB) Datenverarbeitung pro Projekt und Tag. Das Standardlimit für QueryUsagePerUserPerDay ist unbegrenzt. Ihre aktuellen Limits finden Sie auf der Seite „Kontingente“. Sie können die Limits jederzeit ändern. Benutzerdefinierte Überschreibungen ersetzen die Standardlimits.

Kontingente für die Abfragenutzung gelten nur für das On-Demand-Preismodell für Abfragen.

Weitere Informationen zu den BigQuery-Kontingenten, die Sie festlegen können, finden Sie unter Kontingente und Limits.

Erforderliche Rolle

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle „Kontingentadministrator“ (role/servicemanagement.quotaAdmin) für Ihr Projekt zuzuweisen, um die Berechtigung zu erhalten, die Sie zum Ändern Ihres Kontingents benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierte Rolle enthält die Berechtigung serviceusage.quotas.update, die zum Ändern Ihres Kontingents erforderlich ist.

Sie können diese Berechtigung auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.

Benutzerdefinierte Kontingente festlegen oder ändern

Sie können für die Kontingente auf der Seite Kontingente und Systemlimits der Google Cloud Console ein benutzerdefiniertes Kontingent festlegen oder ein vorhandenes ändern. Wenn Sie ein niedrigeres Kontingent anfordern, wird die Änderung innerhalb weniger Minuten wirksam. Wenn Sie ein höheres Kontingent anfordern, wird Ihre Anfrage einen Genehmigungsprozess durchlaufen, was mehr Zeit in Anspruch nehmen kann. Weitere Informationen finden Sie unter Kontingentanpassung anfordern.

So legen Sie eine benutzerdefinierte Kostenkontrolle fest oder aktualisieren sie, z. B. um die Menge der BigQuery-Daten zu begrenzen, die pro Tag verarbeitet werden können:

  1. Öffnen Sie in der Google Cloud Console die Seite IAM & Verwaltung > Kontingente und Systemlimits:

    Zur Seite „Kontingente und Systemlimits“

  2. Verwenden Sie den Filter Dienst im Suchfeld Filter, um nach der BigQuery API zu filtern.

  3. Wählen Sie die Kontingente aus, die Sie anpassen möchten. Wenn Sie beispielsweise die Datenmenge begrenzen möchten, die pro Tag sowohl auf Projekt- als auch auf Nutzerebene abgefragt werden kann, wählen Sie Abfragenutzung pro Tag und Abfragenutzung pro Tag und Nutzer aus. Möglicherweise müssen Sie die Liste durchblättern, um sie zu finden. Nachdem Sie ein Kontingent ausgewählt haben, wird eine Symbolleiste angezeigt.

  4. Klicken Sie in der Symbolleiste auf  Bearbeiten. Das Dialogfeld Kontingentänderungen wird geöffnet.

  5. Wenn Unbegrenzt ausgewählt ist, heben Sie die Auswahl auf.

  6. Geben Sie den gewünschten Kontingentwert in TiB in das Feld Neuer Wert ein.

  7. Klicken Sie auf Fertig.

  8. Klicken Sie auf Anfrage senden.

Weitere Informationen zum Aufrufen und Verwalten von Kontingenten finden Sie unter Kontingente aufrufen und verwalten.

Zurückgegebene Fehlermeldungen

Wenn Sie ein benutzerdefiniertes Kontingent festgelegt haben, gibt BigQuery einen quotaExceeded-Fehler zurück, sobald das Kontingent überschritten wird. In der Nachricht wird das Kontingent genannt, das Sie überschritten haben: QueryUsagePerDay für ein benutzerdefiniertes Kontingent auf Projektebene oder QueryUsagePerUserPerDay für ein benutzerdefiniertes Kontingent auf Nutzerebene:

  • 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.

Informationen zum Diagnostizieren und Beheben dieser Fehler finden Sie unter Fehler bei benutzerdefinierten täglichen Abfragekontingenten beheben.

Beispiel

Angenommen, Sie legen folgende benutzerdefinierte Kontingente für ein Projekt mit 10 Nutzern fest, von denen eines ein Dienstkonto ist:

  • Projektebene: 50 TB pro Tag
  • Nutzerebene: 10 TB pro Tag

Benutzerdefinierte Kontingente auf Projektebene beschränken die Gesamtnutzung aller Nutzer in diesem Projekt. Benutzerdefinierte Kontingente auf Nutzerebene werden separat auf jeden Nutzer oder jedes Dienstkonto innerhalb eines Projekts angewendet.

In der folgenden Tabelle werden die verbleibenden Kontingente beschrieben, während die 10 Nutzer im Laufe des Tages Abfragen ausführen.

Verwendung Verbleibendes Kontingent
Jeder der 10 Nutzer fragt eine Datenmenge von 4 TB ab Projektebene: 10 TB verbleiben.
Nutzerebene: 6 TB pro Nutzer verbleiben, insgesamt jedoch nur bis zu 10 TB.
Das Dienstkonto fragt weitere 6 TB ab Projektebene: 4 TB verbleiben.
Nutzerebene:: Das Dienstkonto kann BigQuery nicht mehr verwenden. 6 TB pro Nutzer verbleiben für die anderen Nutzer, insgesamt jedoch nur bis zu 4 TB.
Ein Nutzer fragt weitere 4 TB ab Projektebene: 0 TB verbleiben.
Nutzerebene: Diverse TB verbleiben, aber BigQuery kann von niemandem mehr verwendet werden, weil das Kontingent auf Projektebene überschritten wurde.

Ohne verbleibendes Kontingent ist BigQuery für niemanden mehr in diesem Projekt verfügbar.

Nächste Schritte