Vista RESERVATIONS_TIMELINE

La vista INFORMATION_SCHEMA.RESERVATIONS_TIMELINE mostra time slice dei metadati di prenotazione per ogni progetto di amministrazione delle prenotazioni per ogni minuto in tempo reale. Inoltre, l'array per_second_details mostra i dettagli della scalabilità automatica per ogni secondo.

Autorizzazione obbligatoria

Per eseguire query sulla vista INFORMATION_SCHEMA.RESERVATIONS_TIMELINE, 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)
  • BigQuery Resource Editor (roles/bigquery.resourceEditor)
  • BigQuery Resource Viewer (roles/bigquery.resourceViewer)
  • Utente BigQuery (roles/bigquery.user)
  • Amministratore BigQuery (roles/bigquery.admin)

Per saperne di più sulle autorizzazioni BigQuery, consulta Ruoli e autorizzazioni IAM di BigQuery.

Schema

Quando esegui una query sulla vista INFORMATION_SCHEMA.RESERVATIONS_TIMELINE, i risultati della query contengono una riga per ogni minuto di ogni prenotazione BigQuery negli ultimi 180 giorni e una riga per ogni minuto con modifiche alla prenotazione per tutte le occorrenze precedenti a 180 giorni. Ogni periodo inizia con un intervallo di un minuto intero e dura esattamente un minuto.

La vista INFORMATION_SCHEMA.RESERVATIONS_TIMELINE ha il seguente schema:

Nome colonna Tipo di dati Valore
autoscale STRUCT

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

  • current_slots: il numero di slot con scalabilità automatica disponibili per la prenotazione.
  • max_slots: il numero massimo di slot che è possibile aggiungere alla prenotazione tramite la scalabilità automatica.
edition STRING La versione associata a questa prenotazione. Per saperne di più sulle versioni, consulta Introduzione alle versioni di BigQuery.
ignore_idle_slots BOOL False se la condivisione degli slot è abilitata, altrimenti true.
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].
period_start TIMESTAMP Ora di inizio di questo periodo di un minuto.
per_second_details STRUCT

Contiene informazioni sulla capacità e sull'utilizzo della prenotazione per ogni secondo. I campi includono:

  • start_time: il timestamp esatto del secondo.
  • autoscale_current_slots: il numero di slot con scalabilità automatica disponibili per la prenotazione in questo secondo. Questo numero esclude gli slot di riferimento.
  • autoscale_max_slots: il numero massimo di slot che è possibile aggiungere alla prenotazione tramite la scalabilità automatica in questo secondo. Questo numero esclude gli slot di riferimento.
  • slots_assigned: il numero di slot assegnati a questa prenotazione in questo secondo. Equivale alla capacità degli slot di riferimento di una prenotazione.
  • slots_max_assigned: la capacità massima di slot per questa prenotazione, inclusa la condivisione degli slot. Se ignore_idle_slots è true, questo campo è uguale a slots_assigned. In caso contrario, questo campo corrisponde al numero totale di slot in tutti gli impegni di capacità o in tutte le baseline nel progetto di amministrazione, a seconda di quale sia il valore maggiore.
  • borrowed_slots: il numero di slot utilizzati dalla condivisione degli slot inattivi. Compilato solo se ignore_idle_slots è false e sono stati utilizzati slot inattivi durante questo secondo.
  • lent_slots: il numero di slot utilizzati da altre prenotazioni dal pool di slot di riferimento di questa prenotazione. Compilato solo se ignore_idle_slots è false e gli slot inattivi sono stati utilizzati da altre prenotazioni durante questo secondo.

Se durante questo minuto vengono apportate modifiche alla scalabilità automatica o alla prenotazione, l'array viene compilato con 60 righe. Tuttavia, per le prenotazioni senza scalabilità automatica che rimangono invariate durante questo minuto, l'array è vuoto perché altrimenti ripeterebbe lo stesso numero 60 volte.

