Lavorare con le assegnazioni delle prenotazioni

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

Creare assegnazioni di prenotazione

Per utilizzare gli slot acquistati, crea un'assegnazione che assegna un progetto, una cartella o un'organizzazione a una prenotazione di slot.

I progetti utilizzano la singola prenotazione più specifica nella gerarchia delle risorse a cui sono assegnati. Un'assegnazione di cartella ha la precedenza su un'assegnazione di organizzazione e un'assegnazione di progetto ha la precedenza su un'assegnazione di cartella. Le assegnazioni di cartelle e organizzazioni non sono disponibili per le prenotazioni dell'edizione standard.

Per poter creare un'assegnazione per una prenotazione, quest'ultima deve soddisfare almeno uno dei seguenti criteri:

• È configurato con un numero di slot di riferimento assegnati diverso da zero.

• È configurato con una quantità di slot di scalabilità automatica diversa da zero.

• È configurato per utilizzare gli slot inattivi e sono disponibili slot inattivi all'interno del progetto.

Se provi ad assegnare una risorsa a una prenotazione che non soddisfa almeno uno di questi criteri, viene visualizzato il seguente messaggio: Assignment is pending, your project will be executed as on-demand.

Puoi assegnare una risorsa a una prenotazione di failover, ma l'assegnazione è in attesa nella località secondaria.

Nota: per creare assegnazioni delle prenotazioni per i job di query continua (job che utilizzano il tipo di job CONTINUOUS), devi registrarti all'anteprima della funzionalità.

Autorizzazioni obbligatorie

Per creare un'assegnazione di prenotazioni, devi disporre della seguente autorizzazione Identity and Access Management (IAM):

• bigquery.reservationAssignments.create nel progetto di amministrazione e l'assegnatario.

Ogni uno 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, consulta Ruoli e autorizzazioni predefiniti.

Assegnare un'organizzazione a una prenotazione

Console

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

   Vai a BigQuery

2. Nel pannello di navigazione, vai alla sezione Gestione della capacità.

3. Fai clic sulla scheda Prenotazioni.

4. Trova la prenotazione nella tabella delle prenotazioni

5. Espandi l'opzione Azioni.

6. Fai clic su Crea compito.

7. Nella sezione Crea un compito, fai clic su Sfoglia.

8. Sfoglia o cerca l'organizzazione e selezionala.

9. Nella sezione Tipo di job, seleziona un tipo di job da assegnare per questa prenotazione. Le opzioni includono:

   • QUERY
   • CONTINUOUS (Anteprima)
   • PIPELINE
   • BACKGROUND
   • ML_EXTERNAL

   Per ulteriori informazioni sui tipi di job, consulta le assegnazioni delle prenotazioni. Questo valore predefinito è QUERY.

   Per scoprire di più su come consentire agli utenti di utilizzare Gemini in BigQuery con le assegnazioni della versione Enterprise Plus, consulta Configurare Gemini in BigQuery.

10. Fai clic su Crea.

SQL

Per assegnare un'organizzazione a una prenotazione, utilizza l'istruzione DDL CREATE ASSIGNMENT.

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

   Vai a BigQuery

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

   CREATE ASSIGNMENT
     `ADMIN_PROJECT_ID.region-LOCATION.RESERVATION_NAME.ASSIGNMENT_ID`
   OPTIONS (
     assignee = 'organizations/ORGANIZATION_ID',
     job_type = 'JOB_TYPE');

   Sostituisci quanto segue:

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

   • ASSIGNMENT_ID: l'ID del compito

     L'ID deve essere univoco per il progetto e la località, deve iniziare e terminare con una lettera minuscola o un numero e contenere solo lettere minuscole, numeri e trattini.

   • ORGANIZATION_ID: ID organizzazione
   • JOB_TYPE: il tipo di job da assegnare a questa prenotazione, ad esempio QUERY, CONTINUOUS (Anteprima), PIPELINE, BACKGROUND o ML_EXTERNAL

3. Fai clic su Esegui.

Per ulteriori informazioni su come eseguire query, consulta Eseguire una query interattiva.

bq

Per assegnare i job di un'organizzazione a una prenotazione, utilizza il comando bq mk con il flag --reservation_assignment:

bq mk \
    --project_id=ADMIN_PROJECT_ID \
    --location=LOCATION \
    --reservation_assignment \
    --reservation_id=RESERVATION_NAME \
    --assignee_id=ORGANIZATION_ID \
    --job_type=JOB_TYPE \
    --assignee_type=ORGANIZATION

