Legacy-Slot-Zusicherungen kaufen und verwalten

Mit der BigQuery Reservations API können Sie dedizierte Slots (sogenannte Zusicherungen) kaufen und Slot-Pools erstellen (sogenannte Reservierungen) und diesen Reservierungen Projekte, Ordner und Organisationen zuweisen.

Eine Kapazitätszusicherung ist der Kauf einer BigQuery-Rechenkapazität für einen Mindestzeitraum. Der Kauf einer Kapazitätszusicherung ist beim Erstellen einer Reservierung mit einer Version optional, kann jedoch Kosteneinsparungen bieten.

Zusicherungen sind regionale Ressourcen. Die in einer bestimmten Region oder Multiregion erworbenen Zusicherungen können nicht in anderen Regionen oder Multiregionen verwendet werden. Zusicherungen können nicht zwischen Regionen oder zwischen Regionen und Multiregionen verschoben werden.

Reservations API aktivieren

Die BigQuery Reservation API unterscheidet sich von der vorhandenen BigQuery API und muss unabhängig aktiviert werden. Weitere Informationen finden Sie unter APIs aktivieren und deaktivieren.

Der Name der API lautet "BigQuery Reservations API".
Der Endpunkt für die BigQuery Reservation API ist bigqueryreservation.googleapis.com.

Slots erwerben

Wenn Sie die Kapazität für einen Mindestzeitraum reservieren möchten, können Sie eine Kapazitätszusicherung erwerben. Dies bietet einen Rabatt und spart Kosten. Weitere Informationen zu den spezifischen Kosten finden Sie unter BigQuery-Preise.

Erforderliche Berechtigungen

Zum Erstellen einer Kapazitätszusicherung benötigen Sie die folgende IAM-Berechtigung (Identity and Access Management):

bigquery.capacityCommitments.create für das Verwaltungsprojekt, das die Eigentumsrechte für die Zusicherungen verwaltet.

Jede der folgenden vordefinierten IAM-Rollen enthält diese Berechtigung:

BigQuery Admin
BigQuery Resource Admin

Weitere Informationen zu IAM-Rollen in BigQuery finden Sie unter Vordefinierte Rollen und Berechtigungen.

Kapazitätszusicherung erstellen

Console

Rufen Sie in der Google Cloud Console die Seite „BigQuery“ auf.

BigQuery aufrufen
Gehen Sie im Navigationsbereich zum Abschnitt Kapazitätsverwaltung.
Klicken Sie auf Zusicherung erstellen.
Unter Konfigurieren:
1. Wählen Sie den Standort aus.
2. Wählen Sie im Abschnitt Kapazitätsmodell das Kapazitätsmodell aus.
3. Wählen Sie die Zusicherungsdauer, die Ihren Zusicherungsplan bestimmt.
4. Wenn Sie eine Jährliche Zusicherung erwerben, wählen Sie den Verlängerungsplan aus, den Sie nach Ablauf der Zusicherung nutzen möchten:
  1. Nicht verlängern und in monatliche Zusicherung konvertieren (Standard). Nach Ablauf der jährlichen Zusicherung wird diese in eine monatliche Zusicherung umgewandelt.
  2. Jährliche Verlängerung. Nach Ablauf der jährlichen wird sie um ein weiteres Jahr als jährliche Zusicherung verlängert.
  3. Nicht verlängern und in Flex-Slots konvertieren. Nach Ablauf der jährlichen Zusicherung wird diese in eine Flex-Slot-Zusicherung umgewandelt.
  Weitere Informationen finden Sie unter Zusicherungen.
5. Geben Sie die Anzahl der Slots ein, die Sie erwerben möchten.
6. Klicken Sie auf Weiter.
Prüfen Sie die geschätzten Kosten für Ihren Kauf.
Gehen Sie unter Bestätigen und senden so vor:
1. Geben Sie BESTÄTIGEN ein, um den Kauf zu bestätigen.
2. Klicken Sie auf Kaufen, um die Slots zu erwerben.
Klicken Sie auf Slot-Zusicherungen anzeigen, um sich die Zusicherung anzeigen zu lassen. Nachdem die Kapazität bereitgestellt wurde, hat die angeforderte Kapazitätszusicherung einen grünen Status.

Hinweis: Slots werden normalerweise schnell bereitgestellt, in seltenen Fällen kann es jedoch mehrere Stunden dauern. Wenn Sie eine kritische Arbeitslast haben, bei der Sie eine erhöhte Nachfrage erwarten, reservieren Sie Slots mindestens einen Tag im Voraus.