project_id STRING ID del progetto di amministrazione delle prenotazioni.
project_number INTEGER Numero del progetto.
reservation_id STRING Per l'unione con la tabella jobs_timeline. Il formato è project_id:location.reservation_name.
reservation_name STRING Il nome della prenotazione.
slot_capacity INTEGER La capacità degli slot di riferimento della prenotazione.
slots_assigned INTEGER Il numero di slot assegnati a questa prenotazione.
slots_max_assigned INTEGER La capacità massima degli slot per questa prenotazione, inclusa la condivisione degli slot. Se ignore_idle_slots è true, questo valore corrisponde a slots_assigned, altrimenti corrisponde al numero totale di slot in tutti gli impegni di capacità nel progetto di amministrazione.
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à della prenotazione, che determina il modo in cui la prenotazione scala dalla base di riferimento a max_slots. Questo campo viene specificato dagli utenti per utilizzare la funzionalità di prevedibilità delle prenotazioni.
period_autoscale_slot_seconds INTEGER Il totale di slot-secondi addebitati dalla scalabilità automatica per un minuto specifico (ogni riga di dati corrisponde a un minuto).
is_creation_region BOOLEAN

Specifica se la regione attuale è la località in cui è stata creata la prenotazione. Questa località viene utilizzata per determinare i prezzi degli slot di prenotazione di base. Per una prenotazione di disaster recovery (RE) con failover, un valore TRUE indica la località principale originale, mentre per una prenotazione non RE, un valore TRUE indica la località della prenotazione.

Per una prenotazione non di failover, questo valore è sempre TRUE. Per una prenotazione di failover, il valore dipende dalla regione: TRUE per la regione principale originale e FALSE per la regione secondaria originale.

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

Ambito e sintassi

Le query su questa vista devono includere un qualificatore di regione. Se non specifichi un qualificatore regionale, i metadati vengono recuperati da tutte le regioni. La tabella seguente illustra l'ambito della regione e delle risorse per questa visualizzazione:

