Utilizzare le prenotazioni di slot legacy

L'API BigQuery Reservation consente di acquistare slot dedicati (chiamati impegni��), creare pool di slot (chiamati prenotazioni��) e assegnare progetti, cartelle e organizzazioni a queste prenotazioni.

Le prenotazioni consentono di assegnare un numero dedicato di slot a un carico di lavoro. Ad esempio, potresti non volere che un carico di lavoro di produzione competa con i carichi di lavoro di test per gli slot. Potresti creare una prenotazione denominata prod e assegnare i tuoi workload di produzione a questa prenotazione. Per ulteriori informazioni, vedi Prenotazioni.

Crea prenotazioni

Autorizzazioni obbligatorie

Per creare una prenotazione, devi disporre della seguente autorizzazione Identity and Access Management (IAM):

Ognuno dei seguenti ruoli IAM predefiniti include questa autorizzazione:

  • BigQuery Admin
  • BigQuery Resource Admin
  • BigQuery Resource Editor

Per saperne di più sui ruoli IAM in BigQuery, vedi Ruoli e autorizzazioni predefiniti.

Crea una prenotazione con slot dedicati

Seleziona una delle seguenti opzioni:

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 a discesa Località, seleziona la località.

  6. Nella sezione Modello di capacità, seleziona il modello di capacità.

  7. Se selezioni l'opzione Tariffa fissa, inserisci il numero di slot per la prenotazione in Slot di riferimento.

    1. Nell'elenco Selettore dimensione massima prenotazione, seleziona la dimensione massima della prenotazione.
    2. (Facoltativo) Nel campo Slot di base, inserisci il numero di slot di base per la prenotazione. Per utilizzare solo la capacità dello slot specificata, fai clic sul pulsante di attivazione/disattivazione Ignora slot inattivi.

      Il numero di slot con scalabilità automatica a tua disposizione è determinato sottraendo il valore degli slot di riferimento dal valore della 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 di slot inattivi, fai clic sul pulsante di attivazione/disattivazione Ignora slot inattivi.

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

  10. Fai clic su Salva.

La nuova prenotazione è visibile nella scheda Prenotazioni.

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

    Sostituisci quanto segue:

    • ADMIN_PROJECT_ID: l'ID progetto del progetto di amministrazione che possiede la risorsa di prenotazione
    • LOCATION: la posizione della prenotazione. Se selezioni una località BigQuery Omni, l'opzione di edizione è limitata all'edizione Enterprise.
    • RESERVATION_NAME: il nome della prenotazione

      Deve iniziare e terminare con una lettera minuscola o un numero e contenere solo lettere minuscole, numeri e trattini.

    • NUMBER_OF_BASELINE_SLOTS: il numero di slot di riferimento 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 Esegui.

Per maggiori informazioni 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 \
    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.

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

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

Python

Installa il pacchetto google-cloud-bigquery-reservation prima di utilizzare questo esempio di codice. Crea un ReservationServiceClient. Descrivi la prenotazione che vuoi creare con una prenotazione. Crea la prenotazione con il metodo create_reservation.
# 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}")

Aggiorna prenotazioni

Puoi apportare i seguenti aggiornamenti a una prenotazione:

  • Modifica le dimensioni della prenotazione aggiungendo o rimuovendo slot.
  • Configura se le query in questa prenotazione utilizzano slot inattivi.
  • Modifica la quantità di slot di base o di scalabilità automatica assegnati a una prenotazione.

Autorizzazioni obbligatorie

Per aggiornare una prenotazione, devi disporre della seguente autorizzazione Identity and Access Management (IAM):

Ognuno dei seguenti ruoli IAM predefiniti include questa autorizzazione:

  • BigQuery Admin
  • BigQuery Resource Admin
  • BigQuery Resource Editor

Per saperne di più sui ruoli IAM in BigQuery, vedi Ruoli e autorizzazioni predefiniti.

Modificare le dimensioni di una prenotazione

