Questa pagina è stata tradotta dall'API Cloud Translation.

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

Crea assegnazioni di prenotazione

Per utilizzare gli slot che acquisti, devi creare un compito che assegna un un progetto, una cartella o un'organizzazione a una prenotazione di slot.

I progetti utilizzano la prenotazione più specifica nella gerarchia delle risorse a cui sono assegnati. Un'assegnazione a una cartella ha la precedenza su un'organizzazione mentre un'assegnazione di progetto sostituisce l'assegnazione a una cartella. Cartelle e le assegnazioni dell'organizzazione non sono disponibili per standard di Google Cloud.

Per creare un'assegnazione in una prenotazione, quest'ultima deve completare almeno uno dei seguenti criteri:

È configurato con una quantità diversa da zero di slot di riferimento assegnati.
È configurato con una quantità diversa da zero di slot a scalabilità automatica.
È configurato per utilizzare slot inattivi e sono disponibili slot inattivi all'interno del progetto.

Se tenti di assegnare una risorsa a una prenotazione che non soddisfa almeno uno di questi criteri, riceverai quanto segue: messaggio: Assignment is pending, your project will be executed as on-demand.

Puoi assegnare una risorsa a un failover , ma l'assegnazione pende nella località secondaria.

Autorizzazioni obbligatorie

Per creare un'assegnazione della prenotazione, è necessario quanto segue Autorizzazione Identity and Access Management (IAM):

bigquery.reservationAssignments.create il progetto di amministrazione e l'assegnatario.

Ciascuno dei seguenti ruoli IAM predefiniti include autorizzazione:

BigQuery Admin
BigQuery Resource Admin
BigQuery Resource Editor

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

Assegnare un'organizzazione a una prenotazione

Console

Nella console Google Cloud, vai alla pagina BigQuery.

Vai a BigQuery
Nel pannello di navigazione, vai alla sezione Gestione della capacità.
Fai clic sulla scheda Prenotazioni.
Cercare una prenotazione nella tabella delle prenotazioni.
Espandi Azioni.
Fai clic su Crea compito.
Nella sezione Crea un compito, fai clic su Sfoglia.
Sfoglia o cerca l'organizzazione e selezionala.
Nella sezione Tipo di prestazione, seleziona un tipo di prestazione da assegnare per questa prenotazione. Sono incluse le seguenti opzioni:
- QUERY
- PIPELINE
- BACKGROUND
- ML_EXTERNAL
Per ulteriori informazioni sui tipi di prestazione, consulta assegnazioni di prenotazione. Questo valore predefinito è QUERY.
Fai clic su Crea.

SQL

Per assegnare un'organizzazione a una prenotazione, utilizza la CREATE ASSIGNMENT Istruzione DDL.

Nella console Google Cloud, vai alla pagina BigQuery.

Vai a BigQuery
Nell'editor 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 progetto del progetto di amministrazione proprietario della risorsa di prenotazione
- LOCATION: il valore località della prenotazione
- RESERVATION_NAME: il nome del prenotazione
- ASSIGNMENT_ID: l'ID del compito
  
  L'ID deve essere univoco per il progetto e la località, iniziano e terminano con una lettera minuscola o un numero e contenere solo lettere minuscole, numeri e trattini.
- ORGANIZATION_ID: il valore ID organizzazione
- JOB_TYPE: il tipo di lavoro da assegnare a questa prenotazione, ad esempio QUERY, PIPELINE, BACKGROUND o ML_EXTERNAL
Fai clic su Esegui.

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

bq

Per assegnare job di un'organizzazione a una prenotazione, usa 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 progetto del progetto di amministrazione proprietario della risorsa di prenotazione
LOCATION: il valore località della prenotazione
RESERVATION_NAME: il nome del prenotazione
ORGANIZATION_ID: il valore ID organizzazione
JOB_TYPE: il tipo di lavoro da assegnare a questa prenotazione, ad esempio QUERY, PIPELINE, BACKGROUND o ML_EXTERNAL

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

Assegnare un progetto o una cartella a una prenotazione

Console

Nella console Google Cloud, vai alla pagina BigQuery.

