Mit Slot-Reservierungen arbeiten

Console

1. Rufen Sie in der Cloud de Confiance Console die Seite "BigQuery" auf.

   BigQuery aufrufen

2. Klicken Sie im Navigationsmenü auf Kapazitätsverwaltung.

3. Klicken Sie auf Reservierung erstellen.

4. Geben Sie im Feld Name der Reservierung einen Namen für die Reservierung ein.

5. Wählen Sie in der Liste Standort einen Standort aus. Wenn Sie einen BigQuery Omni-Standort auswählen, ist Ihre Versionsoption auf die Enterprise-Version beschränkt.

6. Wählen Sie in der Liste Edition die Ausgabe aus. BigQuery-Versionsfunktionen wie Autoscaling sind nur innerhalb einer Version verfügbar. Weitere Informationen finden Sie unter Einführung in BigQuery-Versionen.

7. Wählen Sie in der Liste Maximale Reservierungsgröße die maximale Reservierungsgröße aus.

8. Optional: Geben Sie im Feld Referenz-Slots die Anzahl der Referenz-Slots für die Reservierung ein.

   Die Anzahl der verfügbaren Autoscaling-Slots wird bestimmt, indem der Wert für Referenz-Slots vom Wert für Maximale Reservierungsgröße abgezogen wird. Wenn Sie beispielsweise eine Reservierung mit 100 Referenz-Slots und einer maximalen Reservierungsgröße von 400 erstellen, hat Ihre Reservierung 300 Autoscaling-Slots. Weitere Informationen zu Referenz-Slots finden Sie unter Reservierungen mit Slots für Referenz und Autoscaling verwenden.

9. Wenn Sie die Freigabe inaktiver Slots deaktivieren und nur die angegebene Slotkapazität verwenden möchten, klicken Sie auf die Schaltfläche Inaktive Slots ignorieren.

10. Klicken Sie zum Erweitern des Abschnitts Erweiterte Einstellungen auf den expand_moreErweiterungspfeil.

11. Optional: Um die Zielnebenläufigkeit von Jobs festzulegen, klicken und aktivieren Sie die Schaltfläche Automatische Zielnebenläufigkeit von Jobs überschreiben und geben Sie die Zielnebenläufigkeit von Jobs ein.

12. Die Aufschlüsselung der Slots wird in der Tabelle Kostenschätzung angezeigt. In der Tabelle Kapazitätsübersicht wird eine Zusammenfassung der Reservierung angezeigt.

13. Klicken Sie auf Speichern.

Die neue Reservierung ist auf dem Tab Slot-Reservierungen zu sehen.

SQL

Verwenden Sie zum Erstellen einer Reservierung die DDL-Anweisung CREATE RESERVATION.

1. Öffnen Sie in der Cloud de Confiance Console die Seite BigQuery.

   BigQuery aufrufen

2. Geben Sie im Abfrageeditor die folgende Anweisung ein:

   CREATE RESERVATION
     `ADMIN_PROJECT_ID.region-LOCATION.RESERVATION_NAME`
   OPTIONS (
     slot_capacity = NUMBER_OF_BASELINE_SLOTS,
     edition = EDITION,
     autoscale_max_slots = NUMBER_OF_AUTOSCALING_SLOTS);

   Ersetzen Sie Folgendes:

   • ADMIN_PROJECT_ID: die Projekt-ID des Administrationsprojekts, dem die Reservierungsressource gehört
   • LOCATION: Der Standort der Reservierung. Wenn Sie einen BigQuery Omni-Standort auswählen, ist Ihre Versionsoption auf die Enterprise-Version beschränkt.

   • RESERVATION_NAME: der Name der Reservierung

     Der Name darf nur alphanumerische Zeichen in Kleinschreibung oder Bindestriche enthalten, muss mit einem Buchstaben beginnen und darf nicht mit einem Bindestrich enden. Die maximale Länge beträgt 64 Zeichen.

   • NUMBER_OF_BASELINE_SLOTS: die Anzahl der Basisslots, die dieser Reservierung zugewiesen werden sollen Sie können die Optionen slot_capacity und edition nicht in derselben Reservierung festlegen.
   • EDITION: die Version der Reservierung. Wenn Sie einer Ausgabe eine Reservierung zuweisen, ändern sich die Funktion und die Preise. Weitere Informationen finden Sie unter Einführung in BigQuery-Editing.
   • NUMBER_OF_AUTOSCALING_SLOTS: die Anzahl der Autoscaling-Slots, die der Reservierung zugewiesen sind. Dieser Wert entspricht dem Wert der maximalen Reservierungsgröße abzüglich der Anzahl der Referenzslots.