Wenn Sie zum ersten Mal eine Kapazität erwerben, wird eine default-Reservierung erstellt.

SQL

Verwenden Sie zum Erstellen einer Kapazitätszusicherung die DDL-Anweisung CREATE CAPACITY.

Öffnen Sie in der Google Cloud Console die Seite BigQuery.

BigQuery aufrufen
Geben Sie im Abfrageeditor die folgende Anweisung ein:
```
CREATE CAPACITY
  `ADMIN_PROJECT_ID.region-LOCATION.COMMITMENT_ID`
OPTIONS (
  slot_count = NUMBER_OF_SLOTS,
  plan = 'PLAN_TYPE');
```
Dabei gilt:
- ADMIN_PROJECT_ID ist die Projekt-ID des Administrationsprojekts, dem die Zusicherung gehört.
- LOCATION: der Standort der Zusicherung
- COMMITMENT_ID: die ID der Zusicherung
  
  Sie muss für das Projekt und den Standort eindeutig sein. Sie muss mit einem Kleinbuchstaben oder einer Zahl beginnen und enden. Sie darf nur Kleinbuchstaben, Ziffern und Bindestriche enthalten.
- NUMBER_OF_SLOTS: die Anzahl der Slots, die gekauft werden sollen
- PLAN_TYPE: der Tariftyp, z. B. FLEX, MONTHLY oder ANNUAL
Klicken Sie auf Ausführen.

Informationen zum Ausführen von Abfragen finden Sie unter Interaktive Abfrage ausführen.

bq

Verwenden Sie den Befehl bq mk mit dem Flag --capacity_commitment, um Slots zu erwerben.

bq mk \
    --project_id=ADMIN_PROJECT_ID \
    --location=LOCATION \
    --capacity_commitment=true \
    --plan=PLAN_TYPE \
    --slots=NUMBER_OF_SLOTS

Dabei gilt:

ADMIN_PROJECT_ID: die Projekt-ID des Administrationsprojekts, dem die Zusicherung gehört
LOCATION: der Standort der Zusicherung
PLAN_TYPE: der Tariftyp, z. B. FLEX, MONTHLY oder ANNUAL.
NUMBER_OF_SLOTS: die Anzahl der Slots, die gekauft werden sollen.

Kapazitätszusicherungen anzeigen

Erforderliche Berechtigungen

Zum Aufrufen von Zusicherungen benötigen Sie folgende IAM-Berechtigung (Identity and Access Management):

bigquery.capacityCommitments.list für das Verwaltungsprojekt, das die Eigentumsrechte für die Zusicherungen verwaltet.

Jede der folgenden vordefinierten IAM-Rollen enthält diese Berechtigung:

BigQuery Admin
BigQuery Resource Admin
BigQuery Resource Editor
BigQuery Resource Viewer
BigQuery User

Weitere Informationen zu IAM-Rollen in BigQuery finden Sie unter Vordefinierte Rollen und Berechtigungen.

Kapazitätszusicherungen nach Projekt aufrufen

So rufen Sie Kapazitätszusicherungen nach Projekt auf:

Console

Rufen Sie in der Google Cloud Console die Seite „BigQuery“ auf.

BigQuery aufrufen
Gehen Sie im Navigationsbereich zum Abschnitt Kapazitätsverwaltung.
Klicken Sie auf den Tab Slot-Zusicherungen. Ihre Kapazitätszusicherungen werden in der Tabelle unter Zusicherungen aufgeführt.

SQL

Fragen Sie die Ansicht INFORMATION_SCHEMA.CAPACITY_COMMITMENTS_BY_PROJECT ab, wenn Sie die Zusicherungen für ein Administrationsprojekt aufrufen möchten.

Öffnen Sie in der Google Cloud Console die Seite BigQuery.

BigQuery aufrufen
Geben Sie im Abfrageeditor die folgende Anweisung ein:
```
SELECT
  capacity_commitment_id
FROM
  `region-LOCATION`.INFORMATION_SCHEMA.CAPACITY_COMMITMENTS_BY_PROJECT
WHERE
  project_id = 'ADMIN_PROJECT_ID'
  AND slot_count = 100;
```
Dabei gilt:
- LOCATION: der Standort der Zusicherungen
- ADMIN_PROJECT_ID: die Projekt-ID des Administrationsprojekts, dem die Zusicherungen gehören
Klicken Sie auf Ausführen.

Informationen zum Ausführen von Abfragen finden Sie unter Interaktive Abfrage ausführen.

bq

Verwenden Sie den Befehl bq ls mit dem Flag --capacity_commitment, um die Zusicherungen für ein Administrationsprojekt aufzulisten.

