Utilizzare le prenotazioni di slot

Console

1. Nella console Google Cloud , vai alla pagina BigQuery.

   Vai a BigQuery

2. Nel menu di navigazione, fai clic su Gestione della capacità.

3. Fai clic su Crea prenotazione.

4. Nel campo Nome prenotazione, inserisci un nome per la prenotazione.

5. Nell'elenco Località, seleziona la località. Se selezioni una posizione BigQuery Omni, l'opzione della versione è limitata alla versione Enterprise.

6. Nell'elenco Versione, seleziona la versione. Le funzionalità dell'edizione BigQuery, come la scalabilità automatica, sono disponibili solo all'interno di un'edizione. Per ulteriori informazioni, vedi Introduzione alle versioni di BigQuery.

7. Nell'elenco Selettore dimensione massima prenotazione, seleziona la dimensione massima della prenotazione.

8. (Facoltativo) Nel campo Slot di base, inserisci il numero di slot di base per la prenotazione.

   Il numero di slot con scalabilità automatica disponibili viene determinato sottraendo il valore degli slot di riferimento dalla dimensione massima della prenotazione. Ad esempio, se crei una prenotazione con 100 slot di riferimento e una dimensione massima della prenotazione di 400, la prenotazione ha 300 slot con scalabilità automatica. Per saperne di più sugli slot di base, vedi Utilizzo delle prenotazioni con slot di base e di scalabilità automatica.

9. Per disattivare la condivisione degli slot inattivi e utilizzare solo la capacità degli slot specificata, fai clic sul pulsante di attivazione/disattivazione Ignora slot inattivi.

10. Per espandere la sezione Impostazioni avanzate, fai clic sulla freccia di espansione expand_more.

11. (Facoltativo) Per impostare la concorrenza target dei job, fai clic sul pulsante di attivazione/disattivazione Ignora la concorrenza automatica target dei job e inserisci la concorrenza target dei job.

12. La suddivisione degli slot viene visualizzata nella tabella Stima dei costi. Un riepilogo della prenotazione viene visualizzato nella tabella Riepilogo della capacità.

13. Fai clic su Salva.

La nuova prenotazione è visibile nella scheda Prenotazioni slot.

SQL

Per creare una prenotazione, utilizza l'istruzione DDL CREATE RESERVATION.

1. Nella console Google Cloud , vai alla pagina BigQuery.

   Vai a BigQuery

2. Nell'editor di query, inserisci la seguente istruzione:

   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);

   Sostituisci quanto segue:

   • ADMIN_PROJECT_ID: l'ID progetto del progetto di amministrazione proprietario della risorsa di prenotazione
   • LOCATION: la posizione della prenotazione. Se selezioni una posizione BigQuery Omni, l'opzione di edizione è limitata all'edizione Enterprise.

   • RESERVATION_NAME: il nome della prenotazione

     Il nome può contenere solo caratteri alfanumerici minuscoli o trattini, deve iniziare con una lettera e non deve terminare con un trattino. La lunghezza massima è di 64 caratteri.

   • NUMBER_OF_BASELINE_SLOTS: il numero di base di slot da allocare alla prenotazione. Non puoi impostare l'opzione slot_capacity e l'opzione edition nella stessa prenotazione.
   • EDITION: l'edizione della prenotazione. L'assegnazione di una prenotazione a una versione comporta modifiche alle funzionalità e ai prezzi. Per ulteriori informazioni, vedi Introduzione alle versioni di BigQuery.
   • NUMBER_OF_AUTOSCALING_SLOTS: il numero di slot di scalabilità automatica assegnati alla prenotazione. È uguale al valore della dimensione massima della prenotazione meno il numero di slot di base.

3. Fai clic su play_circle Esegui.

Per saperne di più su come eseguire le query, consulta Eseguire una query interattiva.

bq

Per creare una prenotazione, utilizza il comando bq mk con il 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

Sostituisci quanto segue:

• ADMIN_PROJECT_ID: l'ID progetto
• LOCATION: la posizione della prenotazione. Se selezioni una posizione BigQuery Omni, l'opzione della versione è limitata alla versione Enterprise.

• NUMBER_OF_BASELINE_SLOTS: il numero di slot di riferimento da assegnare alla prenotazione

• RESERVATION_NAME: il nome della prenotazione. Il nome può contenere solo caratteri alfanumerici minuscoli o trattini, deve iniziare con una lettera e non deve terminare con un trattino. La lunghezza massima è di 64 caratteri.

