Visualizzazione CAPACITY_COMMITMENTS

La visualizzazione INFORMATION_SCHEMA.CAPACITY_COMMITMENTS contiene un elenco quasi in tempo reale di tutti gli impegni di capacità attuali all'interno del progetto di amministrazione. Ogni riga rappresenta un singolo impegno di capacità corrente. Un impegno di capacità attuale è in attesa o attivo e non è stato eliminato. Per ulteriori informazioni sulla prenotazione, consulta Impegni di slot.

Autorizzazione obbligatoria

Per eseguire query sulla visualizzazione INFORMATION_SCHEMA.CAPACITY_COMMITMENTS, devi disporre dell'autorizzazione Identity and Access Management (IAM) bigquery.capacityCommitments.list per il progetto. Ciascuno dei seguenti ruoli IAM predefiniti include l'autorizzazione richiesta:

  • roles/bigquery.resourceAdmin
  • roles/bigquery.resourceEditor
  • roles/bigquery.resourceViewer
  • roles/bigquery.user
  • roles/bigquery.admin

Per ulteriori informazioni sulle autorizzazioni BigQuery, consulta Controllo dell'accesso con IAM.

Schema

La visualizzazione INFORMATION_SCHEMA.CAPACITY_COMMITMENTS ha lo schema seguente:

Nome colonna Tipo di dati Valore
ddl STRING L'istruzione DDL utilizzata per creare questo impegno di capacità.
project_id STRING ID del progetto di amministrazione.
project_number INTEGER Numero del progetto di amministrazione.
capacity_commitment_id STRING ID che identifica in modo univoco l'impegno di capacità.
commitment_plan STRING Piano di impegno dell'impegno di capacità.
state STRING Indica in quale stato si trova l'impegno di capacità. Può essere PENDING o ACTIVE.
slot_count INTEGER Conteggio degli slot associati all'impegno di capacità.
edition STRING La versione associata a questa prenotazione. Per ulteriori informazioni sulle versioni, vedi Introduzione alle versioni di BigQuery.
is_flat_rate BOOL Se l'impegno è associato al modello di capacità con tariffa fissa legacy o a un'edizione. Se FALSE, l'impegno attuale è associato a una versione. Se TRUE, l'impegno è il modello di capacità a tariffa fissa legacy.
renewal_plan STRING Nuovo piano con impegno dopo la fine del piano con impegno attuale. Puoi modificare il piano di rinnovo di un impegno in qualsiasi momento prima della scadenza.

Ambito e sintassi

Le query su questa visualizzazione devono includere un qualificatore di regione. Se non specifichi un qualificatore regionale, i metadati vengono recuperati da tutte le regioni. La tabella seguente spiega l'ambito della regione per questa visualizzazione:

Nome vista Ambito risorsa Ambito regione
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.CAPACITY_COMMITMENTS[_BY_PROJECT] Livello progetto REGION
Sostituisci quanto segue:
  • (Facoltativo) PROJECT_ID: l'ID del tuo Google Cloud progetto. Se non specificato, viene utilizzato il progetto predefinito.
  • REGION: qualsiasi nome della regione del set di dati. Ad esempio: `region-us`.

Esempio

L'esempio seguente restituisce un elenco di impegni di capacità attivi per il progetto corrente:

SELECT
  capacity_commitment_id,
  slot_count
FROM
  `region-us`.INFORMATION_SCHEMA.CAPACITY_COMMITMENTS
WHERE
  state = 'ACTIVE';

Il risultato è simile al seguente:

+------------------------+------------+
| capacity_commitment_id | slot_count |
+------------------------+------------+
|    my_commitment_05    |    1000    |
|    my_commitment_06    |    1000    |
|    my_commitment_07    |    1500    |
|    my_commitment_08    |    2000    |
+------------------------+------------+