Visualizzazione RESERVATION_CHANGES

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

Autorizzazione obbligatoria

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

Conservazione dei dati

Questa visualizzazione contiene le prenotazioni correnti 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 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.RESERVATION_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

    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;