bq ls \
    --capacity_commitment=true \
    --location=LOCATION \
    --project_id=ADMIN_PROJECT_ID

Dabei gilt:

LOCATION: der Standort der Zusicherungen
ADMIN_PROJECT_ID: die Projekt-ID des Administrationsprojekts, dem die Zusicherungen gehören

Kapazitätszusicherungen aktualisieren

Sie können die folgenden Aktualisierungen an einer Kapazitätszusicherung vornehmen:

Eine bestehende Zusicherung verlängern
Zusicherung in einen Zusicherungstarif mit längerer Dauer umwandeln
Eine Zusicherung in zwei Zusicherungen aufteilen.
Führen Sie zwei Zusicherungen zu einer einzigen Zusicherung zusammen

Erforderliche Berechtigungen

Zum Aktualisieren von Kapazitätszusicherungen benötigen Sie die folgende IAM-Berechtigung (Identity and Access Management):

bigquery.capacityCommitments.update für das Verwaltungsprojekt, das die Eigentumsrechte für die Zusicherungen verwaltet.

Jede der folgenden vordefinierten IAM-Rollen enthält diese Berechtigung:

BigQuery Admin
BigQuery Resource Admin

Weitere Informationen zu IAM-Rollen in BigQuery finden Sie unter Vordefinierte Rollen und Berechtigungen.

Zusicherung verlängern

Jährliche Zusicherungen haben einen Verlängerungsplan, den Sie beim Erstellen oder Umwandeln in eine jährliche Zusicherung angeben. Sie können den Verlängerungsplan für die jährliche Zusicherung jederzeit vor dem Enddatum der Zusicherung ändern.

Console

So können Sie den Verlängerungsplan für eine jährliche Zusicherung ändern:

Rufen Sie in der Google Cloud Console die Seite „BigQuery“ auf.

BigQuery aufrufen
Gehen Sie im Navigationsbereich zum Abschnitt Kapazitätsverwaltung.
Klicken Sie auf den Tab Slot-Zusicherungen.
Suchen Sie die Zusicherung, die Sie bearbeiten möchten.
Klicken Sie auf Aktionen und wählen Sie die Option Abo bearbeiten aus.
Wählen Sie den neuen Verlängerungsplan aus.

bq

Wenn Sie das Preismodell für eine jährliche Zusicherung ändern möchten, verwenden Sie den Befehl bq update mit dem Flag --capacity_commitmentFlag und dem Flag --renewal_plan.

bq update \
    --project_id=ADMIN_PROJECT_ID \
    --location=LOCATION \
    --renewal_plan=PLAN_TYPE \
    --capacity_commitment=true \
    COMMITMENT_ID

Dabei gilt:

ADMIN_PROJECT_ID: die Projekt-ID des Administrationsprojekts, dem die Zusicherung gehört
LOCATION: der Standort der Zusicherung
PLAN_TYPE: der Tariftyp, z. B. FLEX, MONTHLY oder ANNUAL.
COMMITMENT_ID: die ID der Zusicherung

Die ID finden Sie unter Erworbene Zusicherungen ansehen.

Zusicherung in längere Dauer umwandeln

Sie können Ihre Zusicherung jederzeit in eine Zusicherung mit längerer Nutzungsdauer umwandeln.

Sie können Ihre Flex-Slot-Zusicherung in eine monatliche oder jährliche Zusicherung umwandeln.
Sie können Ihre monatliche Zusicherung in eine jährliche Zusicherung umwandeln.

Sobald Sie Ihre Zusicherung aktualisieren, wird Ihnen der mit dem neuen Plan verknüpfte Preis in Rechnung gestellt. Das Enddatum der Zusicherung wird zurückgesetzt.

Zum Konvertieren einer Zusicherung verwenden Sie den Befehl bq update mit dem Flag --plan.

bq update \
    --project_id=ADMIN_PROJECT_ID \
    --location=LOCATION \
    --plan=PLAN_TYPE \
    --renewal_plan=RENEWAL_PLAN \
    --capacity_commitment=true \
    COMMITMENT_ID

Dabei gilt:

ADMIN_PROJECT_ID: die Projekt-ID
LOCATION: der Standort der Zusicherung
PLAN_TYPE: der Tariftyp, z. B. FLEX, MONTHLY oder ANNUAL.
RENEWAL_PLAN: der verlängerte Tarif

Dies gilt nur, wenn PLAN_TYPE ANNUAL ist. Wenn PLAN_TYPE MONTHLY ist, lassen Sie dieses Flag weg.
COMMITMENT_ID: die ID der Zusicherung

