RESERVATION_CHANGES visualizzazione

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, vedi Introduzione alle prenotazioni.

Autorizzazione obbligatoria

Per eseguire query sulla vista INFORMATION_SCHEMA.RESERVATION_CHANGES, devi disporre l'autorizzazione Identity and Access Management (IAM) di bigquery.reservations.list. Ciascuno dei seguenti ruoli IAM predefiniti include autorizzazione:

  • 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 le schema riportato di seguito:

Nome colonna Tipo di dati Valore
change_timestamp TIMESTAMP L'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 prenotazione fornito dall'utente.
ignore_idle_slots BOOL Se il valore è false, tutte le query che utilizzano questa prenotazione possono utilizzare gli slot inattivi inutilizzati 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 Base di riferimento della prenotazione.
user_email STRING Indirizzo email dell'utente o del soggetto dell'identità della forza lavoro federazione che ha apportato la modifica. google per le modifiche realizzati da Google. NULL se l'indirizzo email è sconosciuto.
target_job_concurrency INTEGER Il numero target di query che possono essere eseguite contemporaneamente, ovvero limitati dalle risorse disponibili. Se pari a zero, questo valore viene calcolato automaticamente in base Google Cloud.
autoscale STRUCT

Informazioni sulla capacità di scalabilità automatica della prenotazione. Sono inclusi i seguenti campi:

  • current_slots: il numero di slot aggiunti alla prenotazione tramite scalabilità automatica.
  • max_slots: il numero massimo di slot che potrebbero essere aggiunti alla prenotazione tramite scalabilità automatica.
edition STRING La versione associata a questa prenotazione. Per saperne di più sulle versioni, consulta Introduzione alle versioni di BigQuery.

Conservazione dei dati

Questa visualizzazione contiene prenotazioni correnti e prenotazioni eliminate che sono conservati per un massimo di 41 giorni, dopodiché vengono rimossi dalla vista.

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 tutti regioni. La tabella seguente spiega l'ambito della regione per questa visualizzazione:

Nome vista Ambito risorsa Ambito della regione
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.RESERVATION_CHANGES[_BY_PROJECT] Livello di 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

L'esempio seguente recupera la cronologia delle modifiche per una determinata prenotazione. Utilizza le funzionalità di queste informazioni per visualizzare l'elenco delle modifiche apportate a una prenotazione specifica, come 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;