3. Klicken Sie auf play_circle Ausführen.

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

bq

Verwenden Sie zum Erstellen einer Reservierung den Befehl bq mk mit dem Flag --reservation:

bq mk \
    --project_id=ADMIN_PROJECT_ID \
    --location=LOCATION \
    --reservation \
    --slots=NUMBER_OF_BASELINE_SLOTS \
    --ignore_idle_slots=false \
    --edition=EDITION \
    --autoscale_max_slots=NUMBER_OF_AUTOSCALING_SLOTS \
    --max_slots=MAXIMUM_NUMBER_OF_SLOTS
    --scaling_mode=SCALING_MODE
    RESERVATION_NAME

Dabei gilt:

• ADMIN_PROJECT_ID: die Projekt-ID
• LOCATION: Der Standort der Reservierung. Wenn Sie einen BigQuery Omni-Standort auswählen, ist Ihre Versionsoption auf die Enterprise-Version beschränkt.

• NUMBER_OF_BASELINE_SLOTS: die Anzahl der Basisslots, die dieser Reservierung zugewiesen werden sollen

• RESERVATION_NAME: der Name der Reservierung. Der Name darf nur alphanumerische Zeichen in Kleinschreibung oder Bindestriche enthalten, muss mit einem Buchstaben beginnen und darf nicht mit einem Bindestrich enden. Die maximale Länge beträgt 64 Zeichen.

• EDITION: die Version der Reservierung. Wenn Sie einer Ausgabe eine Reservierung zuweisen, ändern sich die Funktion und die Preise. Weitere Informationen finden Sie unter Einführung in BigQuery-Editing.

• NUMBER_OF_AUTOSCALING_SLOTS: die Anzahl der Autoscaling-Slots, die der Reservierung zugewiesen sind. Dieser Wert entspricht dem Wert der maximalen Reservierungsgröße abzüglich der Anzahl der Referenzslots. Dies kann nicht mit den Flags --max_slots oder --scaling_mode konfiguriert werden.

• MAXIMUM_NUMBER_OF_SLOTS: die maximale Anzahl an Slots, die die Reservierung nutzen kann. Dieser Wert muss mit dem Flag --scaling_mode konfiguriert werden (Vorabversion).

• SCALING_MODE: Der Skalierungsmodus der Reservierung. Die Optionen sind ALL_SLOTS, IDLE_SLOTS_ONLY oder AUTOSCALE_ONLY. Dieser Wert muss mit dem Flag --scaling_mode konfiguriert werden (Vorabversion).

Weitere Informationen zum Flag --ignore_idle_slots finden Sie unter Inaktive Slots. Der Standardwert ist false.

Terraform

Verwenden Sie die Ressource google_bigquery_reservation:

Richten Sie zur Authentifizierung bei BigQuery die Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.

Im folgenden Beispiel wird eine Reservierung mit dem Namen my-reservation erstellt:

resource "google_bigquery_reservation" "default" {
  name              = "my-reservation"
  location          = "us-central1"
  slot_capacity     = 100
  edition           = "ENTERPRISE"
  ignore_idle_slots = false # Use idle slots from other reservations
  concurrency       = 0     # Automatically adjust query concurrency based on available resources
  autoscale {
    max_slots = 200 # Allow the reservation to scale up to 300 slots (slot_capacity + max_slots) if needed
  }
}