• EDITION: l'edizione della prenotazione. L'assegnazione di una prenotazione a una versione comporta modifiche alle funzionalità e ai prezzi. Per ulteriori informazioni, vedi Introduzione alle versioni di BigQuery.

• NUMBER_OF_AUTOSCALING_SLOTS: il numero di slot di scalabilità automatica assegnati alla prenotazione. È uguale al valore della dimensione massima della prenotazione meno il numero di slot di base. Non può essere configurato con i flag --max_slots o --scaling_mode.

• MAXIMUM_NUMBER_OF_SLOTS: il numero massimo di slot che la prenotazione può utilizzare. Questo valore deve essere configurato con il flag --scaling_mode (anteprima).

• SCALING_MODE: la modalità di scalabilità della prenotazione. Le opzioni sono ALL_SLOTS, IDLE_SLOTS_ONLY o AUTOSCALE_ONLY. Questo valore deve essere configurato con il flag --scaling_mode (anteprima).

Per informazioni sul flag --ignore_idle_slots, vedi Slot inattivi. Il valore predefinito è false.

Terraform

Utilizza la risorsa google_bigquery_reservation.

Per eseguire l'autenticazione in BigQuery, configura le credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.

L'esempio seguente crea una prenotazione denominata my-reservation:

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
  }
}

Per applicare la configurazione di Terraform in un progetto Google Cloud , completa i passaggi nelle sezioni seguenti.

Prepara Cloud Shell

1. Avvia Cloud Shell.

2. Imposta il progetto Google Cloud predefinito in cui vuoi applicare le configurazioni Terraform.

   Devi eseguire questo comando una sola volta per progetto e puoi eseguirlo in qualsiasi directory.

   export GOOGLE_CLOUD_PROJECT=PROJECT_ID

   Le variabili di ambiente vengono sostituite se imposti valori espliciti nel file di configurazione Terraform.

Prepara la directory

Ogni file di configurazione Terraform deve avere la propria directory (chiamata anche modulo radice).

1. In Cloud Shell, crea una directory e un nuovo file al suo interno. Il nome file deve avere l'estensione .tf, ad esempio main.tf. In questo tutorial, il file viene denominato main.tf.

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

2. Se stai seguendo un tutorial, puoi copiare il codice campione in ogni sezione o passaggio.

   Copia il codice campione nel main.tf appena creato.

   (Facoltativo) Copia il codice da GitHub. Questa operazione è consigliata quando lo snippet Terraform fa parte di una soluzione end-to-end.

3. Rivedi e modifica i parametri di esempio da applicare al tuo ambiente.
4. Salva le modifiche.
5. Inizializza Terraform. Devi effettuare questa operazione una sola volta per directory.

   terraform init

   (Facoltativo) Per utilizzare l'ultima versione del provider Google, includi l'opzione -upgrade:

   terraform init -upgrade

Applica le modifiche

1. Rivedi la configurazione e verifica che le risorse che Terraform creerà o aggiornerà corrispondano alle tue aspettative:

   terraform plan

   Apporta le correzioni necessarie alla configurazione.

2. Applica la configurazione di Terraform eseguendo il comando seguente e inserendo yes al prompt:

   terraform apply

   Attendi che Terraform visualizzi il messaggio "Apply complete!".

3. Apri il tuo Google Cloud progetto per visualizzare i risultati. Nella console Google Cloud , vai alle risorse nell'interfaccia utente per assicurarti che Terraform le abbia create o aggiornate.

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. Nella console Google Cloud , vai alla pagina BigQuery.

   Vai a BigQuery

2. Nel pannello di navigazione, vai alla sezione Gestione della capacità e poi fai clic su Crea prenotazione.

3. Nel campo Nome prenotazione, inserisci un nome per la prenotazione.

4. Nell'elenco Località, seleziona la località. Se selezioni una posizione BigQuery Omni, l'opzione della versione è limitata alla versione Enterprise.

5. Nell'elenco Versione, seleziona la versione. La scalabilità automatica è disponibile solo all'interno di un'edizione. Per ulteriori informazioni, vedi Informazioni sulle versioni di BigQuery.

6. Nell'elenco Selettore dimensione massima prenotazione, seleziona la dimensione massima della prenotazione.

