Visualizzazione CAPACITY_COMMITMENT_CHANGES

La visualizzazione INFORMATION_SCHEMA.CAPACITY_COMMITMENT_CHANGES contiene un elenco quasi in tempo reale 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 ulteriori informazioni, consulta Impegni di slot.

Autorizzazione obbligatoria

Per eseguire query sulla visualizzazione INFORMATION_SCHEMA.CAPACITY_COMMITMENT_CHANGES, 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 saperne di più sulle autorizzazioni BigQuery, consulta Controllo dell'accesso con IAM.

Schema

La visualizzazione INFORMATION_SCHEMA.CAPACITY_COMMITMENT_CHANGES ha lo schema seguente:

Nome colonna Tipo di dati Valore
change_timestamp TIMESTAMP Ora in cui è stata apportata 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 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à.
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 soggetto della federazione delle identità della 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 impegni di capacità ACTIVE, altrimenti è NULL.
commitment_end_time TIMESTAMP La fine del periodo di impegno corrente. Applicabile solo per impegni di capacità ACTIVE, altrimenti è NULL.
failure_status RECORD Per un piano di impegno FAILED, fornisce il motivo dell'errore, altrimenti è NULL. RECORD è composto da code e message.
renewal_plan STRING Il piano in cui viene convertito questo impegno di capacità dopo commitment_end_time. Dopo la modifica del piano, il periodo di impegno viene esteso in base al piano di impegno. Applicabile solo per gli impegni ANNUAL e TRIAL, altrimenti è NULL.
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.

Conservazione dei dati

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

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_COMMITMENT_CHANGES[_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

La seguente query mostra l'utente che ha apportato l'ultimo aggiornamento dell'impegno di capacità al progetto corrente 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 |
+--------------------------------+-------------------------+