Acquista e gestisci gli impegni per gli 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 un determinato periodo di tempo minimo. L'acquisto di un impegno di capacità è facoltativo quando crei una prenotazione con una versione, ma può farti risparmiare sui costi.

Gli impegni sono una risorsa di regione. Gli impegni acquistati in una o più regioni non possono essere utilizzati in altre regioni o in più regioni. Gli impegni non possono essere spostati da una regione all'altra o tra regioni e più regioni.

Abilita l'API Reservations

L'API BigQuery Reservation è diversa dall'API BigQuery esistente e deve essere abilitata in modo indipendente. Per maggiori informazioni, consulta Attivare e disattivare le API.

  • Il nome dell'API è "API BigQuery Reservations"
  • L'endpoint per l'API BigQuery Reservation è bigqueryreservation.googleapis.com.

Abilita l'API.

Acquistare slot

Per prenotare la capacità per un periodo di tempo minimo, puoi acquistare un impegno di capacità. In questo modo puoi usufruire di uno sconto e risparmiare sui costi. Per ulteriori informazioni sui costi specifici, consulta la pagina Prezzi di BigQuery.

Autorizzazioni obbligatorie

Per creare un impegno di capacità, devi disporre della seguente autorizzazione IAM (Identity and Access Management):

Ogni uno dei seguenti ruoli IAM predefiniti include questa autorizzazione:

  • BigQuery Admin
  • BigQuery Resource Admin

Per ulteriori informazioni sui ruoli IAM in BigQuery, consulta Ruoli e autorizzazioni predefiniti.

Creare un impegno di capacità

Gli impegni sono una risorsa di regione. Gli impegni acquistati in una o più regioni non possono essere utilizzati in altre regioni o in più regioni. Gli impegni non possono essere spostati da una regione all'altra o tra regioni e più regioni.

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 su Crea impegno.

  4. In Configura:

    1. Seleziona la località.
    2. Nella sezione Modello di capacità, seleziona il modello di capacità.
    3. Seleziona la Durata impegno, che specifica il piano di impegno.

    4. Se acquisti un impegno annuale, seleziona il piano di rinnovo che vuoi che venga applicato alla scadenza dell'impegno:

      1. Non rinnovare e converti in un impegno mensile (impostazione predefinita). Al termine dell'impegno annuale, questo si trasforma in un impegno mensile.
      2. Rinnovare ogni anno. Alla scadenza dell'impegno annuale, l'abbonamento si rinnova per un altro anno come impegno annuale.
      3. Non rinnovare e converti in slot flessibili. Al termine dell'impegno annuale, questo si trasforma in un impegno per gli spazi flessibili.

      Per ulteriori informazioni, consulta Impegni.

    5. Inserisci il numero di slot che vuoi acquistare.

    6. Fai clic su Avanti.

  5. Controlla la stima del costo per il tuo acquisto.

  6. In Conferma e invia:

    1. Digita CONFIRM per confermare l'acquisto.
    2. Fai clic su Acquista per acquistare gli slot.

  7. Per visualizzare l'impegno, fai clic su Visualizza impegni slot. Dopo aver eseguito il provisioning della capacità, l'impegno di capacità richiesto ha uno stato verde.

    Impegni di slot.

La prima volta che acquisti la capacità, viene creata una prenotazione default.

SQL

Per creare un impegno di capacità, utilizza l'istruzione DDL CREATE CAPACITY.

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

    Vai a BigQuery

  2. Nell'editor di 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 del progetto di amministrazione che manterrà la proprietà di questo impegno
    • LOCATION: la posizione dell'impegno

    • COMMITMENT_ID: l'ID dell'impegno

      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.

    • NUMBER_OF_SLOTS: il numero di slot da acquistare
    • PLAN_TYPE: il tipo di piano, ad esempio FLEX, MONTHLY o ANNUAL.

  3. Fai clic su Esegui.

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

bq

Utilizza il comando bq mk con il flag --capacity_commitment per acquistare gli 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 del progetto di amministrazione che manterrà la proprietà di questo impegno
  • LOCATION: la posizione dell'impegno
  • PLAN_TYPE: il tipo di piano, ad esempio FLEX, MONTHLY o ANNUAL.
  • NUMBER_OF_SLOTS: il numero di slot da acquistare.

Visualizza impegni di capacità

Autorizzazioni obbligatorie

Per visualizzare gli impegni, devi disporre della seguente autorizzazione IAM (Identity and Access Management):