7. (Facoltativo) Nel campo Slot di base, inserisci il numero di slot di base per la prenotazione.

   Il numero di slot con scalabilità automatica disponibili viene determinato sottraendo il valore degli slot di riferimento dalla dimensione massima della prenotazione. Ad esempio, se crei una prenotazione con 100 slot di riferimento e una dimensione massima della prenotazione di 400, la prenotazione ha 300 slot con scalabilità automatica. Per saperne di più sugli slot di base, vedi Utilizzo delle prenotazioni con slot di base e di scalabilità automatica.

8. Per disattivare la condivisione degli slot inattivi e utilizzare solo la capacità degli slot specificata, fai clic sul pulsante di attivazione/disattivazione Ignora slot inattivi.

9. Per espandere la sezione Impostazioni avanzate, fai clic sulla freccia di espansione expand_more.

   1. Nell'elenco Come utilizzare gli slot inattivi?, seleziona l'opzione di configurazione.

10. La suddivisione degli slot viene visualizzata nella tabella Stima dei costi. Un riepilogo della prenotazione viene visualizzato nella tabella Riepilogo della capacità.

11. Fai clic su Salva.

La nuova prenotazione è visibile nella scheda Prenotazioni slot.

bq

Per creare una prenotazione prevedibile, utilizza il comando bq mk con il flag --reservation e imposta il valore di max_slots e scaling_mode:

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

Sostituisci quanto segue:

• ADMIN_PROJECT_ID: l'ID progetto
• LOCATION: la posizione della prenotazione. Se selezioni una posizione BigQuery Omni, l'opzione della versione è limitata alla versione Enterprise.

• NUMBER_OF_BASELINE_SLOTS: il numero di slot di riferimento da assegnare alla prenotazione

• RESERVATION_NAME: il nome della prenotazione

• EDITION: l'edizione della prenotazione. L'assegnazione di una prenotazione a una versione comporta modifiche alle funzionalità e ai prezzi. Per ulteriori informazioni, vedi Introduzione alle versioni di BigQuery.

• MAXIMUM_NUMBER_OF_SLOTS: il numero massimo di slot che la prenotazione può utilizzare. Questo valore deve essere configurato con il flag --scaling_mode.

• SCALING_MODE: SCALING_MODE: la modalità di scalabilità della prenotazione. Le opzioni sono ALL_SLOTS, IDLE_SLOTS_ONLY o AUTOSCALE_ONLY. Questo valore deve essere configurato con il flag max_slots. Questo valore deve essere allineato al flag ignore_idle_slots. Per maggiori dettagli, vedi Prevedibilità delle prenotazioni.

Per informazioni sul flag --ignore_idle_slots, vedi Slot inattivi. Il valore predefinito è false.

SQL

Per creare una prenotazione prevedibile, utilizza l'istruzione DDL CREATE RESERVATION.

1. Nella console Google Cloud , vai alla pagina BigQuery.

   Vai a BigQuery

2. Nell'editor di query, inserisci la seguente istruzione:

   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);

   Sostituisci quanto segue:

   • ADMIN_PROJECT_ID: l'ID progetto del progetto di amministrazione proprietario della risorsa di prenotazione.
   • LOCATION: la posizione della prenotazione. Se selezioni una posizione BigQuery Omni, l'opzione di edizione è limitata all'edizione Enterprise.

   • RESERVATION_NAME: il nome della prenotazione.Il nome può contenere solo caratteri alfanumerici minuscoli o trattini, deve iniziare con una lettera e non deve terminare con un trattino e la lunghezza massima è di 64 caratteri.

   • NUMBER_OF_BASELINE_SLOTS: il numero di base di slot da allocare alla prenotazione. Non puoi impostare l'opzione slot_capacity e l'opzione edition nella stessa prenotazione.
   • EDITION: l'edizione della prenotazione. L'assegnazione di una prenotazione a una versione comporta modifiche alle funzionalità e ai prezzi. Per ulteriori informazioni, vedi Introduzione alle versioni di BigQuery.
   • IGNORE_IDLE_SLOTS: indica se la prenotazione utilizza o meno gli slot inattivi. Il valore predefinito è false.
   • MAX_NUMBER_OF_SLOTS: il numero massimo di slot che la prenotazione può utilizzare. Questo valore deve essere configurato con l'opzione scaling_mode.
   • SCALING_MODE: la modalità di scalabilità della prenotazione. Le opzioni sono ALL_SLOTS, IDLE_SLOTS_ONLY o AUTOSCALE_ONLY. Questo valore deve essere configurato con l'opzione max_slots. Questo valore deve essere allineato all'opzione ignore_idle_slots. Per maggiori dettagli, vedi Prevedibilità delle prenotazioni.

