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

Autorizzazione obbligatoria

Per eseguire query sulla visualizzazione INFORMATION_SCHEMA.RESERVATION_CHANGES, devi disporre dell'autorizzazione IAM (Identity and Access Management) bigquery.reservations.list per il progetto. Ognuno dei seguenti ruoli IAM predefiniti include l'autorizzazione richiesta:

  • Amministratore risorse BigQuery (roles/bigquery.resourceAdmin)
  • Editor risorse BigQuery (roles/bigquery.resourceEditor)
  • Visualizzatore risorse BigQuery (roles/bigquery.resourceViewer)
  • Utente BigQuery (roles/bigquery.user)
  • BigQuery Admin (roles/bigquery.admin)

Per ulteriori informazioni sulle autorizzazioni BigQuery, vedi Ruoli e autorizzazioni IAM di BigQuery.

Schema

La visualizzazione 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 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 della federazione di 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 quanto segue:

  • current_slots: il numero di slot aggiunti alla prenotazione dalla scalabilità automatica.
  • max_slots: il numero massimo di slot che potrebbero essere aggiunti alla prenotazione dalla scalabilità automatica.
edition STRING La versione associata a questa prenotazione. Per ulteriori informazioni sulle versioni, vedi Introduzione alle versioni di BigQuery.
primary_location STRING La località attuale della replica primaria della prenotazione. Questo campo viene impostato solo per le prenotazioni che utilizzano la funzionalità di ripristino di emergenza gestito .
secondary_location STRING La località attuale della replica secondaria della prenotazione. Questo campo viene impostato solo per le prenotazioni che utilizzano la funzionalità di ripristino di emergenza gestito .
original_primary_location STRING La località in cui è stata creata originariamente la prenotazione.
labels RECORD Array di etichette associate alla prenotazione.
reservation_group_path ARRAY<STRING> Il gruppo di prenotazioni a cui è collegata la prenotazione. Ad esempio, se la prenotazione è collegata al gruppo my-group, il campo reservation_group_path contiene un elenco come: [my-group].
max_slots INTEGER Il numero massimo di slot che questa prenotazione può utilizzare, inclusi gli slot di base di riferimento (slot_capacity), gli slot inattivi (se ignore_idle_slots è false) e gli slot di scalabilità automatica. Questo campo viene specificato dagli utenti per l'utilizzo della funzionalità di prevedibilità delle prenotazioni .
scaling_mode STRING La modalità di scalabilità per la prenotazione, che determina la scalabilità della prenotazione dalla base di riferimento a max_slots. Questo campo viene specificato dagli utenti per l'utilizzo della funzionalità di prevedibilità delle prenotazioni .

Per garantire la stabilità, ti consigliamo di elencare esplicitamente le colonne nelle query dello schema informativo anziché utilizzare un carattere jolly (SELECT *). L'elenco esplicito delle colonne impedisce l'interruzione delle query se lo schema sottostante cambia.

Conservazione dei dati

Questa visualizzazione contiene le prenotazioni attuali e le prenotazioni 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 visualizzazione 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 Cloud de Confiance progetto. Se non viene specificato, viene utilizzato il progetto predefinito.
  • REGION: qualsiasi nome di regione del set di dati. Ad esempio, `region-us`.

Esempio

L'esempio seguente 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;