Die ID finden Sie unter Erworbene Zusicherungen ansehen.

Zusicherung aufteilen

Sie können Ihre Zusicherung in zwei Zusicherungen aufteilen. Dies kann nützlich sein, wenn Sie einen Teil einer Zusicherung erneuern möchten. Beispiel: Wenn Sie eine jährliche Zusicherung von 1.000 Slots haben, können Sie 300 Slots in eine neue Zusicherung bewegen, sodass 700 Slots in der ursprünglichen Zusicherung verbleiben. Sie können dann 700 Slots zum Jahrestarif verlängern und nach dem Enddatum 300 Slots in Flex-Slots konvertieren.

Wenn Sie eine Zusicherung aufteilen, hat die neue Zusicherung denselben Plan und dasselbe Enddatum für die Zusicherung wie die ursprüngliche Zusicherung.

Console

Rufen Sie in der Google Cloud Console die Seite „BigQuery“ auf.

BigQuery aufrufen
Gehen Sie im Navigationsbereich zum Abschnitt Kapazitätsverwaltung.
Klicken Sie auf den Tab Slot-Zusicherungen.
Wählen Sie die Zusicherung aus, die Sie aufteilen möchten.
Klicken Sie auf Split.
Verwenden Sie auf der Seite Split commitment den Schieberegler Configure split, um festzulegen, aus wie vielen Slots jeder einzelne Split besteht, in Schritten von 100 Slots.
Klicken Sie auf Split, um die Zusicherung aufzuteilen. Die neue Zusicherung wird auf dem Tab Slot-Zusicherungen aufgeführt.

bq

Verwenden Sie den Befehl bq update, um Zusicherungen aufzuteilen.

bq update \
    --project_id=ADMIN_PROJECT_ID \
    --location=LOCATION \
    --split \
    --slots=SLOTS_TO_SPLIT \
    --capacity_commitment=true \
    COMMITMENT_ID

Dabei gilt:

ADMIN_PROJECT_ID: die Projekt-ID
LOCATION: der Standort der Zusicherung
SLOTS_TO_SPLIT: die Anzahl der Slots, die von der ursprünglichen Zusicherung in eine neue Zusicherung übernommen werden sollen
COMMITMENT_ID: die ID der Zusicherung

Die ID finden Sie unter Erworbene Zusicherungen ansehen.

Zwei Zusicherungen zusammenführen

Sie können mehrere Zusicherungen zu einer einzigen Zusicherung zusammenführen. Die zusammengeführten Zusicherungen müssen alle vom selben Typ sein (FLEX, MONTHLY, ANNUAL oder THREE_YEAR). Das Enddatum der kombinierten Zusicherung ist das späteste Enddatum der ursprünglichen Zusicherungen. Wenn eine der Zusicherungen ein früheres Enddatum hat, wird sie auf das spätere Datum verlängert. Ihnen wird ein anteiliger Betrag für diese Slots in Rechnung gestellt.

Console

Rufen Sie in der Google Cloud Console die Seite „BigQuery“ auf.

BigQuery aufrufen
Gehen Sie im Navigationsbereich zum Abschnitt Kapazitätsverwaltung.
Klicken Sie auf den Tab Slot-Zusicherungen.
Wählen Sie die Zusicherungen aus, die Sie zusammenführen möchten.
Klicken Sie auf Zusammenführen.
Prüfen Sie auf der Seite Commitments zusammenführen die Details der Zusammenführung und klicken Sie auf Zusammenführen. Die neue zusammengeführte Zusicherung ist auf dem Tab Slot-Zusicherungen aufgelistet.

bq

Verwenden Sie den Befehl bq update, um zwei Zusicherungen in einer Zusicherung zusammenzuführen:

bq update \
    --project_id=ADMIN_PROJECT_ID \
    --location=LOCATION \
    --merge=true \
    --capacity_commitment=true \
    COMMITMENT1,COMMITMENT2

Dabei gilt:

ADMIN_PROJECT_ID: die Projekt-ID
LOCATION: der Standort der Zusicherungen
COMMITMENT1: die erste zusammenzuführende Zusicherung
COMMITMENT2: die zweite zusammenzuführende Zusicherung

Zusicherung löschen

Sie können eine Kapazitätszusicherung löschen, wenn ihr Enddatum in der Vergangenheit liegt. Das Enddatum der Zusicherung wird in der Cloud Console angezeigt. Prüfen Sie vor dem Löschen einer Zusicherung, ob genügend freie Slots vorhanden sind. Ist dies nicht der Fall, müssen Sie die Anzahl der Slots in einer Reservierung verringern oder Reservierungen vollständig entfernen.