3. Fai clic su play_circle Esegui.

Per saperne di più su come eseguire le query, consulta Eseguire una query interattiva.

Console

1. Nella console Google Cloud , vai alla pagina BigQuery.

   Vai a BigQuery

2. Nel menu di navigazione, fai clic su Gestione della capacità.

3. Fai clic sulla scheda Prenotazioni slot.

4. Trova la prenotazione che vuoi aggiornare.

5. Espandi l'opzione more_vert Azioni.

6. Fai clic su Modifica.

7. Nella finestra di dialogo Selettore dimensione massima prenotazione, inserisci la dimensione massima della prenotazione.

8. Nel campo Slot di base, inserisci il numero di slot di base.

9. Per espandere la sezione Impostazioni avanzate, fai clic sulla freccia di espansione expand_more.

10. (Facoltativo) Per impostare la concorrenza target dei job, fai clic sul pulsante di attivazione/disattivazione Ignora la concorrenza automatica target dei job e inserisci la concorrenza target dei job.

11. Fai clic su Salva.

SQL

Per modificare le dimensioni di una prenotazione, utilizza l'istruzione DDL (Data Definition Language) ALTER RESERVATION SET OPTIONS.

1. Nella console Google Cloud , vai alla pagina BigQuery.

   Vai a BigQuery

2. Nell'editor di query, inserisci la seguente istruzione:

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

   Sostituisci quanto segue:

   • ADMIN_PROJECT_ID: l'ID progetto del progetto di amministrazione proprietario della risorsa di prenotazione
   • LOCATION: la posizione della prenotazione, ad esempio europe-west9.

   • RESERVATION_NAME: il nome della prenotazione. Il nome può contenere solo caratteri alfanumerici minuscoli o trattini, deve iniziare con una lettera e non deve terminare con un trattino. La lunghezza massima è di 64 caratteri.

   • NUMBER_OF_BASELINE_SLOTS: il numero di slot di base da allocare alla prenotazione.
   • NUMBER_OF_AUTOSCALING_SLOTS: il numero di slot di scalabilità automatica assegnati alla prenotazione. È uguale al valore della dimensione massima della prenotazione meno il numero di slot di base.

3. Fai clic su play_circle Esegui.

Per saperne di più su come eseguire le query, consulta Eseguire una query interattiva.

bq

Per aggiornare le dimensioni di una prenotazione, utilizza il comando bq update con il flag --reservation:

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

Sostituisci quanto segue:

• ADMIN_PROJECT_ID: l'ID progetto
• LOCATION: la posizione della prenotazione
• NUMBER_OF_BASELINE_SLOTS: il numero di slot di riferimento da assegnare alla prenotazione
• RESERVATION_NAME: il nome della prenotazione. Il nome può contenere solo caratteri alfanumerici minuscoli o trattini, deve iniziare con una lettera e non deve terminare con un trattino. La lunghezza massima è di 64 caratteri.
• NUMBER_OF_AUTOSCALING_SLOTS: il numero di slot di scalabilità automatica assegnati alla prenotazione. È uguale al valore della dimensione massima della prenotazione meno il numero di slot di base.

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

Esegui una query sulla colonna ignore_idle_slots della visualizzazione INFORMATION_SCHEMA.RESERVATIONS_BY_PROJECT.

1. Nella console Google Cloud , vai alla pagina BigQuery.

   Vai a BigQuery

2. Nell'editor di query, inserisci la seguente istruzione:

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

   Sostituisci quanto segue:

   • ADMIN_PROJECT_ID: l'ID progetto del progetto di amministrazione proprietario delle risorse di prenotazione
   • LOCATION: la posizione delle prenotazioni

3. Fai clic su play_circle Esegui.

Per saperne di più su come eseguire le query, consulta Eseguire una query interattiva.

bq

Utilizza il comando bq ls con il flag --reservation:

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

Sostituisci quanto segue:

• ADMIN_PROJECT_ID: l'ID progetto del progetto di amministrazione che possiede le risorse di prenotazione
• LOCATION: la posizione delle prenotazioni

Il campo ignoreIdleSlots contiene l'impostazione di configurazione.