Führen Sie die Schritte in den folgenden Abschnitten aus, um Ihre Terraform-Konfiguration auf ein Cloud de Confiance -Projekt anzuwenden.

Cloud Shell vorbereiten

1. Rufen Sie Cloud Shell auf.

2. Legen Sie das Standardprojekt Cloud de Confiance fest, auf das Sie Ihre Terraform-Konfigurationen anwenden möchten.

   Sie müssen diesen Befehl nur einmal pro Projekt und in jedem beliebigen Verzeichnis ausführen.

   export GOOGLE_CLOUD_PROJECT=PROJECT_ID

   Umgebungsvariablen werden überschrieben, wenn Sie in der Terraform-Konfigurationsdatei explizite Werte festlegen.

Verzeichnis vorbereiten

Jede Terraform-Konfigurationsdatei muss ein eigenes Verzeichnis haben (auch als Stammmodul bezeichnet).

1. Erstellen Sie in Cloud Shell ein Verzeichnis und eine neue Datei in diesem Verzeichnis. Der Dateiname muss die Erweiterung .tf haben, z. B. main.tf. In dieser Anleitung wird die Datei als main.tf bezeichnet.

   mkdir DIRECTORY && cd DIRECTORY && touch main.tf

2. Wenn Sie einer Anleitung folgen, können Sie den Beispielcode in jedem Abschnitt oder Schritt kopieren.

   Kopieren Sie den Beispielcode in das neu erstellte main.tf.

   Kopieren Sie optional den Code aus GitHub. Dies wird empfohlen, wenn das Terraform-Snippet Teil einer End-to-End-Lösung ist.

3. Prüfen und ändern Sie die Beispielparameter, die auf Ihre Umgebung angewendet werden sollen.
4. Speichern Sie die Änderungen.
5. Initialisieren Sie Terraform. Dies ist nur einmal für jedes Verzeichnis erforderlich.

   terraform init

   Fügen Sie optional die Option -upgrade ein, um die neueste Google-Anbieterversion zu verwenden:

   terraform init -upgrade

Änderungen anwenden

1. Prüfen Sie die Konfiguration und prüfen Sie, ob die Ressourcen, die Terraform erstellen oder aktualisieren wird, Ihren Erwartungen entsprechen:

   terraform plan

   Korrigieren Sie die Konfiguration nach Bedarf.

2. Wenden Sie die Terraform-Konfiguration an. Führen Sie dazu den folgenden Befehl aus und geben Sie yes an der Eingabeaufforderung ein:

   terraform apply

   Warten Sie, bis Terraform die Meldung „Apply complete“ anzeigt.

3. Öffnen Sie Ihr Cloud de Confiance Projekt, um die Ergebnisse aufzurufen. Rufen Sie in der Cloud de Confiance Console Ihre Ressourcen in der Benutzeroberfläche auf, um sicherzustellen, dass Terraform sie erstellt oder aktualisiert hat.

Python

# TODO(developer): Set project_id to the project ID containing the
# reservation.
project_id = "your-project-id"

# TODO(developer): Set location to the location of the reservation.
# See: https://cloud.google.com/bigquery/docs/locations for a list of
# available locations.
location = "US"

# TODO(developer): Set reservation_id to a unique ID of the reservation.
reservation_id = "sample-reservation"

# TODO(developer): Set slot_capicity to the number of slots in the
# reservation.
slot_capacity = 100

# TODO(developer): Choose a transport to use. Either 'grpc' or 'rest'
transport = "grpc"

# ...

from google.cloud.bigquery_reservation_v1.services import reservation_service
from google.cloud.bigquery_reservation_v1.types import (
    reservation as reservation_types,
)

reservation_client = reservation_service.ReservationServiceClient(
    transport=transport
)

parent = reservation_client.common_location_path(project_id, location)

reservation = reservation_types.Reservation(slot_capacity=slot_capacity)
reservation = reservation_client.create_reservation(
    parent=parent,
    reservation=reservation,
    reservation_id=reservation_id,
)

print(f"Created reservation: {reservation.name}")

Console