Sostituisci quanto segue:

• ADMIN_PROJECT_ID: l'ID del progetto di amministrazione che possiede la risorsa di prenotazione
• LOCATION: la posizione della prenotazione
• RESERVATION_NAME: il nome della prenotazione
• ORGANIZATION_ID: l'ID organizzazione
• JOB_TYPE: il tipo di job da assegnare a questa prenotazione, ad esempio QUERY, CONTINUOUS (Anteprima), PIPELINE, BACKGROUND o ML_EXTERNAL

Quando crei un'assegnazione di prenotazione, attendi almeno 5 minuti prima di eseguire una query. In caso contrario, la query potrebbe essere fatturata utilizzando i prezzi on demand.

Assegnare un progetto o una cartella a una prenotazione

Console

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

   Vai a BigQuery

2. Nel pannello di navigazione, vai alla sezione Gestione della capacità.

3. Fai clic sulla scheda Prenotazioni.

4. Trova la prenotazione nella tabella delle prenotazioni.

5. Espandi l'opzione Azioni.

6. Fai clic su Crea compito.

7. Nella sezione Crea un compito, fai clic su Sfoglia.

8. Sfoglia o cerca il progetto o la cartella e selezionali.

9. Nella sezione Tipo di job, seleziona un tipo di job da assegnare per questa prenotazione. Le opzioni includono:

   • QUERY
   • CONTINUOUS (Anteprima)
   • PIPELINE
   • BACKGROUND
   • ML_EXTERNAL

   Per ulteriori informazioni sui tipi di job, consulta le assegnazioni delle prenotazioni. Questo valore predefinito è QUERY.

10. Fai clic su Crea.

SQL

Per assegnare un progetto a una prenotazione, utilizza l'istruzione DDL CREATE ASSIGNMENT.

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

   Vai a BigQuery

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

   CREATE ASSIGNMENT
     `ADMIN_PROJECT_ID.region-LOCATION.RESERVATION_NAME.ASSIGNMENT_ID`
   OPTIONS(
     assignee="projects/PROJECT_ID",
     job_type="JOB_TYPE");

   Sostituisci quanto segue:

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

   • ASSIGNMENT_ID: l'ID del compito

     L'ID deve essere univoco per il progetto e la località, deve iniziare e terminare con una lettera minuscola o un numero e contenere solo lettere minuscole, numeri e trattini.

   • PROJECT_ID: l'ID del progetto da assegnare alla prenotazione
   • JOB_TYPE: il tipo di job da assegnare a questa prenotazione, ad esempio QUERY, CONTINUOUS (Anteprima), PIPELINE, BACKGROUND o ML_EXTERNAL

3. Fai clic su Esegui.

Per ulteriori informazioni su come eseguire query, consulta Eseguire una query interattiva.

bq

Per assegnare i job a una prenotazione, utilizza il comando bq mk con il --reservation_assignment flag:

bq mk \
    --project_id=ADMIN_PROJECT_ID \
    --location=LOCATION \
    --reservation_assignment \
    --reservation_id=RESERVATION_NAME \
    --assignee_id=PROJECT_ID \
    --job_type=JOB_TYPE \
    --assignee_type=PROJECT

Sostituisci quanto segue:

• ADMIN_PROJECT_ID: l'ID del progetto di amministrazione che possiede la risorsa di prenotazione
• LOCATION: la posizione della prenotazione
• RESERVATION_NAME: il nome della prenotazione
• PROJECT_ID: l'ID del progetto da assegnare a questa prenotazione
• JOB_TYPE: il tipo di job da assegnare a questa prenotazione, ad esempio QUERY, CONTINUOUS (Anteprima), PIPELINE, BACKGROUND o ML_EXTERNAL

Terraform

Utilizza la risorsa google_bigquery_reservation_assignment.

Nota: per creare oggetti BigQuery utilizzando Terraform, devi attivare l'API Cloud Resource Manager.

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

L'esempio seguente assegna un progetto alla prenotazione 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
  }
}

data "google_project" "project" {}

resource "google_bigquery_reservation_assignment" "default" {
  assignee    = "projects/${data.google_project.project.project_id}"
  job_type    = "QUERY"
  reservation = google_bigquery_reservation.default.id
}

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

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 farlo 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 di Terraform deve avere una propria directory (chiamata anche modulo principale).

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 è 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 file main.tf appena creato.

   Se vuoi, copia il codice da GitHub. Questa opzione è consigliata quando lo snippet Terraform fa parte di una soluzione end-to-end.

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

   terraform init

   Se vuoi, per utilizzare la versione più recente del provider Google, includi l'opzione -upgrade:

   terraform init -upgrade