Nome vista Ambito risorsa Ambito della regione
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.RESERVATIONS_TIMELINE[_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`.

Esempi

Esempio: visualizza la scalabilità automatica al secondo

L'esempio seguente mostra la scalabilità automatica al secondo di YOUR_RESERVATION_ID in tutti i job:

SELECT s.start_time, s.autoscale_current_slots
FROM `region-us.INFORMATION_SCHEMA.RESERVATIONS_TIMELINE` m
JOIN m.per_second_details s
WHERE period_start BETWEEN '2025-09-28' AND '2025-09-29'
  AND reservation_id = 'YOUR_RESERVATION_ID'
ORDER BY period_start, s.start_time

Il risultato è simile al seguente:

+---------------------+-------------------------+
|     start_time      | autoscale_current_slots |
+---------------------+-------------------------+
| 2025-09-28 00:00:00 |                    1600 |
| 2025-09-28 00:00:01 |                    1600 |
| 2025-09-28 00:00:02 |                    1600 |
| 2025-09-28 00:00:03 |                    1600 |
| 2025-09-28 00:00:04 |                    1600 |
+---------------------+-------------------------+

Esempio: visualizza l'utilizzo totale degli slot al secondo

Per eseguire la query su un progetto diverso da quello predefinito, aggiungi l'ID progetto nel seguente formato:

`PROJECT_ID`.`region-REGION_NAME`.INFORMATION_SCHEMA.JOBS_TIMELINE_BY_ORGANIZATION
Ad esempio, `myproject`.`region-us`.INFORMATION_SCHEMA.JOBS_TIMELINE_BY_ORGANIZATION.

L'esempio seguente mostra l'utilizzo degli slot al secondo dei progetti assegnati a YOUR_RESERVATION_ID in tutti i job:

SELECT
  jobs.period_start,
  SUM(jobs.period_slot_ms) / 1000 AS period_slot_seconds,
  ANY_VALUE(COALESCE(s.slots_assigned, res.slots_assigned)) AS estimated_slots_assigned,
  ANY_VALUE(COALESCE(s.slots_max_assigned, res.slots_max_assigned)) AS estimated_slots_max_assigned
FROM `region-us`.INFORMATION_SCHEMA.JOBS_TIMELINE_BY_ORGANIZATION jobs
JOIN `region-us`.INFORMATION_SCHEMA.RESERVATIONS_TIMELINE res
  ON jobs.reservation_id = res.reservation_id
  AND TIMESTAMP_TRUNC(jobs.period_start, MINUTE) = res.period_start
LEFT JOIN UNNEST(res.per_second_details) s
  ON jobs.period_start = s.start_time
WHERE
  jobs.job_creation_time
    BETWEEN TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 1 DAY)
        AND CURRENT_TIMESTAMP()
  AND res.period_start
    BETWEEN TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 1 DAY)
        AND CURRENT_TIMESTAMP()
  AND res.reservation_id = 'YOUR_RESERVATION_ID'
  AND (jobs.statement_type != "SCRIPT" OR jobs.statement_type IS NULL)  -- Avoid duplicate byte counting in parent and children jobs.
GROUP BY
  period_start
ORDER BY
  period_start DESC;

Il risultato è simile al seguente:

+-----------------------+---------------------+--------------------------+------------------------------+
|     period_start      | period_slot_seconds | estimated_slots_assigned | estimated_slots_max_assigned |
+-----------------------+---------------------+--------------------------+------------------------------+
|2021-06-08 21:33:59 UTC|       100.000       |         100              |           100                |
|2021-06-08 21:33:58 UTC|        96.753       |         100              |           100                |
|2021-06-08 21:33:57 UTC|        41.668       |         100              |           100                |
+-----------------------+---------------------+--------------------------+------------------------------+

Esempio: utilizzo degli slot per prenotazione

L'esempio seguente mostra l'utilizzo degli slot al secondo per ogni prenotazione nell'ultimo giorno:

SELECT
  jobs.period_start,
  res.reservation_id,
  SUM(jobs.period_slot_ms) / 1000 AS period_slot_seconds,
  ANY_VALUE(COALESCE(s.slots_assigned, res.slots_assigned)) AS estimated_slots_assigned,
  ANY_VALUE(COALESCE(s.slots_max_assigned, res.slots_max_assigned)) AS estimated_slots_max_assigned
FROM `region-us`.INFORMATION_SCHEMA.JOBS_TIMELINE_BY_ORGANIZATION jobs
JOIN `region-us`.INFORMATION_SCHEMA.RESERVATIONS_TIMELINE res
  ON jobs.reservation_id = res.reservation_id
  AND TIMESTAMP_TRUNC(jobs.period_start, MINUTE) = res.period_start
LEFT JOIN UNNEST(res.per_second_details) s
  ON jobs.period_start = s.start_time
WHERE
  jobs.job_creation_time
      BETWEEN TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 1 DAY)
          AND CURRENT_TIMESTAMP()
  AND res.period_start
      BETWEEN TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 1 DAY)
          AND CURRENT_TIMESTAMP()
  AND (jobs.statement_type != "SCRIPT" OR jobs.statement_type IS NULL)  -- Avoid duplicate byte counting in parent and children jobs.
GROUP BY
  period_start,
  reservation_id
ORDER BY
  period_start DESC,
  reservation_id;

Il risultato è simile al seguente:

+-----------------------+----------------+---------------------+--------------------------+------------------------------+
|     period_start      | reservation_id | period_slot_seconds | estimated_slots_assigned | estimated_slots_max_assigned |
+-----------------------+----------------+---------------------+--------------------------+------------------------------+
|2021-06-08 21:33:59 UTC|     prod01     |       100.000       |             100          |              100             |
|2021-06-08 21:33:58 UTC|     prod02     |       177.201       |             200          |              500             |
|2021-06-08 21:32:57 UTC|     prod01     |        96.753       |             100          |              100             |
|2021-06-08 21:32:56 UTC|     prod02     |       182.329       |             200          |              500             |
+-----------------------+----------------+---------------------+--------------------------+------------------------------+