1. Rufen Sie in der Cloud de Confiance Console die Seite "BigQuery" auf.

   BigQuery aufrufen

2. Rufen Sie im Navigationsbereich den Abschnitt Kapazitätsverwaltung auf und klicken Sie dann auf Reservierung erstellen.

3. Geben Sie im Feld Name der Reservierung einen Namen für die Reservierung ein.

4. Wählen Sie in der Liste Standort einen Standort aus. Wenn Sie einen BigQuery Omni-Standort auswählen, ist Ihre Versionsoption auf die Enterprise-Version beschränkt.

5. Wählen Sie in der Liste Edition die Ausgabe aus. Autoscaling ist nur innerhalb einer Version verfügbar. Weitere Informationen finden Sie unter Informationen zu BigQuery-Versionen.

6. Wählen Sie in der Liste Maximale Reservierungsgröße die maximale Reservierungsgröße aus.

7. Optional: Geben Sie im Feld Referenz-Slots die Anzahl der Referenz-Slots für die Reservierung ein.

   Die Anzahl der verfügbaren Autoscaling-Slots wird bestimmt, indem der Wert für Referenz-Slots vom Wert für Maximale Reservierungsgröße abgezogen wird. Wenn Sie beispielsweise eine Reservierung mit 100 Referenz-Slots und einer maximalen Reservierungsgröße von 400 erstellen, hat Ihre Reservierung 300 Autoscaling-Slots. Weitere Informationen zu Referenz-Slots finden Sie unter Reservierungen mit Slots für Referenz und Autoscaling verwenden.

8. Wenn Sie die Freigabe inaktiver Slots deaktivieren und nur die angegebene Slotkapazität verwenden möchten, klicken Sie auf die Schaltfläche Inaktive Slots ignorieren.

9. Klicken Sie zum Erweitern des Abschnitts Erweiterte Einstellungen auf den expand_moreErweiterungspfeil.

   1. Wählen Sie in der Liste Wie werden inaktive Slots verwendet? die Konfigurationsoption aus.

10. Die Aufschlüsselung der Slots wird in der Tabelle Kostenschätzung angezeigt. In der Tabelle Kapazitätsübersicht wird eine Zusammenfassung der Reservierung angezeigt.

11. Klicken Sie auf Speichern.

Die neue Reservierung ist auf dem Tab Slot-Reservierungen zu sehen.

bq

Verwenden Sie zum Erstellen einer vorhersagbaren Reservierung den Befehl bq mk mit dem Flag --reservation und legen Sie die Werte für max_slots und scaling_mode fest:

bq mk \
    --project_id=ADMIN_PROJECT_ID \
    --location=LOCATION \
    --reservation \
    --slots=NUMBER_OF_BASELINE_SLOTS \
    --ignore_idle_slots=false \
    --edition=EDITION \
    --max_slots=MAXIMUM_NUMBER_OF_SLOTS \
    --scaling_mode=SCALING_MODE
    RESERVATION_NAME

Ersetzen Sie Folgendes:

• ADMIN_PROJECT_ID: die Projekt-ID
• LOCATION: Der Standort der Reservierung. Wenn Sie einen BigQuery Omni-Standort auswählen, ist Ihre Versionsoption auf die Enterprise-Version beschränkt.

• NUMBER_OF_BASELINE_SLOTS: die Anzahl der Basisslots, die dieser Reservierung zugewiesen werden sollen

• RESERVATION_NAME: der Name der Reservierung

• EDITION: die Version der Reservierung. Wenn Sie einer Ausgabe eine Reservierung zuweisen, ändern sich die Funktion und die Preise. Weitere Informationen finden Sie unter Einführung in BigQuery-Editing.

• MAXIMUM_NUMBER_OF_SLOTS: die maximale Anzahl an Slots, die die Reservierung nutzen kann. Dieser Wert muss mit dem Flag --scaling_mode konfiguriert werden.

