Acquista e gestisci impegni slot legacy
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.
Un impegno di capacità è un acquisto di capacità di calcolo BigQuery per per un periodo di tempo minimo. L'acquisto di un impegno di capacità è facoltativo quando creando una prenotazione con una versione, ma puoi consentono di risparmiare sui costi.
Gli impegni sono una risorsa di regione. Impegni acquistati in una regione o non è possibile usare più regioni in altre regioni o regioni multiple. Gli impegni non possono essere spostati tra regioni o tra regioni e in più regioni.
Abilita l'API Reservations
L'API BigQuery Reservation è diversa dall'API esistente nell'API BigQuery e deve essere abilitata in modo indipendente. Per ulteriori informazioni le informazioni, vedi Attivazione e disattivazione delle API.
- Il nome dell'API è "API BigQuery Reservations"
- L'endpoint per l'API BigQuery Reservation è
bigqueryreservation.googleapis.com
.
Acquistare slot
Per riservare capacità per un certo periodo di tempo minimo, puoi acquistare un di capacità. In questo modo ottieni uno sconto e puoi risparmiare sui costi. Per ulteriori informazioni sui costi specifici, vedi Prezzi di BigQuery.
Autorizzazioni obbligatorie
Per creare un impegno di capacità, è necessario quanto segue Autorizzazione Identity and Access Management (IAM):
bigquery.capacityCommitments.create
il progetto di amministrazione che mantenga la proprietà degli impegni.
Ciascuno dei seguenti ruoli IAM predefiniti include autorizzazione:
BigQuery Admin
BigQuery Resource Admin
Per saperne di più sui ruoli IAM in BigQuery, vedi Autorizzazioni e ruoli predefiniti.
Crea un impegno di capacità
Gli impegni sono una risorsa di regione. Impegni acquistati in una regione o non è possibile usare più regioni in altre regioni o regioni multiple. Impegni non possono essere spostati tra regioni o tra regioni e più regioni.
Console
Nella console Google Cloud, vai alla pagina BigQuery.
Nel pannello di navigazione, vai alla sezione Gestione della capacità.
Fai clic su Crea impegno.
In Configura:
- Seleziona la località.
- Nella sezione Modello di capacità, seleziona il modello di capacità.
- Seleziona la Durata dell'impegno, che specifica il tuo impegno. un piano di controllo.
Se acquisti un impegno annuale, seleziona il campo Rinnovo che vuoi implementare alla scadenza dell'impegno:
- Non rinnovare e converti in un impegno mensile (opzione predefinita). Alla scadenza dell'impegno annuale, questo viene convertito in un impegno mensile l'impegno di un'azienda.
- Rinnova annualmente. Alla scadenza, l'impegno annuale si rinnova per un altro anno come impegno annuale.
- Non rinnovare e converti in slot flessibili. Alla scadenza dell'impegno annuale, questo viene convertito in slot flessibili l'impegno di un'azienda.
Per maggiori informazioni, consulta Impegni.
Inserisci il numero di slot che vuoi acquistare.
Fai clic su Avanti.
Controlla la stima del costo per il tuo acquisto.
In Conferma e invia:
- Digita CONFERMA per confermare l'acquisto.
- Fai clic su Acquista per acquistare gli slot.
Per visualizzare l'impegno, fai clic su Visualizza impegni slot. Dopo il viene eseguito il provisioning della capacità, l'impegno di capacità richiesto ha un'icona verde .
La prima volta che acquisti capacità viene creata una prenotazione default
.
SQL
Per creare un impegno di capacità, utilizza
CREATE CAPACITY
Istruzione DDL.
Nella console Google Cloud, vai alla pagina BigQuery.
Nell'editor query, inserisci la seguente istruzione:
CREATE CAPACITY `ADMIN_PROJECT_ID.region-LOCATION.COMMITMENT_ID` OPTIONS ( slot_count = NUMBER_OF_SLOTS, plan = 'PLAN_TYPE');
Sostituisci quanto segue:
ADMIN_PROJECT_ID
: l'ID progetto del progetto di amministrazione che manterrà la proprietà di questo impegnoLOCATION
: il valore località dell'impegnoCOMMITMENT_ID
: l'ID dell'impegnoDeve essere univoco per il progetto e la località. Deve iniziare e terminare con una lettera minuscola o un numero e devono contenere solo lettere minuscole lettere, numeri e trattini.
NUMBER_OF_SLOTS
: il numero di slot da acquistaPLAN_TYPE
: il valore tipo di piano, ad esempioFLEX
,MONTHLY
oANNUAL
.
Fai clic su
Esegui.
Per ulteriori informazioni su come eseguire le query, vedi Eseguire una query interattiva.
bq
Usa il comando bq mk
con
Flag --capacity_commitment
per acquistare slot.
bq mk \ --project_id=ADMIN_PROJECT_ID \ --location=LOCATION \ --capacity_commitment=true \ --plan=PLAN_TYPE \ --slots=NUMBER_OF_SLOTS
Sostituisci quanto segue:
ADMIN_PROJECT_ID
: l'ID progetto del progetto di amministrazione che manterrà la proprietà di questo impegnoLOCATION
: la località dell'impegnoPLAN_TYPE
: il valore tipo di piano, ad esempio comeFLEX
,MONTHLY
oANNUAL
.NUMBER_OF_SLOTS
: il numero di slot da acquisto.
Visualizza gli impegni in termini di capacità
Autorizzazioni obbligatorie
Per visualizzare gli impegni, è necessario quanto segue Identity and Access Management (IAM) autorizzazione:
bigquery.capacityCommitments.list
il progetto di amministrazione che mantenga la proprietà degli impegni.
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.
Visualizza gli impegni in termini di capacità per progetto
Per visualizzare gli impegni in termini di capacità per progetto:
Console
Nella console Google Cloud, vai alla pagina BigQuery.
Nel pannello di navigazione, vai alla sezione Gestione della capacità.
Fai clic sulla scheda Impegni slot. Sono elencati i tuoi impegni in termini di capacità nella tabella in Impegni.
SQL
Per visualizzare gli impegni per un progetto di amministrazione, esegui una query su
INFORMATION_SCHEMA.CAPACITY_COMMITMENTS_BY_PROJECT
visualizzazione.
Nella console Google Cloud, vai alla pagina BigQuery.
Nell'editor query, inserisci la seguente istruzione:
SELECT capacity_commitment_id FROM `region-LOCATION`.INFORMATION_SCHEMA.CAPACITY_COMMITMENTS_BY_PROJECT WHERE project_id = 'ADMIN_PROJECT_ID' AND slot_count = 100;
Sostituisci quanto segue:
LOCATION
: il valore località degli impegniADMIN_PROJECT_ID
: l'ID progetto del progetto di amministrazione che è responsabile degli impegni
Fai clic su
Esegui.
Per ulteriori informazioni su come eseguire le query, vedi Eseguire una query interattiva.
bq
Usa il comando bq ls
con
Flag --capacity_commitment
per elencare gli impegni per un progetto di amministrazione.
bq ls \ --capacity_commitment=true \ --location=LOCATION \ --project_id=ADMIN_PROJECT_ID
Sostituisci quanto segue:
LOCATION
: la località degli impegniADMIN_PROJECT_ID
: l'ID progetto del progetto di amministrazione che è responsabile degli impegni
Aggiornamento impegni relativi alla capacità
Puoi apportare i seguenti aggiornamenti a un impegno di capacità:
- Rinnova un impegno esistente.
- Converti un impegno in un piano di impegno con una durata più lunga.
- Suddividi un impegno in due impegni.
- Unisci due impegni in un unico impegno.
Autorizzazioni obbligatorie
Per aggiornare gli impegni di capacità, devi avere quanto segue Autorizzazione Identity and Access Management (IAM):
bigquery.capacityCommitments.update
il progetto di amministrazione che mantenga la proprietà degli impegni.
Ciascuno dei seguenti ruoli IAM predefiniti include autorizzazione:
BigQuery Admin
BigQuery Resource Admin
Per saperne di più sui ruoli IAM in BigQuery, vedi Autorizzazioni e ruoli predefiniti.
Rinnova un impegno
Gli impegni annuali hanno un piano di rinnovo, che specifichi quando a creare o convertire in un impegno annuale. Puoi modificare le impostazioni piano di rinnovo dell'impegno annuale in qualsiasi momento prima della relativa data di fine.
Console
Puoi cambiare il piano di rinnovo per un impegno annuale come segue:
Nella console Google Cloud, vai alla pagina BigQuery.
Nel pannello di navigazione, vai alla sezione Gestione della capacità.
Fai clic sulla scheda Impegni slot.
Trova l'impegno che vuoi modificare.
Clic
Azioni, quindi seleziona l'opzione Modifica piano di rinnovo.Seleziona il nuovo piano di rinnovo.
bq
Per modificare la scelta del piano di rinnovo per un impegno annuale, utilizza la
Comando bq update
con
Flag --capacity_commitment
e il flag--renewal_plan
.
bq update \ --project_id=ADMIN_PROJECT_ID \ --location=LOCATION \ --renewal_plan=PLAN_TYPE \ --capacity_commitment=true \ COMMITMENT_ID
Sostituisci quanto segue:
ADMIN_PROJECT_ID
: l'ID progetto del progetto di amministrazione che manterrà la proprietà di questo impegnoLOCATION
: la località dell'impegnoPLAN_TYPE
: il valore tipo di piano, ad esempio comeFLEX
,MONTHLY
oANNUAL
.COMMITMENT_ID
: l'ID dell'impegnoPer ottenere l'ID, consulta Visualizzare gli impegni acquistati.
Converti un impegno in una durata maggiore
Puoi scegliere di convertire il tuo impegno in un tipo di impegno di durata più lunga in qualsiasi momento:
- Puoi convertire il tuo impegno per slot flessibili in un impegno mensile o annuale.
- Puoi convertire il tuo impegno mensile in un impegno annuale.
Non appena aggiorni l'impegno, ti viene addebitata la tariffa associati al nuovo piano, e la data di fine viene reimpostata.
Per convertire un impegno, utilizza
Comando bq update
con
Flag --plan
.
bq update \ --project_id=ADMIN_PROJECT_ID \ --location=LOCATION \ --plan=PLAN_TYPE \ --renewal_plan=RENEWAL_PLAN \ --capacity_commitment=true \ COMMITMENT_ID
Sostituisci quanto segue:
ADMIN_PROJECT_ID
: ID progettoLOCATION
: la località dell'impegnoPLAN_TYPE
: il valore tipo di piano, ad esempio comeFLEX
,MONTHLY
oANNUAL
.RENEWAL_PLAN
: il valore rinnovo pianoCiò si applica solo se
PLAN_TYPE
èANNUAL
. SePLAN_TYPE
èMONTHLY
, omettilo flag.COMMITMENT_ID
: l'ID dell'impegnoPer ottenere l'ID, consulta Visualizzare gli impegni acquistati.
Dividi un impegno
Puoi suddividere il tuo impegno in due impegni. Questo può essere utile se voglio rinnovare parte di un impegno. Ad esempio, se disponi di di 1000 slot all'anno, potresti suddividere 300 slot in un nuovo l'impegno originale, lasciando 700 slot nell'impegno originale. Poi puoi rinnovare 700 slot alla con una tariffa annuale e converti 300 slot in slot flessibili dopo la data di fine.
Quando suddividi un impegno, il nuovo impegno ha lo stesso piano e lo stesso data di fine dell'impegno originale.
Console
Nella console Google Cloud, vai alla pagina BigQuery.
Nel pannello di navigazione, vai alla sezione Gestione della capacità.
Fai clic sulla scheda Impegni slot.
Seleziona l'impegno che vuoi suddividere.
Fai clic su Dividi.
Nella pagina Impegno suddiviso, utilizza il cursore Configura la suddivisione per seleziona il numero di slot da inserire in ogni suddivisione, in incrementi di 100 slot.
Fai clic su Dividi per suddividere l'impegno. Il nuovo impegno è elencato in nella scheda Impegni slot.
bq
Per suddividere gli impegni, usa il comando bq update
.
bq update \ --project_id=ADMIN_PROJECT_ID \ --location=LOCATION \ --split \ --slots=SLOTS_TO_SPLIT \ --capacity_commitment=true \ COMMITMENT_ID
Sostituisci quanto segue:
ADMIN_PROJECT_ID
: ID progettoLOCATION
: la località dell'impegnoSLOTS_TO_SPLIT
: il numero di slot da suddividere dall'impegno originale a un nuovo impegnoCOMMITMENT_ID
: l'ID dell'impegnoPer ottenere l'ID, consulta Visualizzare gli impegni acquistati.
Unisci due impegni
Puoi unire più impegni in un unico impegno. Gli impegni per l'unione
devono essere tutti dello stesso tipo (FLEX
, MONTHLY
, ANNUAL
o THREE_YEAR
). Fine
dell'impegno combinato è la data di fine massima dell'impegno originale
impegni. Se qualcuno degli impegni ha una data di fine precedente,
vengono estesi alla data successiva e ti viene addebitato un importo proporzionale
tali slot.
Console
Nella console Google Cloud, vai alla pagina BigQuery.
Nel pannello di navigazione, vai alla sezione Gestione della capacità.
Fai clic sulla scheda Impegni slot.
Seleziona gli impegni che vuoi unire.
Fai clic su Unisci.
Nella pagina Unisci impegni, esamina i dettagli dell'unione e Fai clic su Unisci. Il nuovo impegno unito è elencato nella Scheda Impegni slot.
bq
Per unire due impegni in un unico impegno, utilizza il comando bq update
:
bq update \ --project_id=ADMIN_PROJECT_ID \ --location=LOCATION \ --merge=true \ --capacity_commitment=true \ COMMITMENT1,COMMITMENT2
Sostituisci quanto segue:
ADMIN_PROJECT_ID
: ID progettoLOCATION
: la località degli impegniCOMMITMENT1
: il primo impegno da unireCOMMITMENT2
: il secondo impegno da unire
Elimina un impegno
Puoi eliminare un impegno di capacità se la sua data di fine è nel passato. La data di fine dell'impegno viene visualizzata nella console Google Cloud. Prima di eliminare un impegno, assicurati che sia disponibile un numero sufficiente slot non allocati. In caso contrario, devi diminuire il numero di slot in un o rimuovere del tutto le prenotazioni.
Autorizzazioni obbligatorie
Per eliminare gli impegni di capacità, è necessario quanto segue Autorizzazione Identity and Access Management (IAM):
bigquery.capacityCommitments.delete
il progetto di amministrazione che mantenga la proprietà degli impegni.
Ciascuno dei seguenti ruoli IAM predefiniti include autorizzazione:
BigQuery Admin
BigQuery Resource Admin
Per saperne di più sui ruoli IAM in BigQuery, vedi Autorizzazioni e ruoli predefiniti.
Eliminazione di un impegno di capacità
Console
Per eliminare un impegno di capacità, completa i seguenti passaggi:
Nella console Google Cloud, vai alla pagina BigQuery.
Nel pannello di navigazione, vai alla sezione Gestione della capacità.
Fai clic sulla scheda Impegni slot.
Nell'elenco a discesa Località, seleziona la località appropriata.
Trova l'impegno che vuoi eliminare.
Espandi
Azioni.Fai clic su Elimina.
Digita "RIMUOVI" e fai clic su Procedi.
SQL
Per eliminare un impegno di capacità, utilizza
DROP CAPACITY
Istruzione DDL.
Nella console Google Cloud, vai alla pagina BigQuery.
Nell'editor query, inserisci la seguente istruzione:
DROP CAPACITY `ADMIN_PROJECT_ID.region-LOCATION.COMMITMENT_ID`;
Sostituisci quanto segue:
ADMIN_PROJECT_ID
: il progetto proprietario impegnoLOCATION
: il valore località dell'impegnoCOMMITMENT_ID
: l'ID dell'impegnoPer ottenere l'ID, vedi Visualizza gli impegni acquistati.
Fai clic su
Esegui.
Per ulteriori informazioni su come eseguire le query, vedi Eseguire una query interattiva.
bq
Per eliminare un impegno di capacità, utilizza il comando bq rm
con
Flag --capacity_commitment
:
bq rm \ --project_id=ADMIN_PROJECT_ID \ --location=LOCATION \ --capacity_commitment=true \ COMMITMENT_ID
Sostituisci quanto segue:
ADMIN_PROJECT_ID
: ID progettoLOCATION
: il valore località dell'impegnoCOMMITMENT_ID
: l'ID dell'impegno vuoi eliminarePer ottenere l'ID, consulta Visualizzare gli impegni acquistati.
Risoluzione dei problemi relativi agli impegni in termini di capacità
Questa sezione descrive i passaggi per la risoluzione dei problemi che potrebbero essere utili se riscontrano problemi nell'uso di BigQuery Reservations.
Gli slot acquistati sono in attesa
Gli slot sono soggetti alla capacità disponibile. Quando acquisti impegni per gli slot BigQuery li alloca, poi la colonna Stato mostra un controllo . Se BigQuery non riesce ad allocare immediatamente gli slot richiesti, la colonna Stato rimane In attesa. Potresti dover attendere diverse ore per rendere disponibili gli slot. Se hai bisogno di accedere agli slot prima, prova la seguenti:
- Elimina l'impegno in attesa.
- Acquista un nuovo impegno per un numero inferiore di slot. In base a di capacità elevata, l'impegno minore potrebbe diventare attivo immediatamente.
- Acquista gli slot rimanenti come impegno separato. Questi slot possono vengono visualizzati come in attesa nella colonna Stato, ma in genere diventano attivi. nel giro di poche ore.
- (Facoltativo) Quando entrambi gli impegni sono disponibili, puoi: unirli in un unico impegno, purché tu acquistato lo stesso piano per entrambi.
Se un impegno di slot non riesce o richiede molto tempo, valuta la possibilità di utilizzare prezzi on demand temporaneamente. Con questo potrebbe essere necessario eseguire query critiche su un altro progetto non assegnato ad alcuna prenotazione o potresti dover rimuovere il progetto assegnata al suo interno.