vista CAPACITY_COMMITMENTS

La visualizzazione INFORMATION_SCHEMA.CAPACITY_COMMITMENTS contiene una visualizzazione quasi in tempo reale di tutti gli attuali impegni in termini di capacità nell'ambito del progetto di amministrazione. Ciascuna rappresenta un singolo impegno di capacità attuale. Una capacità attuale impegno è in attesa o attivo e non è stato eliminato. Per maggiori informazioni informazioni sulla prenotazione, consulta Impegni.

Autorizzazione obbligatoria

Per eseguire una query sulla vista INFORMATION_SCHEMA.CAPACITY_COMMITMENTS, è necessaria Identity and Access Management (IAM) bigquery.capacityCommitments.list l'autorizzazione per il progetto. Ciascuno dei seguenti ruoli IAM predefiniti include autorizzazione:

  • 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 vista INFORMATION_SCHEMA.CAPACITY_COMMITMENTS ha le schema riportato di seguito:

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 dell'impegno dell'impegno di capacità.
state STRING Stato in cui si trova l'impegno di capacità. Può essere PENDING o ACTIVE.
slot_count INTEGER Conteggio degli slot associato all'impegno di capacità.
edition STRING La versione associata a questa prenotazione. Per saperne di più sulle versioni, consulta Introduzione alle versioni di BigQuery.
is_flat_rate BOOL Indica se l'impegno è associato al modello di capacità a costo fisso legacy o a una versione. Se FALSE, l'impegno attuale è associato a una versione. Se TRUE, l'impegno è il modello di capacità a costo fisso precedente.
renewal_plan STRING Nuovo piano basato su impegno dopo la fine di quello attuale. Puoi modificare il piano di rinnovo di un impegno in qualsiasi momento fino alla scadenza.

Ambito e sintassi

Le query relative a questa vista devono includere un qualificatore regione. Se non specifichi un qualificatore regionale, i metadati vengono recuperati da tutti regioni. La tabella seguente spiega l'ambito della regione per questa visualizzazione:

Nome vista Ambito risorsa Ambito della regione
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.CAPACITY_COMMITMENTS[_BY_PROJECT] Livello di progetto REGION
Sostituisci quanto segue:

  • (Facoltativo) PROJECT_ID: l'ID del tuo progetto Google Cloud. 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 progetto attuale:

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    |
+------------------------+------------+