Ogni uno dei seguenti ruoli IAM predefiniti include questa autorizzazione:

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

Per ulteriori informazioni sui ruoli IAM in BigQuery, consulta Ruoli e autorizzazioni predefiniti.

Visualizzare gli impegni di capacità per progetto

Per visualizzare gli impegni di capacità per progetto:

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 Impegni slot. I tuoi impegni di capacità sono elencati nella tabella in Impegni.

    Impegni di slot.

SQL

Per visualizzare gli impegni per un progetto di amministrazione, esegui una query sulla visualizzazione INFORMATION_SCHEMA.CAPACITY_COMMITMENTS_BY_PROJECT.

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

    Vai a BigQuery

  2. Nell'editor di 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:

  3. Fai clic su Esegui.

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

bq

Utilizza il comando bq ls con il 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:

Aggiornamento impegni relativi alla capacità

Puoi apportare i seguenti aggiornamenti a un impegno relativo alla capacità:

  • Rinnovare un impegno esistente.
  • Convertire un impegno in un piano con impegno di durata maggiore.
  • Suddividi un impegno in due impegni.
  • Unisci due impegni in un unico impegno.

Autorizzazioni obbligatorie

Per aggiornare gli impegni di capacità, devi disporre della seguente autorizzazione IAM (Identity and Access Management):

Ognuno dei seguenti ruoli IAM predefiniti include questa autorizzazione:

  • BigQuery Admin
  • BigQuery Resource Admin

Per ulteriori informazioni sui ruoli IAM in BigQuery, consulta Ruoli e autorizzazioni predefiniti.

Rinnovare un impegno

Gli impegni annuali hanno un piano di rinnovo, che specifichi quando crei o converti un impegno annuale. Puoi modificare il piano di rinnovo dell'impegno annuale in qualsiasi momento prima della data di fine dell'impegno.

Console

Puoi modificare il piano di rinnovo per un impegno annuale nel seguente modo:

  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 Impegni slot.

  4. Trova l'impegno che vuoi modificare.

  5. Fai clic su Azioni e poi seleziona l'opzione Modifica piano di rinnovo.

  6. Seleziona il nuovo piano di rinnovo.

bq

Per modificare la scelta del piano di rinnovo per un impegno annuale, utilizza il comando bq update con il 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:

Convertire un impegno in una durata più lunga

Puoi scegliere di convertire il tuo impegno in un tipo di impegno di durata più lunga in qualsiasi momento:

  • Puoi convertire l'impegno per gli 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 associata al nuovo piano e la data di fine viene reimpostata.

Per convertire un impegno, utilizza il comando bq update con il 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: l'ID progetto
  • LOCATION: la posizione dell'impegno
  • PLAN_TYPE: il tipo di piano, ad esempio FLEX, MONTHLY o ANNUAL.

  • RENEWAL_PLAN: il piano di rinnovo

    Questo vale solo se PLAN_TYPE è ANNUAL. Se PLAN_TYPE è MONTHLY, ometti questo indicatore.

  • COMMITMENT_ID: l'ID dell'impegno

    Per ottenere l'ID, consulta Visualizza gli impegni acquistati.

Suddividere un impegno

Puoi suddividere l'impegno in due impegni. Questa operazione può essere utile se vuoi rinnovare parte di un impegno. Ad esempio, se hai un impegno annuale di 1000 slot, puoi suddividere 300 slot in un nuovo impegno, lasciando 700 slot nell'impegno originale. Potresti quindi rinnovare 700 slot alla tariffa annuale e convertire 300 slot in slot flessibili dopo la data di fine.

Quando dividi un impegno, il nuovo impegno ha lo stesso piano e la stessa data di fine dell'impegno originale.

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 Impegni slot.

  4. Seleziona l'impegno che vuoi suddividere.

  5. Fai clic su Dividi.

  6. Nella pagina Piano di suddivisione, utilizza il dispositivo di scorrimento Configura suddivisione per selezionare il numero di slot da includere in ogni suddivisione, con incrementi di 100 slot.

  7. Fai clic su Dividi per suddividere l'impegno. Il nuovo impegno è elencato nella scheda Impegni di slot.

bq

Per suddividere gli impegni, utilizza 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: l'ID progetto
  • LOCATION: la posizione dell'impegno
  • SLOTS_TO_SPLIT: il numero di slot da suddividere dall'impegno originale in un nuovo impegno

  • COMMITMENT_ID: l'ID dell'impegno

    Per ottenere l'ID, consulta Visualizza gli impegni acquistati.