• SCALING_MODE: SCALING_MODE: Der Skalierungsmodus der Reservierung. Die Optionen sind ALL_SLOTS, IDLE_SLOTS_ONLY oder AUTOSCALE_ONLY. Dieser Wert muss mit dem Flag max_slots konfiguriert werden. Dieser Wert muss mit dem Flag ignore_idle_slots übereinstimmen. Weitere Informationen finden Sie unter Vorhersagbarkeit von Reservierungen.

Weitere Informationen zum Flag --ignore_idle_slots finden Sie unter Inaktive Slots. Der Standardwert ist false.

SQL

Verwenden Sie zum Erstellen einer vorhersagbaren Reservierung die DDL-Anweisung CREATE RESERVATION.

1. Öffnen Sie in der Cloud de Confiance Console die Seite BigQuery.

   BigQuery aufrufen

2. Geben Sie im Abfrageeditor die folgende Anweisung ein:

   CREATE RESERVATION
     `ADMIN_PROJECT_ID.region-LOCATION.RESERVATION_NAME`
   OPTIONS (
     slot_capacity = NUMBER_OF_BASELINE_SLOTS,
     edition = EDITION,
     ignore_idle_slots=IGNORE_IDLE_SLOTS
     max_slots = MAX_NUMBER_OF_SLOTS,
     scaling_mode = SCALING_MODE);

   Ersetzen Sie Folgendes:

   • ADMIN_PROJECT_ID: die Projekt-ID des Administrationsprojekts, dem die Reservierungsressource gehört
   • LOCATION: Der Standort der Reservierung. Wenn Sie einen BigQuery Omni-Standort auswählen, ist Ihre Versionsoption auf die Enterprise-Version beschränkt.

   • RESERVATION_NAME: Der Name der Reservierung. Der Name darf nur alphanumerische Zeichen in Kleinschreibung oder Bindestriche enthalten. Er muss mit einem Buchstaben beginnen und darf nicht mit einem Bindestrich enden. Die maximale Länge beträgt 64 Zeichen.

   • NUMBER_OF_BASELINE_SLOTS: die Anzahl der Basisslots, die dieser Reservierung zugewiesen werden sollen Sie können die Optionen slot_capacity und edition nicht in derselben Reservierung festlegen.
   • EDITION: die Version der Reservierung. Wenn Sie einer Ausgabe eine Reservierung zuweisen, ändern sich die Funktion und die Preise. Weitere Informationen finden Sie unter Einführung in BigQuery-Versionen.
   • IGNORE_IDLE_SLOTS: Gibt an, ob die Reservierung inaktive Slots verwendet. Der Standardwert ist false.
   • MAX_NUMBER_OF_SLOTS: die maximale Anzahl an Slots, die die Reservierung nutzen kann. Dieser Wert muss mit der Option scaling_mode konfiguriert werden.
   • SCALING_MODE: Der Skalierungsmodus der Reservierung. Die Optionen sind ALL_SLOTS, IDLE_SLOTS_ONLY oder AUTOSCALE_ONLY. Dieser Wert muss mit der Option max_slots konfiguriert werden. Dieser Wert muss mit der Option ignore_idle_slots übereinstimmen. Weitere Informationen finden Sie unter Vorhersagbarkeit von Reservierungen.

3. Klicken Sie auf play_circle Ausführen.

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

Console

1. Rufen Sie in der Cloud de Confiance Console die Seite "BigQuery" auf.

   BigQuery aufrufen

2. Klicken Sie im Navigationsmenü auf Kapazitätsverwaltung.

3. Klicken Sie auf den Tab Slot-Reservierungen.

4. Suchen Sie die Reservierung, die Sie aktualisieren möchten.

5. Maximieren Sie die Option more_vert Aktionen.

6. Klicken Sie auf Bearbeiten.

7. Geben Sie im Dialogfeld Maximale Reservierungsgröße auswählen die maximale Reservierungsgröße ein.

8. Geben Sie im Feld Referenz-Slots die Anzahl der Referenz-Slots ein.

9. Klicken Sie zum Erweitern des Abschnitts Erweiterte Einstellungen auf den expand_moreErweiterungspfeil.