Vai a BigQuery
Nel pannello di navigazione, vai alla sezione Gestione della capacità.
Fai clic sulla scheda Prenotazioni.
Cerca la prenotazione nella tabella delle prenotazioni.
Espandi Azioni.
Fai clic su Crea compito.
Nella sezione Crea un compito, fai clic su Sfoglia.
Sfoglia o cerca il progetto o la cartella e selezionalo.
Nella sezione Tipo di prestazione, seleziona un tipo di prestazione da assegnare per questa prenotazione. Sono incluse le seguenti opzioni:
- QUERY
- PIPELINE
- BACKGROUND
- ML_EXTERNAL
Per ulteriori informazioni sui tipi di prestazione, consulta assegnazioni di prenotazione. Questo valore predefinito è QUERY.
Fai clic su Crea.

SQL

Per assegnare un progetto a una prenotazione, utilizza il metodo CREATE ASSIGNMENT Istruzione DDL.

Nella console Google Cloud, vai alla pagina BigQuery.

Vai a BigQuery
Nell'editor 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 progetto del progetto di amministrazione proprietario della risorsa di prenotazione
- LOCATION: il valore località della prenotazione
- RESERVATION_NAME: il nome del prenotazione
- ASSIGNMENT_ID: l'ID del compito
  
  L'ID deve essere univoco per il progetto e la località, iniziano e terminano 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 lavoro da assegnare a questa prenotazione, ad esempio QUERY, PIPELINE, BACKGROUND o ML_EXTERNAL
Fai clic su Esegui.

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

bq

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

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 progetto del progetto di amministrazione proprietario della risorsa di prenotazione
LOCATION: il valore località della prenotazione
RESERVATION_NAME: il nome del prenotazione
PROJECT_ID: l'ID del progetto da assegnare a questa prenotazione
JOB_TYPE: il tipo di lavoro da assegnare a questa prenotazione, ad esempio QUERY, PIPELINE, BACKGROUND o ML_EXTERNAL

Terraform

Utilizza la google_bigquery_reservation_assignment risorsa.

Per eseguire l'autenticazione in BigQuery, configura il valore predefinito dell'applicazione Credenziali. Per ulteriori informazioni, vedi Configura l'autenticazione per le librerie client.

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

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 a un progetto Google Cloud, completa i passaggi nella le sezioni seguenti.

Prepara Cloud Shell

Avvia Cloud Shell.
Imposta il progetto Google Cloud predefinito dove 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 in Terraform di configurazione del deployment.

Prepara la directory

Ogni file di configurazione Terraform deve avere una directory (inoltre chiamato modulo principale).

In Cloud Shell, crea una directory e un nuovo all'interno di quella directory. Il nome del file deve contenere .tf, ad esempio main.tf. In questo tutorial, il file è denominato main.tf.
```
mkdir DIRECTORY && cd DIRECTORY && touch main.tf
```
Se stai seguendo un tutorial, puoi copiare il codice campione in ogni sezione o passaggio.

Copia il codice campione nel nuovo oggetto main.tf.

Facoltativamente, copia il codice da GitHub. Opzione consigliata quando lo snippet Terraform fa parte di una soluzione end-to-end.
Esamina e modifica i parametri di esempio da applicare al tuo ambiente.
Salva le modifiche.
Inizializza Terraform. Devi eseguire questa operazione una sola volta per directory.
```
terraform init
```
Facoltativamente, per utilizzare la versione più recente del provider Google, includi -upgrade :
```
terraform init -upgrade
```

Applica le modifiche

Rivedi la configurazione e verifica che le risorse che Terraform creerà o che l'aggiornamento soddisfi le tue aspettative:
```
terraform plan
```
Apporta le correzioni necessarie alla configurazione.
Applica la configurazione Terraform eseguendo questo comando e inserendo yes alla richiesta:
```
terraform apply
```
Attendi finché Terraform non visualizzi il messaggio "Applicazione completata!". .
Apri il progetto Google Cloud per visualizzare i risultati. Nella console Google Cloud, vai alle risorse nella UI per assicurarti create o aggiornate da Terraform.

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

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

