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 sulla prenotazione, vedi Impegno.

Autorizzazione obbligatoria

Per eseguire query sulla visualizzazione 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 obbligatoria:

  • 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 Ora in cui si è verificata 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 campagna è presente l'impegno di capacità. Può essere PENDING o ACTIVE.
slot_count INTEGER Numero di 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à 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 corrente. Applicabile solo per i impegni di capacità ACTIVE, altrimenti è NULL.
commitment_end_time TIMESTAMP La fine del periodo di impegno corrente. Applicabile solo per i impegni di capacità ACTIVE, altrimenti è NULL.
failure_status RECORD Per un piano con 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 il termine di commitment_end_time. Dopo la modifica del piano, il periodo di impegno viene esteso in base al piano di impegno. Solo applicabile per gli impegni ANNUAL e TRIAL altrimenti è NULL.
edition STRING La versione associata a questa prenotazione. Per ulteriori informazioni sulle versioni, consulta Introduzione alle versioni di BigQuery.
is_flat_rate BOOL Indica se l'impegno è associato al precedente modello di capacità a tariffa fissa o a una versione. Se FALSE, l'impegno attuale è associato a una versione. Se TRUE, l'impegno è il precedente modello di capacità a tariffa fissa.

Conservazione dei dati

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

Ambito e sintassi

Le query su questa visualizzazione devono includere un qualificatore regione. Se non specifichi un qualificatore regionale, i metadati vengono recuperati da tutte le regioni. La tabella seguente illustra 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 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'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 |
    +--------------------------------+-------------------------+