Erforderliche Berechtigungen

Zum Löschen von Kapazitätszusicherungen benötigen Sie die folgende IAM-Berechtigung (Identity and Access Management):

bigquery.capacityCommitments.delete für das Verwaltungsprojekt, das die Eigentumsrechte für die Zusicherungen verwaltet.

Jede der folgenden vordefinierten IAM-Rollen enthält diese Berechtigung:

BigQuery Admin
BigQuery Resource Admin

Weitere Informationen zu IAM-Rollen in BigQuery finden Sie unter Vordefinierte Rollen und Berechtigungen.

Kapazitätszusicherung löschen

Console

Führen Sie die folgenden Schritte aus, um eine Kapazitätszusicherung zu löschen:

Rufen Sie in der Google Cloud Console die Seite „BigQuery“ auf.

BigQuery aufrufen
Gehen Sie im Navigationsbereich zum Abschnitt Kapazitätsverwaltung.
Klicken Sie auf den Tab Slot-Zusicherungen.
Wählen Sie in der Drop-down-Liste Standort den passenden Standort aus.
Suchen Sie die Zusicherung, die Sie löschen möchten.
Maximieren Sie die Option Aktionen.
Klicken Sie auf Löschen.
Geben Sie „REMOVE” ein und klicken Sie auf Weiter.

SQL

Verwenden Sie zum Löschen einer Kapazitätszusicherung die DDL-Anweisung DROP CAPACITY.

Öffnen Sie in der Google Cloud Console die Seite BigQuery.

BigQuery aufrufen
Geben Sie im Abfrageeditor die folgende Anweisung ein:
```
DROP CAPACITY
  `ADMIN_PROJECT_ID.region-LOCATION.COMMITMENT_ID`;
```
Dabei gilt:
- ADMIN_PROJECT_ID: das Projekt, zu dem die Zusicherung gehört
- LOCATION: der Standort der Zusicherung
- COMMITMENT_ID: die ID der Zusicherung
  
  Die ID finden Sie unter Erworbene Zusicherungen ansehen.
Klicken Sie auf Ausführen.

Informationen zum Ausführen von Abfragen finden Sie unter Interaktive Abfrage ausführen.

bq

Verwenden Sie zum Löschen einer Kapazitätszusicherung den Befehl bq rm mit dem Flag --capacity_commitment:

bq rm \
    --project_id=ADMIN_PROJECT_ID \
    --location=LOCATION \
    --capacity_commitment=true \
    COMMITMENT_ID

Dabei gilt:

ADMIN_PROJECT_ID: die Projekt-ID
LOCATION: der Standort der Zusicherung
COMMITMENT_ID: die ID der Zusicherung, die Sie löschen möchten

Die ID finden Sie unter Erworbene Zusicherungen ansehen.

Fehlerbehebung bei Kapazitätszusicherungen

In diesem Abschnitt werden Schritte zur Fehlerbehebung beschrieben, die bei Problemen mit BigQuery-Reservierungen hilfreich sein können.

Erworbene Slots stehen aus

Slots unterliegen der verfügbaren Kapazität. Wenn Sie Slot-Zusicherungen erwerben und BigQuery diese zuweist, wird in der Spalte Status ein Häkchen angezeigt. Wenn BigQuery die angeforderten Slots nicht sofort zuweisen kann, bleibt die Spalte Status auf „Ausstehend“. Möglicherweise müssen Sie einige Stunden warten, bis die Slots verfügbar sind. Wenn Sie früher Zugriff auf Slots benötigen, versuchen Sie Folgendes:

Löschen Sie die ausstehende Zusicherung.
Erwerben Sie eine neue Zusicherung für eine kleinere Anzahl von Slots. Je nach Kapazität wird die kleinere Zusicherung möglicherweise sofort aktiviert.
Erwerben Sie die übrigen Slots als separate Zusicherung. Diese Slots werden in der Spalte Status möglicherweise als „Ausstehend“ angezeigt, sind aber in der Regel innerhalb weniger Stunden aktiv.
Optional: Wenn beide Zusicherungen verfügbar sind, können Sie sie in einer einzigen Zusicherung zusammenführen, sofern Sie für beide Abos denselben Tarif erworben haben.

Wenn eine Slot-Zusicherung fehlschlägt oder sehr lange dauert, sollten Sie eventuell On-Demand-Preise in Betracht ziehen. Bei dieser Lösung müssen Sie möglicherweise wichtige Abfragen in einem anderen Projekt ausführen, das keinen Reservierungen zugewiesen ist, oder Sie müssen die Projektzuweisung vollständig entfernen.