Assegna un progetto a `none`

I compiti a none rappresentano l'assenza di un compito. Progetti assegnati per none utilizza i prezzi on demand.

SQL

Per assegnare un progetto a none, usa la CREATE ASSIGNMENT Istruzione DDL.

Nella console Google Cloud, vai alla pagina BigQuery.

Vai a BigQuery
Nell'editor query, inserisci la seguente istruzione:
```
CREATE ASSIGNMENT
  `ADMIN_PROJECT_ID.region-LOCATION.none.ASSIGNMENT_ID`
OPTIONS(
  assignee="projects/PROJECT_ID",
  job_type="JOB_TYPE");
```
Sostituisci quanto segue:
- LOCATION: il valore località delle offerte di lavoro da utilizzare on demand prezzi
- ASSIGNMENT_ID: l'ID del compito
  
  L'ID deve essere univoco per il progetto e la località, iniziano e terminano 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
Fai clic su Esegui.

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

bq

Per assegnare un progetto a none, usa il comando bq mk con la Flag --reservation_assignment:

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

Sostituisci quanto segue:

LOCATION: la località di offerte di lavoro che dovrebbero utilizzare i prezzi on demand
PROJECT_ID: l'ID del progetto da assegnare a none

Assegna slot ai carichi di lavoro BigQuery ML

I seguenti tipi di modelli BigQuery ML utilizzano servizi esterni:

Puoi assegnare slot prenotati alle query che utilizzano questi servizi utilizzando il tipo di assegnazione ML_EXTERNAL. Se non viene trovato alcun tipo di assegnazione ML_EXTERNAL, il job di query viene eseguito on demand.

Usa il comando bq mk con il flag --reservation_assignment e impostalo il flag --job_type a ML_EXTERNAL.

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

Sostituisci quanto segue:

ADMIN_PROJECT_ID: l'ID del progetto che è proprietario della risorsa di prenotazione
LOCATION: la località della prenotazione
RESERVATION_NAME: il nome della prenotazione
PROJECT_ID: l'ID del progetto da assegnare a questa prenotazione

Trova assegnazioni di prenotazione

Autorizzazioni obbligatorie

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

bigquery.reservationAssignments.list nel progetto di amministrazione.

Ciascuno dei seguenti ruoli IAM predefiniti include autorizzazione:

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

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

Trova l'assegnazione della prenotazione di un progetto

Puoi scoprire se il tuo progetto, la tua cartella o la tua organizzazione sono assegnati a un effettuando la seguente procedura:

Console

Nella console Google Cloud, vai alla pagina BigQuery.

Vai a BigQuery
Nel pannello di navigazione, vai alla sezione Gestione della capacità.
Fai clic sulla scheda Prenotazioni.
Nella tabella delle prenotazioni, espandi una prenotazione per vedere quali risorse sono assegnati alla prenotazione oppure utilizza il campo Filtro per filtrare in base al nome della risorsa.

SQL

Per trovare a quale prenotazione sono assegnati i job di query del tuo progetto, la vista INFORMATION_SCHEMA.ASSIGNMENTS_BY_PROJECT.

Nella console Google Cloud, vai alla pagina BigQuery.

Vai a BigQuery
Nell'editor 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: il valore posizione di prenotazioni da visualizzare
- ADMIN_PROJECT_ID: l'ID progetto del progetto di amministrazione proprietario della risorsa di prenotazione
- PROJECT_ID: l'ID del progetto da assegnare alla prenotazione
- JOB_TYPE: il tipo di lavoro da assegnare a questa prenotazione, ad esempio QUERY, PIPELINE, BACKGROUND o ML_EXTERNAL
Fai clic su Esegui.

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

bq

Per trovare a quale prenotazione sono assegnati i job di query del tuo progetto, utilizza la classe 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 è proprietario della risorsa di prenotazione
LOCATION: la località di prenotazioni da visualizzare
JOB_TYPE: il tipo di lavoro da assegnare a questa prenotazione, ad esempio QUERY, PIPELINE, BACKGROUND o ML_EXTERNAL
PROJECT_ID: l'ID del progetto