10. Optional: Um die Zielnebenläufigkeit von Jobs festzulegen, klicken und aktivieren Sie die Schaltfläche Automatische Zielnebenläufigkeit von Jobs überschreiben und geben Sie die Zielnebenläufigkeit von Jobs ein.

11. Klicken Sie auf Speichern.

SQL

Verwenden Sie die DDL-Anweisung ALTER RESERVATION SET OPTIONS, um die Größe einer Reservierung zu ändern.

1. Öffnen Sie in der Cloud de Confiance Console die Seite BigQuery.

   BigQuery aufrufen

2. Geben Sie im Abfrageeditor die folgende Anweisung ein:

   ALTER RESERVATION
     `ADMIN_PROJECT_ID.region-LOCATION.RESERVATION_NAME`
   SET OPTIONS (
     slot_capacity = NUMBER_OF_BASELINE_SLOTS,
     autoscale_max_slots = NUMBER_OF_AUTOSCALING_SLOTS);

   Ersetzen Sie Folgendes:

   • ADMIN_PROJECT_ID: die Projekt-ID des Administrationsprojekts, dem die Reservierungsressource gehört
   • LOCATION: der Standort der Reservierung, z. B. europe-west9.

   • RESERVATION_NAME: der Name der Reservierung Der Name darf nur alphanumerische Zeichen in Kleinschreibung oder Bindestriche enthalten, muss mit einem Buchstaben beginnen und darf nicht mit einem Bindestrich enden. Die maximale Länge beträgt 64 Zeichen.

   • NUMBER_OF_BASELINE_SLOTS: die Anzahl der Slots, die der Reservierung zugewiesen werden sollen.
   • NUMBER_OF_AUTOSCALING_SLOTS: die Anzahl der Autoscaling-Slots, die der Reservierung zugewiesen sind. Dieser Wert entspricht dem Wert der maximalen Reservierungsgröße abzüglich der Anzahl der Referenzslots.

3. Klicken Sie auf play_circle Ausführen.

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

bq

Verwenden Sie den Befehl bq update mit dem Flag --reservation, um die Größe einer Reservierung zu aktualisieren:

bq update \
    --project_id=ADMIN_PROJECT_ID \
    --location=LOCATION \
    --slots=NUMBER_OF_BASELINE_SLOTS \
    --autoscale_max_slots=NUMBER_OF_AUTOSCALING_SLOTS \
    --reservation RESERVATION_NAME

Dabei gilt:

• ADMIN_PROJECT_ID: die Projekt-ID
• LOCATION: der Standort der Reservierung
• NUMBER_OF_BASELINE_SLOTS: die Anzahl der Basisslots, die dieser Reservierung zugewiesen werden sollen
• RESERVATION_NAME: der Name der Reservierung. Der Name darf nur alphanumerische Zeichen in Kleinschreibung oder Bindestriche enthalten, muss mit einem Buchstaben beginnen und darf nicht mit einem Bindestrich enden. Die maximale Länge beträgt 64 Zeichen.
• NUMBER_OF_AUTOSCALING_SLOTS: die Anzahl der Autoscaling-Slots, die der Reservierung zugewiesen sind. Dieser Wert entspricht dem Wert der maximalen Reservierungsgröße abzüglich der Anzahl der Referenzslots.

Python

# TODO(developer): Set project_id to the project ID containing the
# reservation.
project_id = "your-project-id"

# TODO(developer): Set location to the location of the reservation.
# See: https://cloud.google.com/bigquery/docs/locations for a list of
# available locations.
location = "US"

# TODO(developer): Set reservation_id to a unique ID of the reservation.
reservation_id = "sample-reservation"

# TODO(developer): Set slot_capicity to the new number of slots in the
# reservation.
slot_capacity = 50

# TODO(developer): Choose a transport to use. Either 'grpc' or 'rest'
transport = "grpc"

# ...

from google.cloud.bigquery_reservation_v1.services import reservation_service
from google.cloud.bigquery_reservation_v1.types import (
    reservation as reservation_types,
)
from google.protobuf import field_mask_pb2

