Visualizzazione RESERVATION_CHANGES

La visualizzazione INFORMATION_SCHEMA.RESERVATION_CHANGES contiene un elenco quasi in tempo reale di tutte le modifiche alle prenotazioni all'interno del progetto di amministrazione. Ogni riga rappresenta una modifica a una singola prenotazione. Per ulteriori informazioni, consulta Introduzione alle prenotazioni.

Autorizzazione obbligatoria

Per eseguire query sulla visualizzazione INFORMATION_SCHEMA.RESERVATION_CHANGES, devi disporre dell'autorizzazione Identity and Access Management (IAM) bigquery.reservations.list. 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 visualizzazione INFORMATION_SCHEMA.RESERVATION_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.
reservation_name STRING Nome della prenotazione fornito dall'utente.
ignore_idle_slots BOOL Se il valore è false, qualsiasi query che utilizza questa prenotazione può utilizzare gli slot inattivi non utilizzati di altri impegni di capacità.
action STRING Tipo di evento che si è verificato con la prenotazione. Può essere CREATE, UPDATE o DELETE.
slot_capacity INTEGER Il punto di riferimento della prenotazione.
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.
target_job_concurrency INTEGER Il numero target di query che possono essere eseguite contemporaneamente, che è limitato dalle risorse disponibili. Se è zero, questo valore viene calcolato automaticamente in base alle risorse disponibili.
autoscale STRUCT

Informazioni sulla capacità di scalabilità automatica della prenotazione. I campi includono:

  • current_slots: il numero di slot aggiunti alla prenotazione tramite la scalabilità automatica.
  • max_slots: il numero massimo di slot che possono essere aggiunti alla prenotazione tramite la scalabilità automatica.
edition STRING La versione associata a questa prenotazione. Per ulteriori informazioni sulle versioni, vedi Introduzione alle versioni di BigQuery.
primaryLocation STRING La posizione attuale della replica principale della prenotazione. Questo campo viene impostato solo per le prenotazioni che utilizzano la funzionalità di ripristino di emergenza gestito.
secondaryLocation STRING La posizione attuale della replica secondaria della prenotazione. Questo campo viene impostato solo per le prenotazioni che utilizzano la funzionalità di ripristino di emergenza gestito.
originalPrimaryLocation STRING La località in cui è stata creata originariamente la prenotazione.
labels RECORD Array di etichette associate alla prenotazione.
max_slots INTEGER Il numero massimo di slot che questa prenotazione può utilizzare, inclusi gli slot di base (slot_capacity), gli slot inattivi (se ignore_idle_slots è false) e gli slot con scalabilità automatica. Questo campo viene specificato dagli utenti per utilizzare la funzionalità di prevedibilità delle prenotazioni.
scaling_mode STRING La modalità di scalabilità per la prenotazione, che determina il modo in cui la prenotazione viene scalata dalla baseline a max_slots. Questo campo viene specificato dagli utenti per utilizzare la funzionalità di prevedibilità delle prenotazioni.

Conservazione dei dati

Questa visualizzazione contiene le prenotazioni attuali e quelle eliminate che vengono conservate per un massimo di 41 giorni, dopodiché vengono rimosse 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.RESERVATION_CHANGES[_BY_PROJECT] Livello progetto REGION
Sostituisci quanto segue:
  • (Facoltativo) PROJECT_ID: l'ID del tuo Trusted Cloud progetto. Se non specificato, viene utilizzato il progetto predefinito.
  • REGION: qualsiasi nome della regione del set di dati. Ad esempio: `region-us`.

Esempio

Il seguente esempio recupera la cronologia delle modifiche per una determinata prenotazione. Utilizza queste informazioni per visualizzare l'elenco delle modifiche apportate a una prenotazione specifica, ad esempio la creazione o l'eliminazione della prenotazione.

SELECT
  *
FROM
  reservation-admin-project.`region-us`.
  INFORMATION_SCHEMA.RESERVATION_CHANGES
WHERE
  reservation_name = "my-reservation"
ORDER BY
  change_timestamp DESC;