Aggiorna assegnazioni di prenotazione

Spostare un'assegnazione in una prenotazione diversa

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

Per spostare un'assegnazione di prenotazione, è necessario quanto segue nelle autorizzazioni IAM (Identity and Access Management) progetto di amministrazione e l'assegnatario.

bigquery.reservationAssignments.create
bigquery.reservationAssignments.delete

Ciascuno dei seguenti ruoli IAM predefiniti include questi autorizzazioni:

BigQuery Admin
BigQuery Resource Admin
BigQuery Resource Editor

Per saperne di più sui ruoli IAM in BigQuery, vedi Autorizzazioni e ruoli 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 è proprietario della risorsa di prenotazione
LOCATION: la località della nuova prenotazione
RESERVATION_NAME: la prenotazione per spostare compito da
DESTINATION_RESERVATION: il valore prenotazione in cui spostare l'assegnazione
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 eliminandola compito. Se un progetto non è assegnato a nessuna prenotazione, eredita i compiti nelle rispettive cartelle o organizzazioni principali oppure usa le se non ci sono assegnazioni padre.

Quando elimini un'assegnazione di prenotazione, i job in esecuzione con gli slot la prenotazione continuerà a essere eseguita fino al completamento.

Autorizzazioni obbligatorie

Per eliminare un'assegnazione di prenotazione, è necessario quanto segue Autorizzazione Identity and Access Management (IAM):

bigquery.reservationAssignments.delete il progetto di amministrazione e l'assegnatario.

Ciascuno dei seguenti ruoli IAM predefiniti include autorizzazione:

BigQuery Admin
BigQuery Resource Admin
BigQuery Resource Editor

Rimuovere un progetto da una prenotazione

Per rimuovere un progetto da una prenotazione:

Console

Nella console Google Cloud, vai alla pagina BigQuery.

Vai a BigQuery
Nel pannello di navigazione, vai alla sezione Gestione della capacità.
Fai clic sulla scheda Prenotazioni.
Nella tabella delle prenotazioni, espandi la prenotazione per trovare progetto.
Espandi Azioni.
Fai clic su Elimina.

SQL

Utilizza la DROP ASSIGNMENT Istruzione DDL.

Nella console Google Cloud, vai alla pagina BigQuery.

Vai a BigQuery
Nell'editor query, inserisci la seguente istruzione:
```
DROP ASSIGNMENT
  `ADMIN_PROJECT_ID.region-LOCATION.RESERVATION_NAME.ASSIGNMENT_ID`;
```
Sostituisci quanto segue:
- ADMIN_PROJECT_ID: l'ID progetto del progetto di amministrazione proprietario della risorsa di prenotazione
- LOCATION: il valore località della prenotazione
- RESERVATION_NAME: il nome del prenotazione
- ASSIGNMENT_ID: l'ID del compito
  
  Per trovare l'ID compito, consulta: Elenca l'assegnazione della prenotazione di un progetto.
Fai clic su Esegui.

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

bq

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

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 è proprietario della risorsa di prenotazione
LOCATION: la località della prenotazione
RESERVATION_NAME: il nome del prenotazione
ASSIGNMENT_ID: l'ID del compito

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

Utilizzare le assegnazioni delle prenotazioni

Crea assegnazioni di prenotazione

Autorizzazioni obbligatorie

Assegnare un'organizzazione a una prenotazione

Console

SQL

bq

Assegnare un progetto o una cartella a una prenotazione

Console

SQL

bq

Terraform

Prepara Cloud Shell

Prepara la directory

Applica le modifiche

Assegna un progetto a none

SQL

bq

Assegna slot ai carichi di lavoro BigQuery ML

Trova assegnazioni di prenotazione

Autorizzazioni obbligatorie

Trova l'assegnazione della prenotazione di un progetto

Console

SQL

bq

Aggiorna assegnazioni di prenotazione

Spostare un'assegnazione in una prenotazione diversa

Eliminazione assegnazioni di prenotazione

Autorizzazioni obbligatorie

Rimuovere un progetto da una prenotazione

Console

SQL

bq

Assegna un progetto a `none`