Lavorare con le prenotazioni di slot legacy
L'API BigQuery Reservation consente di acquistare slot dedicati (chiamati impegni), creare pool di slot (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. Puoi creare una prenotazione denominata prod
e assegnare i tuoi carichi di lavoro di produzione a questa prenotazione. Per maggiori informazioni, consulta la sezione
Prenotazioni.
Crea prenotazioni
Autorizzazioni obbligatorie
Per creare una prenotazione, devi disporre della seguente autorizzazione Identity and Access Management (IAM):
bigquery.reservations.create
sul progetto di amministrazione che mantiene la proprietà degli impegni.
Ciascuno dei seguenti ruoli IAM predefiniti include questa autorizzazione:
BigQuery Admin
BigQuery Resource Admin
BigQuery Resource Editor
Per ulteriori informazioni sui ruoli IAM in BigQuery, vedi Ruoli e autorizzazioni predefiniti.
Crea una prenotazione con slot dedicati
Seleziona una delle seguenti opzioni:
Console
Nella console Google Cloud, vai alla pagina BigQuery.
Nel pannello di navigazione, vai alla sezione Gestione della capacità.
Fai clic su Crea prenotazione.
Nel campo Nome prenotazione, inserisci un nome per la prenotazione.
Nell'elenco a discesa Località, seleziona la località.
Nella sezione Modello di capacità, seleziona il modello di capacità.
Se selezioni l'opzione Tariffa fissa, in Slot di riferimento, inserisci il numero di slot per la prenotazione.
- Nell'elenco Selettore Dimensione massima prenotazione, seleziona la dimensione massima della prenotazione.
(Facoltativo) Nel campo Slot di riferimento, inserisci il numero di slot di riferimento per la prenotazione. Per utilizzare solo la capacità degli slot specificata, fai clic sul pulsante di attivazione/disattivazione Ignora gli slot inattivi.
La quantità di slot a scalabilità automatica disponibili è determinata sottraendo il valore degli slot di riferimento dal valore massimo della dimensione di prenotazione. Ad esempio, se crei una prenotazione con 100 slot di riferimento e una dimensione massima della prenotazione di 400, la prenotazione avrà 300 slot con scalabilità automatica. Per ulteriori informazioni sugli slot di riferimento, consulta Utilizzo delle prenotazioni con slot di riferimento e con scalabilità automatica.
Per disattivare la condivisione degli slot inattivi, fai clic sul pulsante di attivazione/disattivazione Ignora gli slot inattivi.
La suddivisione degli slot viene visualizzata nella tabella Stima dei costi. Un riepilogo della prenotazione viene visualizzato nella tabella Riepilogo della capacità.
Fai clic su Salva.
La nuova prenotazione è visibile nella scheda Prenotazioni.
SQL
Per creare una prenotazione, utilizza
l'istruzione DDL CREATE RESERVATION
.
Nella console Google Cloud, vai alla pagina BigQuery.
Nell'editor query, inserisci la seguente istruzione:
CREATE RESERVATION `ADMIN_PROJECT_ID.region-LOCATION.RESERVATION_NAME` OPTIONS ( slot_capacity = NUMBER_OF_SLOTS, );
Sostituisci quanto segue:
ADMIN_PROJECT_ID
: l'ID del progetto di amministrazione proprietario della risorsa di prenotazioneLOCATION
: la località della prenotazione. Se selezioni una località BigQuery Omni, l'opzione relativa alla versione è limitata alla versione Enterprise.RESERVATION_NAME
: il nome della prenotazioneDeve iniziare e terminare con una lettera minuscola o un numero e contenere solo lettere minuscole, numeri e trattini.
NUMBER_OF_SLOTS
: il numero di slot da allocare alla prenotazione. L'impegno deve contenere un numero sufficiente di slot non allocati. Non puoi impostare l'opzioneslot_capacity
e l'opzioneedition
nella stessa prenotazione.EDITION
: la versione della prenotazione. L'assegnazione di una prenotazione a una versione comporta modifiche alle funzionalità e ai prezzi. Per saperne di più, consulta Introduzione alle versioni di BigQuery.NUMBER_OF_AUTOSCALING_SLOTS
: il numero di slot a scalabilità automatica assegnati alla prenotazione. Disponibile solo quando è specificata l'opzioneedition
.
Fai clic su
Esegui.
Per ulteriori informazioni su come eseguire le query, vedi 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_SLOTS \ --ignore_idle_slots=false \ RESERVATION_NAME
Sostituisci quanto segue:
ADMIN_PROJECT_ID
: ID progettoLOCATION
: la località della prenotazione. Se selezioni una località BigQuery Omni, l'opzione per la versione è limitata alla versione Enterprise.NUMBER_OF_SLOTS
: il numero di slot da allocare alla prenotazioneNell'impegno deve essere presente un numero sufficiente di slot non allocati.
RESERVATION_NAME
: il nome della prenotazioneEDITION
: la versione della prenotazione. L'assegnazione di una prenotazione a una versione comporta modifiche alle funzionalità e ai prezzi. Per saperne di più, consulta Introduzione alle versioni di BigQuery.NUMBER_OF_AUTOSCALING_SLOTS
: il numero di slot a scalabilità automatica assegnati alla prenotazione. Disponibile solo quando è specificata l'opzioneedition
.
Per informazioni sul flag --ignore_idle_slots
, consulta la pagina
Slot inattivi. Il valore predefinito è false
.
Python
Aggiorna prenotazioni
Puoi apportare i seguenti aggiornamenti a una prenotazione:
- Modifica la dimensione della prenotazione aggiungendo o rimuovendo slot.
- Configura se le query in questa prenotazione utilizzano slot inattivi.
- Modifica la quantità di slot di riferimento o di scalabilità automatica allocate in una prenotazione.
Autorizzazioni obbligatorie
Per aggiornare una prenotazione, devi disporre della seguente autorizzazione Identity and Access Management (IAM):
bigquery.reservations.update
sul progetto di amministrazione che mantiene la proprietà degli impegni.
Ciascuno dei seguenti ruoli IAM predefiniti include questa autorizzazione:
BigQuery Admin
BigQuery Resource Admin
BigQuery Resource Editor
Per ulteriori informazioni 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
Nella console Google Cloud, vai alla pagina BigQuery.
Nel pannello di navigazione, vai alla sezione Gestione della capacità.
Fai clic sulla scheda Prenotazioni.
Trova la prenotazione da aggiornare.
Espandi l'opzione
Azioni.Fai clic su Modifica.
Nella finestra di dialogo Selettore Dimensione massima prenotazione, inserisci la dimensione massima della prenotazione.
Nel campo Slot di riferimento, inserisci il numero di slot di riferimento.
Fai clic su Salva.
SQL
Per modificare le dimensioni di una prenotazione, utilizza
l'istruzione DDL (Data Definition Language) di ALTER RESERVATION SET OPTIONS
.
Nella console Google Cloud, vai alla pagina BigQuery.
Nell'editor query, inserisci la seguente istruzione:
ALTER RESERVATION `ADMIN_PROJECT_ID.region-LOCATION.RESERVATION_NAME` SET OPTIONS ( slot_capacity = NUMBER_OF_SLOTS, );
Sostituisci quanto segue:
ADMIN_PROJECT_ID
: l'ID del progetto di amministrazione proprietario della risorsa di prenotazioneLOCATION
: la località della prenotazione, ad esempioeurope-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_SLOTS
: il numero di slot da allocare alla prenotazione.
Fai clic su
Esegui.
Per ulteriori informazioni su come eseguire le query, vedi 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_SLOTS \ --reservation RESERVATION_NAME
Sostituisci quanto segue:
ADMIN_PROJECT_ID
: ID progettoLOCATION
: la località della prenotazioneNUMBER_OF_SLOTS
: il numero di slot da allocare alla prenotazioneRESERVATION_NAME
: il nome della prenotazione
Python
Configura se le query utilizzano slot inattivi
Il flag --ignore_idle_slots
consente di stabilire se le query in esecuzione in una prenotazione
possono usare slot inattivi di altre prenotazioni. Per maggiori informazioni, consulta
Slot inattivi. Puoi aggiornare questa
configurazione su una prenotazione esistente.
Per aggiornare una prenotazione, utilizza il comando bq update
con il flag
--reservation
. Nell'esempio seguente, --ignore_idle_slots
è impostato su true
,
il che significa che la prenotazione utilizzerà solo gli slot assegnati alla prenotazione.
bq update \ --project_id=ADMIN_PROJECT_ID \ --location=LOCATION \ --ignore_idle_slots=true \ --reservation RESERVATION_NAME
Sostituisci quanto segue:
ADMIN_PROJECT_ID
: ID progettoLOCATION
: la località della prenotazioneRESERVATION_NAME
: il nome della prenotazione
Elenca la configurazione degli slot inattivi
Per visualizzare l'impostazione degli slot inattivi per una prenotazione:
SQL
Esegui una query sulla colonna ignore_idle_slots
della
vista INFORMATION_SCHEMA.RESERVATIONS_BY_PROJECT
.
Nella console Google Cloud, vai alla pagina BigQuery.
Nell'editor 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 del progetto di amministrazione proprietario delle risorse di prenotazioneLOCATION
: la località delle prenotazioni
Fai clic su
Esegui.
Per ulteriori informazioni su come eseguire le query, vedi 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 del progetto di amministrazione proprietario delle risorse di prenotazioneLOCATION
: la località delle prenotazioni
Il campo ignoreIdleSlots
contiene l'impostazione di configurazione.
Elimina prenotazioni
Quando elimini una prenotazione, tutti i job attualmente in esecuzione con slot di quella prenotazione non riusciranno. 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):
bigquery.reservations.delete
sul progetto di amministrazione che mantiene la proprietà degli impegni.
Ciascuno dei seguenti ruoli IAM predefiniti include questa autorizzazione:
BigQuery Admin
BigQuery Resource Admin
BigQuery Resource Editor
Per ulteriori informazioni sui ruoli IAM in BigQuery, vedi Ruoli e autorizzazioni predefiniti.
Eliminazione di una prenotazione
Console
Nella console Google Cloud, vai alla pagina BigQuery.
Nel pannello di navigazione, vai alla sezione Gestione della capacità.
Fai clic sulla scheda Prenotazioni.
Trova la prenotazione da eliminare.
Espandi l'opzione
Azioni.Fai clic su Elimina.
Nella finestra di dialogo Elimina prenotazione, fai clic su Elimina.
SQL
Per eliminare una prenotazione, utilizza
l'istruzione DDL DROP RESERVATION
.
Nella console Google Cloud, vai alla pagina BigQuery.
Nell'editor query, inserisci la seguente istruzione:
DROP RESERVATION `ADMIN_PROJECT_ID.region-LOCATION.RESERVATION_NAME`;
Sostituisci quanto segue:
ADMIN_PROJECT_ID
: l'ID del progetto di amministrazione proprietario della risorsa di prenotazioneLOCATION
: la località della prenotazioneRESERVATION_NAME
: l'ID della prenotazione
Fai clic su
Esegui.
Per ulteriori informazioni su come eseguire le query, vedi 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 del progetto di amministrazione proprietario della risorsa di prenotazioneLOCATION
: la località della prenotazioneRESERVATION_NAME
: il nome della prenotazione
Python
Aggiungi l'API BigQuery Reservation ai Controlli di servizio VPC
L'API BigQuery Reservation supporta Controlli di servizio VPC. Per integrare l'API BigQuery Reservation con i 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. Durante la creazione di un'assegnazione, i Controlli di servizio VPC proteggono il progetto di amministrazione e il progetto, la cartella e l'organizzazione dell'assegnatario.