Visualizzazione di CAPACITY_COMMITMENT_CHANGES

La visualizzazione INFORMATION_SCHEMA.CAPACITY_COMMITMENT_CHANGES contiene un elenco di tutte le modifiche agli impegni di capacità all'interno del progetto di amministrazione. Ogni riga rappresenta una singola modifica a un singolo impegno di capacità. Per maggiori informazioni sulla prenotazione, consulta la sezione Impegni.

Autorizzazione obbligatoria

Per eseguire una query sulla vista INFORMATION_SCHEMA.CAPACITY_COMMITMENT_CHANGES, 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 ulteriori informazioni sulle autorizzazioni BigQuery, consulta Controllo dell'accesso con IAM.

Schema

La vista INFORMATION_SCHEMA.CAPACITY_COMMITMENT_CHANGES ha il seguente schema:

Nome colonna Tipo di dati Valore
change_timestamp TIMESTAMP L'ora in cui è avvenuta la modifica.
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à.
action STRING Tipo di evento che si è verificato con l'impegno di capacità. Può essere CREATE, UPDATE o DELETE.
user_email STRING Indirizzo email dell'utente o del soggetto della federazione delle identità per la forza lavoro che ha apportato la modifica. google per le modifiche apportate da Google. NULL se l'indirizzo email è sconosciuto.
commitment_start_time TIMESTAMP L'inizio del periodo di impegno attuale. Applicabile solo per gli impegni di capacità ACTIVE, altrimenti è NULL.
commitment_end_time TIMESTAMP La fine del periodo di impegno attuale. Applicabile solo per gli impegni di capacità ACTIVE, altrimenti è NULL.
failure_status RECORD Per un piano di impegno FAILED, indica il motivo dell'errore, altrimenti è NULL. RECORD è composto da code e message.
renewal_plan STRING Il piano a cui viene convertito questo impegno di capacità dopo il superamento di commitment_end_time. Dopo la modifica del piano, il periodo dell'impegno viene esteso in base al piano dell'impegno. Applicabile solo per gli impegni ANNUAL e TRIAL, altrimenti è NULL.
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.

Conservazione dei dati

Questa visualizzazione contiene gli impegni di capacità attuali e gli impegni di capacità eliminati, che vengono conservati per un massimo di 41 giorni, dopodiché vengono rimossi dalla visualizzazione.

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_COMMITMENT_CHANGES[_BY_PROJECT] A livello di progetto REGION
Sostituisci quanto segue:

  • (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

La seguente query mostra l'utente che ha effettuato l'aggiornamento più recente dell'impegno di capacità nel progetto attuale entro la data specificata.

SELECT
  user_email,
  change_timestamp
FROM
  `region-us`.INFORMATION_SCHEMA.CAPACITY_COMMITMENT_CHANGES
WHERE
  change_timestamp BETWEEN '2021-09-30' AND '2021-10-01'
ORDER BY
  change_timestamp DESC
LIMIT 1;

Il risultato è simile al seguente:

+--------------------------------+-------------------------+
|           user_email           |     change_timestamp    |
+--------------------------------+-------------------------+
|     222larabrown@gmail.com     | 2021-09-30 09:30:00 UTC |
+--------------------------------+-------------------------+