Visualizzazione CAPACITY_COMMITMENTS
La visualizzazione INFORMATION_SCHEMA.CAPACITY_COMMITMENTS
contiene un elenco di tutti gli impegni attuali in termini di capacità all'interno del progetto di amministrazione. Ogni riga rappresenta un singolo impegno di capacità attuale. Un impegno di capacità attuale è in attesa o attivo e non è stato eliminato. Per ulteriori informazioni sulla prenotazione, consulta Impegni.
Autorizzazione obbligatoria
Per eseguire una query sulla vista INFORMATION_SCHEMA.CAPACITY_COMMITMENTS
, devi disporre dell'autorizzazione bigquery.capacityCommitments.list
Identity and Access Management (IAM) 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 maggiori informazioni sulle autorizzazioni BigQuery, vedi Controllo dell'accesso con IAM
Schema
La vista INFORMATION_SCHEMA.CAPACITY_COMMITMENTS
ha il seguente schema:
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 |
Stato dell'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, vedi Introduzione alle versioni di BigQuery. |
is_flat_rate |
BOOL |
Indica se l'impegno è associato al modello a capacità a costo fisso precedente 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 di impegno dopo la fine del piano di impegno 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 tutte le regioni. La tabella seguente spiega l'ambito della regione per questa visualizzazione:
Nome visualizzazione | Ambito risorsa | Ambito regione |
---|---|---|
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.CAPACITY_COMMITMENTS[_BY_PROJECT] |
A livello di progetto | REGION |
- (Facoltativo)
PROJECT_ID
: l'ID del 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à attiva 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 | +------------------------+------------+