Applica le modifiche

1. Rivedi la configurazione e verifica che le risorse che Terraform sta per creare o aggiornare corrispondano alle tue aspettative:

   terraform plan

   Apporta le correzioni necessarie alla configurazione.

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

   terraform apply

   Attendi che Terraform mostri il messaggio "Applicazione completata".

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

Nota: in genere i sample di Terraform presuppongono che le API richieste siano attivate nel progetto Google Cloud.

Quando crei un'assegnazione di prenotazione, attendi almeno 5 minuti prima di eseguire una query. In caso contrario, la query potrebbe essere fatturata utilizzando i prezzi on demand.

Per creare un progetto che utilizzi solo slot inutilizzati, crea una prenotazione con 0 slot assegnati, quindi segui i passaggi precedenti per assegnare il progetto alla prenotazione.

Nota: un progetto può essere assegnato a una sola prenotazione in una singola regione.

Assegnare un progetto a none

Compiti a none rappresentano l'assenza di un'assegnazione. I progetti assegnati a none utilizzano i prezzi on demand.

Nota: le Compiti a none sono supportate solo per i job QUERY.

SQL

Per assegnare un progetto a none, utilizza l'istruzione DDL CREATE ASSIGNMENT.

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

   Vai a BigQuery

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

   CREATE ASSIGNMENT
     `ADMIN_PROJECT_ID.region-LOCATION.none.ASSIGNMENT_ID`
   OPTIONS(
     assignee="projects/PROJECT_ID",
     job_type="QUERY");

   Sostituisci quanto segue:

   • LOCATION: la posizione dei job che devono utilizzare i prezzi on demand

   • ASSIGNMENT_ID: l'ID del compito

     L'ID deve essere univoco per il progetto e la località, deve iniziare e terminare con una lettera minuscola o un numero e contenere solo lettere minuscole, numeri e trattini.

   • PROJECT_ID: l'ID del progetto da assegnare alla prenotazione

3. Fai clic su Esegui.

Per ulteriori informazioni su come eseguire query, consulta Eseguire una query interattiva.

bq

Per assegnare un progetto a none, utilizza il comando bq mk con il --reservation_assignment flag:

bq mk \
    --location=LOCATION \
    --reservation_assignment \
    --reservation_id=none \
    --job_type=QUERY \
    --assignee_id=PROJECT_ID \
    --assignee_type=PROJECT

Sostituisci quanto segue:

• LOCATION: la posizione delle attività che devono utilizzare i prezzi on demand
• PROJECT_ID: l'ID del progetto da assegnare a none

Terraform

Utilizza la risorsa google_bigquery_reservation_assignment.

Nota: per creare oggetti BigQuery utilizzando Terraform, devi attivare l'API Cloud Resource Manager.

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

L'esempio seguente assegna un progetto a none:

data "google_project" "project" {}

resource "google_bigquery_reservation_assignment" "default" {
  assignee    = "projects/${data.google_project.project.project_id}"
  job_type    = "QUERY"
  reservation = "projects/${data.google_project.project.project_id}/locations/us/reservations/none"
}

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

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 farlo 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 di Terraform deve avere una propria directory (chiamata anche modulo principale).

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 è 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 file main.tf appena creato.

   Se vuoi, copia il codice da GitHub. Questa opzione è consigliata quando lo snippet Terraform fa parte di una soluzione end-to-end.

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

   terraform init

   Se vuoi, per utilizzare la versione più recente del provider Google, includi l'opzione -upgrade:

   terraform init -upgrade

Applica le modifiche

1. Rivedi la configurazione e verifica che le risorse che Terraform sta per creare o aggiornare corrispondano alle tue aspettative:

   terraform plan

   Apporta le correzioni necessarie alla configurazione.

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

   terraform apply

   Attendi che Terraform mostri il messaggio "Applicazione completata".

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

Nota: in genere i sample di Terraform presuppongono che le API richieste siano attivate nel progetto Google Cloud.

Assegnare gli slot ai carichi di lavoro BigQuery ML