reservation_client = reservation_service.ReservationServiceClient(
    transport=transport
)

reservation_name = reservation_client.reservation_path(
    project_id, location, reservation_id
)
reservation = reservation_types.Reservation(
    name=reservation_name,
    slot_capacity=slot_capacity,
)
field_mask = field_mask_pb2.FieldMask(paths=["slot_capacity"])
reservation = reservation_client.update_reservation(
    reservation=reservation, update_mask=field_mask
)

print(f"Updated reservation: {reservation.name}")
print(f"\tslot_capacity: {reservation.slot_capacity}")

SQL

Fragen Sie die Spalte ignore_idle_slots der Ansicht INFORMATION_SCHEMA.RESERVATIONS_BY_PROJECT ab.

1. Öffnen Sie in der Cloud de Confiance Console die Seite BigQuery.

   BigQuery aufrufen

2. Geben Sie im Abfrageeditor die folgende Anweisung ein:

   SELECT
     reservation_name,
     ignore_idle_slots
   FROM
     `ADMIN_PROJECT_ID.region-LOCATION`.INFORMATION_SCHEMA.RESERVATIONS_BY_PROJECT;

   Dabei gilt:

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

3. Klicken Sie auf play_circle Ausführen.

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

bq

Führen Sie den Befehl bq ls mit dem Flag --reservation aus:

bq ls --reservation \
    --project_id=ADMIN_PROJECT_ID \
    --location=LOCATION

Dabei gilt:

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

Das Feld ignoreIdleSlots enthält die Konfigurationseinstellung.

Console

1. Rufen Sie in der Cloud de Confiance Console die Seite "BigQuery" auf.

   BigQuery aufrufen

2. Klicken Sie im Navigationsmenü auf Kapazitätsverwaltung.

3. Klicken Sie auf den Tab Reservierungen.

4. Suchen Sie die Reservierung, die Sie löschen möchten.

5. Maximieren Sie die Option more_vert Aktionen.

6. Klicken Sie auf Löschen.

7. Klicken Sie im Dialogfeld Reservierung löschen auf Löschen.

SQL

Verwenden Sie die DDL-Anweisung DROP RESERVATION, um eine Reservierung zu löschen.

1. Öffnen Sie in der Cloud de Confiance Console die Seite BigQuery.

   BigQuery aufrufen

2. Geben Sie im Abfrageeditor die folgende Anweisung ein:

   DROP RESERVATION
     `ADMIN_PROJECT_ID.region-LOCATION.RESERVATION_NAME`;

   Ersetzen Sie Folgendes:

   • ADMIN_PROJECT_ID: die Projekt-ID des Administrationsprojekts, dem die Reservierungsressource gehört
   • LOCATION: der Standort der Reservierung
   • RESERVATION_NAME: die ID der Reservierung

3. Klicken Sie auf play_circle Ausführen.

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

bq

Verwenden Sie zum Löschen einer Reservierung den Befehl bq rm mit dem Flag --reservation:

bq rm \
    --project_id=ADMIN_PROJECT_ID \
    --location=LOCATION \
    --reservation RESERVATION_NAME

Dabei gilt:

• ADMIN_PROJECT_ID: die Projekt-ID des Administrationsprojekts, dem die Reservierungsressource gehört
• LOCATION: der Standort der Reservierung
• RESERVATION_NAME: der Name der Reservierung. Der Name darf nur alphanumerische Zeichen in Kleinschreibung oder Bindestriche enthalten, muss mit einem Buchstaben beginnen und darf nicht mit einem Bindestrich enden. Die maximale Länge beträgt 64 Zeichen.

Python

# TODO(developer): Set project_id to the project ID containing the
# reservation.
project_id = "your-project-id"

# TODO(developer): Set location to the location of the reservation.
# See: https://cloud.google.com/bigquery/docs/locations for a list of
# available locations.
location = "US"

# TODO(developer): Set reservation_id to a unique ID of the reservation.
reservation_id = "sample-reservation"