Unire due impegni

Puoi unire più impegni in un unico impegno. Gli impegni da unire devono essere tutti dello stesso tipo (FLEX, MONTHLY, ANNUAL o THREE_YEAR). La data di fine dell'impegno combinato è la data di fine massima degli impegni originali. Se uno degli impegni ha una data di fine precedente, viene esteso alla data successiva e ti viene addebitato un importo proporzionale per gli slot in questione.

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 Impegni slot.

  4. Seleziona gli impegni che vuoi unire.

  5. Fai clic su Unisci.

  6. Nella pagina Unisci impegni, esamina i dettagli dell'unione e fai clic su Unisci. Il nuovo impegno unito è elencato nella scheda Impegni di slot.

bq

Per unire due impegni in uno, 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: l'ID progetto
  • LOCATION: la località degli impegni
  • COMMITMENT1: il primo impegno di unione
  • COMMITMENT2: il secondo impegno di unione

Elimina un impegno

Puoi eliminare un impegno per la capacità se la data di fine è nel passato. La data di fine dell'impegno è visualizzata nella console Google Cloud. Prima di eliminare un impegno, assicurati che siano disponibili abbastanza posti non allocati. In caso contrario, devi ridurre il numero di slot in una prenotazione o rimuovere completamente le prenotazioni.

Autorizzazioni obbligatorie

Per eliminare gli impegni di capacità, devi disporre della seguente autorizzazione IAM (Identity and Access Management):

Ognuno dei seguenti ruoli IAM predefiniti include questa autorizzazione:

  • BigQuery Admin
  • BigQuery Resource Admin

Per ulteriori informazioni sui ruoli IAM in BigQuery, consulta Ruoli e autorizzazioni predefiniti.

Eliminazione di un impegno di capacità

Console

Per eliminare un impegno di capacità:

  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 Impegni slot.

  4. Nell'elenco a discesa Località, seleziona la località appropriata.

  5. Trova l'impegno che vuoi eliminare.

  6. Espandi l'opzione Azioni.

  7. Fai clic su Elimina.

  8. Digita "REMOVE" e fai clic su Procedi.

SQL

Per eliminare un impegno di capacità, utilizza l'istruzione DDL DROP CAPACITY.

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

    Vai a BigQuery

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

    DROP CAPACITY
  `ADMIN_PROJECT_ID.region-LOCATION.COMMITMENT_ID`;

    Sostituisci quanto segue:

  3. Fai clic su Esegui.

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

bq

Per eliminare un impegno di capacità, utilizza il comando bq rm con il --capacity_commitment flag:

bq rm \
    --project_id=ADMIN_PROJECT_ID \
    --location=LOCATION \
    --capacity_commitment=true \
    COMMITMENT_ID

Sostituisci quanto segue:

Risoluzione dei problemi relativi agli impegni di capacità

Questa sezione descrive i passaggi per la risoluzione dei problemi, utili in caso di problemi nell'utilizzo di BigQuery Reservations.

Gli slot acquistati sono in attesa

Gli slot sono soggetti alla capacità disponibile. Quando acquisti impegni per gli slot e BigQuery li alloca, la colonna Stato mostra un segno di spunta. Se BigQuery non riesce ad allocare subito gli slot richiesti, la colonna Stato rimane in attesa. Potresti dover attendere diverse ore prima che gli slot diventino disponibili. Se hai bisogno di accedere agli slot prima, prova quanto segue:

  1. Elimina l'impegno in sospeso.
  2. Acquista un nuovo impegno per un numero inferiore di slot. A seconda della capacità, l'impegno più piccolo potrebbe essere attivato immediatamente.
  3. Acquista gli slot rimanenti come impegno separato. Questi slot potrebbero essere visualizzati come in attesa nella colonna Stato, ma in genere diventano attivi entro poche ore.
  4. (Facoltativo) Se entrambi gli impegni sono disponibili, puoi unirli in un unico impegno, a condizione che abbia acquistato lo stesso piano per entrambi.

Se l'impegno per uno slot non va a buon fine o richiede molto tempo per essere completato, ti consigliamo di utilizzare temporaneamente i prezzi on demand. Con questa soluzione, potresti dover eseguire query critiche su un progetto diverso che non è assegnato a nessuna prenotazione oppure potresti dover rimuovere del tutto l'assegnazione del progetto.