Console

1. Nella console Google Cloud , vai alla pagina BigQuery.

   Vai a BigQuery

2. Nel menu di navigazione, fai clic su Gestione della capacità.

3. Fai clic sulla scheda Prenotazioni.

4. Trova la prenotazione che vuoi eliminare.

5. Espandi l'opzione more_vert Azioni.

6. Fai clic su Elimina.

7. Nella finestra di dialogo Elimina prenotazione, fai clic su Elimina.

SQL

Per eliminare una prenotazione, utilizza l'istruzione DDL DROP RESERVATION.

1. Nella console Google Cloud , vai alla pagina BigQuery.

   Vai a BigQuery

2. Nell'editor di query, inserisci la seguente istruzione:

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

   Sostituisci quanto segue:

   • ADMIN_PROJECT_ID: l'ID progetto del progetto di amministrazione proprietario della risorsa di prenotazione
   • LOCATION: la posizione della prenotazione
   • RESERVATION_NAME: l'ID della prenotazione

3. Fai clic su play_circle Esegui.

Per saperne di più su come eseguire le query, consulta Eseguire una query interattiva.

bq

Per eliminare una prenotazione, utilizza il comando bq rm con il flag --reservation:

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

Sostituisci quanto segue:

• ADMIN_PROJECT_ID: l'ID progetto del progetto di amministrazione che possiede la risorsa di prenotazione
• LOCATION: la posizione della prenotazione
• RESERVATION_NAME: il nome della prenotazione. Il nome può contenere solo caratteri alfanumerici minuscoli o trattini, deve iniziare con una lettera e non deve terminare con un trattino. La lunghezza massima è di 64 caratteri.

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

Nella console Google Cloud , puoi consentire l'accesso a più risorse di prenotazione utilizzando una condizione.

1. Nella console Google Cloud , vai alla pagina IAM.

   Vai a IAM

2. Seleziona un progetto, una cartella o un'organizzazione.

3. Per concedere il ruolo bigquery.resourceEditor a un'entità che ha un ruolo nelle risorse di prenotazione:

   1. Nella scheda Visualizza per soggetti, vai al soggetto appropriato o utilizza l'opzione Filtra per trovare il soggetto.

   2. Fai clic su edit Modifica soggetto.

   3. Nella pagina Assegna ruoli, fai clic su add Aggiungi ruoli.

   4. Nel campo Cerca ruoli, inserisci bigquery.resourceEditor.

   5. Seleziona l'opzione Editor risorse BigQuery nei risultati di ricerca e poi fai clic su Applica.

   6. Fai clic su Salva.

4. In alternativa, per concedere il ruolo bigquery.resourceEditor a un'entità che non ha un ruolo nelle risorse di prenotazione:

   1. Fai clic su person_add Concedi l'accesso.

   2. Nella pagina Aggiungi entità, nel campo Nuove entità, inserisci l'identificatore dell'entità, ad esempio my-user@example.com.

   3. Fai clic su add Aggiungi ruoli.

   4. Nel campo Cerca ruoli, inserisci bigquery.resourceEditor.

   5. Seleziona l'opzione Editor risorse BigQuery nei risultati di ricerca e poi fai clic su Applica.

   6. Nella casella Editor risorse BigQuery, fai clic su Aggiungi condizione.

   7. Nella pagina Aggiungi condizione:

      1. Inserisci i valori nei campi Titolo e Descrizione.

      2. In Generatore di condizioni, aggiungi la condizione. Ad esempio, per aggiungere una condizione che assegna il ruolo a tutti i nomi delle prenotazioni che terminano con /reservation1, per Tipo di condizione, scegli Nome, per Operatore, scegli Termina con e per Valore, inserisci /reservation1.

      3. Fai clic su Salva.

5. Fai clic su Salva.

bq

Nello strumento a riga di comando bq, puoi concedere l'accesso a una singola risorsa di prenotazione.

Per concedere l'accesso a una prenotazione, utilizza il comando bq set-iam-policy:

bq set-iam-policy RESOURCE FILE_NAME

Sostituisci quanto segue:

• RESOURCE: il nome della risorsa di prenotazione. Ad esempio, projects/project1/locations/US/reservations/reservation1.

• FILE_NAME: il file contenente la policy in formato JSON. Il formato deve seguire la struttura dei criteri IAM per i criteri di autorizzazione. Ad esempio:

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