Puoi aggiungere o rimuovere slot da una prenotazione esistente.

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

  5. Espandi l'opzione 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. 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,
    );

    Sostituisci quanto segue:

    • ADMIN_PROJECT_ID: l'ID progetto del progetto di amministrazione che possiede la risorsa di prenotazione
    • LOCATION: la posizione della prenotazione, ad esempio europe-west9.
    • RESERVATION_NAME: il nome della prenotazione. Deve iniziare e terminare con una lettera minuscola o un numero e contenere solo lettere minuscole, numeri e trattini.

    • NUMBER_OF_BASELINE_SLOTS: il numero di slot di riferimento da allocare alla prenotazione.

  3. Fai clic su Esegui.

Per maggiori informazioni 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 \
    --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

Python

Installa il pacchetto google-cloud-bigquery-reservation prima di utilizzare questo esempio di codice. Crea un ReservationServiceClient. Descrivi le proprietà aggiornate con una Reservation e la proprietà FieldMask.paths. Aggiorna la prenotazione con il metodo update_reservation.
# 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}")

Configura se le query utilizzano gli slot inattivi

Il flag --ignore_idle_slots controlla se le query eseguite in una prenotazione possono utilizzare gli slot inattivi di altre prenotazioni. Per ulteriori informazioni, consulta la sezione Slot inattivi. Puoi aggiornare questa configurazione in una prenotazione esistente.

Per aggiornare una prenotazione, utilizza il comando bq update con il flag --reservation . Il seguente esempio imposta --ignore_idle_slots su true, il che significa che la prenotazione utilizzerà solo gli slot allocati alla prenotazione.

bq update \
    --project_id=ADMIN_PROJECT_ID \
    --location=LOCATION \
    --ignore_idle_slots=true \
    --reservation RESERVATION_NAME

Sostituisci quanto segue:

  • ADMIN_PROJECT_ID: l'ID progetto
  • LOCATION: la posizione della prenotazione
  • RESERVATION_NAME: il nome della prenotazione

Elenca la configurazione dello slot inattivo

Per elencare l'impostazione slot inutilizzati per una prenotazione:

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:

  3. Fai clic su Esegui.

Per maggiori informazioni 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:

Il campo ignoreIdleSlots contiene l'impostazione di configurazione.

Elimina prenotazioni

Quando elimini una prenotazione, tutti i job attualmente in esecuzione con gli slot di quella prenotazione non andranno a buon fine. Per evitare errori, consenti il completamento dei job in esecuzione prima di eliminare la prenotazione.

Autorizzazioni obbligatorie

Per eliminare una prenotazione, devi disporre della seguente autorizzazione Identity and Access Management (IAM):

Ognuno dei seguenti ruoli IAM predefiniti include questa autorizzazione:

  • BigQuery Admin
  • BigQuery Resource Admin
  • BigQuery Resource Editor

Per saperne di più sui ruoli IAM in BigQuery, vedi Ruoli e autorizzazioni predefiniti.

Eliminazione di una prenotazione

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 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 che possiede la risorsa di prenotazione
    • LOCATION: la posizione della prenotazione
    • RESERVATION_NAME: l'ID della prenotazione

  3. Fai clic su Esegui.

Per maggiori informazioni 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

Python

Installa il pacchetto google-cloud-bigquery-reservation prima di utilizzare questo esempio di codice. Crea un ReservationServiceClient. Elimina la prenotazione con il metodo delete_reservation.
# 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}")

Aggiungere l'API BigQuery Reservation ai Controlli di servizio VPC

L'API BigQuery Reservation supporta i Controlli di servizio VPC. Per integrare l'API BigQuery Reservation con Controlli di servizio VPC, segui le istruzioni riportate in Creare un perimetro di servizio e aggiungi l'API BigQuery Reservation ai servizi protetti.

Un perimetro di servizio protegge l'accesso a prenotazioni, impegni e assegnazioni all'interno dei progetti di amministrazione specificati nel perimetro. Quando crei un'assegnazione, Controlli di servizio VPC protegge il progetto di amministrazione e il progetto, la cartella e l'organizzazione del destinatario.