Le sezioni seguenti forniscono informazioni sui requisiti di assegnazione delle prenotazioni per i modelli BigQuery ML. Puoi creare queste assegnazioni di prenotazione seguendo le procedure descritte in Assegnare un'organizzazione a una prenotazione o Assegnare un progetto o una cartella a una prenotazione.

Modelli esterni

I seguenti tipi di modelli BigQuery ML utilizzano servizi esterni:

• Autoencoder
• AutoML
• Albero con boosting
• Rete neurale profonda (DNN)
• Foresta casuale
• Rete Wide and Deep

Puoi assegnare slot riservati alle query che utilizzano questi servizi creando un'assegnazione della prenotazione che utilizza il tipo di job ML_EXTERNAL. Se non viene trovata alcuna assegnazione di prenotazione con un ML_EXTERNALtipo di job, il job di query viene eseguito utilizzando i prezzi on demand.

Per i job di addestramento di modelli esterni, gli slot nell'assegnazione della prenotazione vengono utilizzati per i passaggi di pre-elaborazione, addestramento e post-elaborazione. Durante l'addestramento, gli slot non sono preemptibili, ma durante la preelaborazione e la postelaborazione, possono essere utilizzati gli slot inattivi.

Modelli di fattorizzazione matriciale

Per creare un modello di fattorizzazione matriciale, devi creare una prenotazione che utilizzi la versione Enterprise o Enterprise Plus di BigQuery, quindi creare un'assegnazione di prenotazione che utilizzi il tipo di job QUERY.

Altri tipi di modelli

Per i modelli BigQuery ML che non sono modelli esterni o modelli di fattorizazione della matrice, puoi assegnare slot riservati alle query che utilizzano questi servizi creando un'assegnazione di prenotazione che utilizza il tipo di job QUERY. Se non viene trovata alcuna assegnazione di prenotazione con un tipo di job QUERY, il job di query viene eseguito utilizzando i prezzi on demand.

Trovare le assegnazioni di prenotazione

Autorizzazioni obbligatorie

Per cercare un'assegnazione di prenotazione per un determinato progetto, una cartella o un'organizzazione, devi disporre della seguente autorizzazione Identity and Access Management (IAM):

• bigquery.reservationAssignments.list nel progetto di amministrazione.

Ogni uno dei seguenti ruoli IAM predefiniti include questa autorizzazione:

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

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

Trovare l'assegnazione di prenotazione di un progetto

Per scoprire se il tuo progetto, la tua cartella o la tua organizzazione sono assegnati a una prenotazione, svolgi i seguenti passaggi:

Console

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

   Vai a BigQuery

2. Nel pannello di navigazione, vai alla sezione Gestione della capacità.

3. Fai clic sulla scheda Prenotazioni.

4. Nella tabella delle prenotazioni, espandi una prenotazione per vedere quali risorse sono assegnate o utilizza il campo Filtra per filtrare in base al nome della risorsa.

SQL

Per trovare la prenotazione a cui sono assegnati i job di query del progetto, esegui una query sulla visualizzazione INFORMATION_SCHEMA.ASSIGNMENTS_BY_PROJECT.

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

   Vai a BigQuery

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

     SELECT
       assignment_id
     FROM `region-LOCATION`.INFORMATION_SCHEMA.ASSIGNMENTS_BY_PROJECT
     WHERE
       assignee_id = 'PROJECT_ID'
       AND job_type = 'JOB_TYPE';

   Sostituisci quanto segue:

   • LOCATION: la posizione delle prenotazioni da visualizzare
   • ADMIN_PROJECT_ID: l'ID del progetto di amministrazione proprietario della risorsa di prenotazione
   • PROJECT_ID: l'ID del progetto da assegnare alla prenotazione
   • JOB_TYPE: il tipo di job da assegnare a questa prenotazione, ad esempio QUERY, CONTINUOUS (Anteprima), PIPELINE, BACKGROUND o ML_EXTERNAL

3. Fai clic su Esegui.

Per ulteriori informazioni su come eseguire query, consulta Eseguire una query interattiva.

bq

Attenzione: questo comando non funziona in Cloud Shell. Per utilizzare questo comando, eseguilo da una riga di comando locale.

Per trovare a quale prenotazione sono assegnati i job di query del progetto, utilizza il comando bq show con il flag --reservation_assignment:

bq show \
    --project_id=ADMIN_PROJECT_ID \
    --location=LOCATION \
    --reservation_assignment \
    --job_type=JOB_TYPE \
    --assignee_id=PROJECT_ID \
    --assignee_type=PROJECT

Sostituisci quanto segue:

• ADMIN_PROJECT_ID: l'ID del progetto che possiede la risorsa di prenotazione
• LOCATION: la posizione delle prenotazioni da visualizzare
• JOB_TYPE: il tipo di job da assegnare a questa prenotazione, ad esempio QUERY, CONTINUOUS (Anteprima), PIPELINE, BACKGROUND o ML_EXTERNAL
• PROJECT_ID: l'ID del progetto

Aggiornare le assegnazioni di prenotazione

Spostare un compito in un'altra prenotazione

Puoi spostare un compito da una prenotazione a un'altra.

Per spostare l'assegnazione di una prenotazione, devi disporre delle seguenti autorizzazioni IAM sul progetto di amministrazione e sull'assegnatario.

• bigquery.reservationAssignments.create
• bigquery.reservationAssignments.delete

Ciascuno dei seguenti ruoli IAM predefiniti include queste autorizzazioni:

• BigQuery Admin
• BigQuery Resource Admin
• BigQuery Resource Editor

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

Per spostare un compito, utilizza il comando bq update:

bq update \
    --project_id=ADMIN_PROJECT_ID \
    --location=LOCATION \
    --reservation_assignment \
    --destination_reservation_id=DESTINATION_RESERVATION \
    ADMIN_PROJECT_ID:LOCATION.RESERVATION_NAME.ASSIGNMENT_ID

Sostituisci quanto segue:

• ADMIN_PROJECT_ID: l'ID del progetto che possiede la risorsa di prenotazione
• LOCATION: la posizione della nuova prenotazione
• RESERVATION_NAME: la prenotazione da cui spostare l'assegnazione
• DESTINATION_RESERVATION: la prenotazione a cui spostare il compito

• ASSIGNMENT_ID: l'ID del compito

  Per ottenere l'ID assegnazione, consulta Elenca l'assegnazione della prenotazione di un progetto.

Eliminazione assegnazioni di prenotazione

Puoi rimuovere un progetto da una prenotazione eliminando l'assegnazione della prenotazione. Se un progetto non è assegnato a nessuna prenotazione, eredita eventuali assegnazioni nelle cartelle o nelle organizzazioni principali oppure utilizza i prezzi on demand se non sono presenti assegnazioni principali.

Quando elimini un'assegnazione di prenotazione, i job in esecuzione con gli slot di quella prenotazione continuano a funzionare fino al completamento.

Autorizzazioni obbligatorie

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

• bigquery.reservationAssignments.delete nel progetto di amministrazione e l'assegnatario.

Ogni uno dei seguenti ruoli IAM predefiniti include questa autorizzazione:

• BigQuery Admin
• BigQuery Resource Admin
• BigQuery Resource Editor

Rimuovere un progetto da una prenotazione

Per rimuovere un progetto da una prenotazione:

Console

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

   Vai a BigQuery

2. Nel pannello di navigazione, vai alla sezione Gestione della capacità.

3. Fai clic sulla scheda Prenotazioni.

4. Nella tabella delle prenotazioni, espandi la prenotazione per trovare il progetto.

5. Espandi l'opzione Azioni.

6. Fai clic su Elimina.

SQL

Utilizza l'istruzione DDL DROP ASSIGNMENT.

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

   Vai a BigQuery

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

   DROP ASSIGNMENT
     `ADMIN_PROJECT_ID.region-LOCATION.RESERVATION_NAME.ASSIGNMENT_ID`;

   Sostituisci quanto segue:

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

   • ASSIGNMENT_ID: l'ID del compito

     Per trovare l'ID assegnazione, consulta Elenca l'assegnazione della prenotazione di un progetto.

3. Fai clic su Esegui.

Per ulteriori informazioni su come eseguire query, consulta Eseguire una query interattiva.

bq

Per rimuovere un progetto da una prenotazione, utilizza il comando bq rm con il --reservation_assignment flag:

bq rm \
    --project_id=ADMIN_PROJECT_ID \
    --location=LOCATION \
    --reservation_assignment RESERVATION_NAME.ASSIGNMENT_ID

Sostituisci quanto segue:

• ADMIN_PROJECT_ID: l'ID del progetto che possiede la risorsa di prenotazione
• LOCATION: la posizione della prenotazione
• RESERVATION_NAME: il nome della prenotazione

• ASSIGNMENT_ID: l'ID del compito

  Per ottenere l'ID assegnazione, consulta Trovare l'assegnazione di prenotazione di un progetto.