# TODO(developer): Choose a transport to use. Either 'grpc' or 'rest'
transport = "grpc"

# ...

from google.cloud.bigquery_reservation_v1.services import reservation_service

reservation_client = reservation_service.ReservationServiceClient(
    transport=transport
)
reservation_name = reservation_client.reservation_path(
    project_id, location, reservation_id
)
reservation_client.delete_reservation(name=reservation_name)

print(f"Deleted reservation: {reservation_name}")

Console

In der Cloud de Confiance Console können Sie den Zugriff auf mehrere Reservierungsressourcen über eine Bedingung zulassen.

1. Rufen Sie in der Cloud de Confiance Console die Seite IAM auf.

   IAM aufrufen

2. Wählen Sie ein Projekt, einen Ordner oder eine Organisation aus.

3. So weisen Sie einem Hauptkonto, das eine Rolle für die Reservierungsressourcen hat, die Rolle bigquery.resourceEditor zu:

   1. Rufen Sie auf dem Tab Nach Hauptkonten ansehen das entsprechende Hauptkonto auf oder verwenden Sie die Option Filter, um das Hauptkonto zu finden.

   2. Klicken Sie auf edit Hauptkonto bearbeiten.

   3. Klicken Sie auf der Seite Rollen zuweisen auf add Rollen hinzufügen.

   4. Geben Sie im Feld Nach Rollen suchen bigquery.resourceEditor ein.

   5. Klicken Sie in den Suchergebnissen auf die Option BigQuery Resource Editor und dann auf Anwenden.

   6. Klicken Sie auf Speichern.

4. Alternativ können Sie einem Hauptkonto, das keine Rolle für die Reservierungsressourcen hat, die Rolle bigquery.resourceEditor zuweisen:

   1. Klicken Sie auf person_addZugriff gewähren.

   2. Geben Sie auf der Seite Hauptkonten hinzufügen im Feld Neue Hauptkonten die Kennung des Hauptkontos ein, z. B. //iam.googleapis.com/locations/global/workforcePools/my-pool/subject/my-user@example.com.

   3. Klicken Sie auf add Rollen hinzufügen.

   4. Geben Sie im Feld Nach Rollen suchen bigquery.resourceEditor ein.

   5. Klicken Sie in den Suchergebnissen auf die Option BigQuery Resource Editor und dann auf Anwenden.

   6. Klicken Sie im Feld BigQuery-Ressourcen-Editor auf Bedingung hinzufügen.

   7. Führen Sie auf der Seite Bedingung hinzufügen die folgenden Schritte aus:

      1. Geben Sie Werte in die Felder Titel und Beschreibung ein.

      2. Fügen Sie im Tool zur Bedingungserstellung die Bedingung hinzu. Wenn Sie beispielsweise eine Bedingung hinzufügen möchten, mit der die Rolle allen Reservierungsnamen zugewiesen wird, die mit /reservation1 enden, wählen Sie für Bedingungstyp die Option Name, für Operator die Option Endet mit und für Wert die Option /reservation1 aus.

      3. Klicken Sie auf Speichern.

5. Klicken Sie auf Speichern.

bq

Im bq-Befehlszeilentool können Sie den Zugriff auf eine einzelne Reservierungsressource gewähren.

Verwenden Sie den Befehl bq set-iam-policy, um Zugriff auf eine Reservierung zu gewähren:

bq set-iam-policy RESOURCE FILE_NAME

Ersetzen Sie Folgendes:

• RESOURCE: Der Name der Reservierungsressource. Beispiel: projects/project1/locations/US/reservations/reservation1.

• FILE_NAME: Die Datei, die die Richtlinie im JSON-Format enthält. Das Format sollte der IAM-Richtlinienstruktur für Zulassungsrichtlinien entsprechen. Beispiel:

  {
    "bindings": [
      {
        "members": [
          "user:my-user@example.com"
        ],
        "role": "roles/bigquery.resourceEditor"
      }
    ],
    "etag": "BwUjMhCsNvY=",
    "version": 1
  }