Visualizzazione TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER

La visualizzazione INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER fornisce i totali giornalieri dell'utilizzo dello spazio di archiviazione per gli ultimi 90 giorni per i seguenti tipi di tabelle.

• Tabelle standard
• Viste materializzate
• Cloni di tabelle con un delta in byte rispetto alla tabella di base
• Snapshot delle tabelle con un delta in byte rispetto alla tabella di base

La visualizzazione INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER esclude le tabelle senza byte fatturabili. Sono esclusi i seguenti tipi di tabelle:

• Tabelle esterne
• Tabelle anonime
• Tabelle vuote
• Cloni di tabelle che non hanno delta in byte rispetto alla tabella di base
• Snapshot delle tabelle che non hanno delta in byte rispetto alla tabella di base

Quando esegui una query sulla vista INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER, i risultati della query contengono una riga al giorno per ogni tabella o vista materializzata nella cartella principale del progetto corrente, incluse le sottocartelle.

I dati di questa tabella non sono disponibili in tempo reale. I dati della tabella vengono visualizzati in questa visualizzazione dopo circa 72 ore.

La visualizzazione restituisce l'utilizzo dello spazio di archiviazione in secondi MiB. Ad esempio, se un progetto utilizza 1.000.000 di byte fisici per 86.400 secondi (24 ore), l'utilizzo fisico totale è pari a 86.400.000.000 byte secondi, che si converte in 82.397 MiB secondi, come mostrato nell'esempio seguente:

86,400,000,000 / 1,024 / 1,024 = 82,397

Il valore di utilizzo dello spazio di archiviazione si trova nella colonna BILLABLE_TOTAL_PHYSICAL_USAGE. Per maggiori informazioni, consulta Dettagli dei prezzi di archiviazione.

Autorizzazioni obbligatorie

Per eseguire query sulla visualizzazione INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER, hai bisogno delle seguenti autorizzazioni IAM (Identity and Access Management) per la cartella principale del progetto:

• bigquery.tables.get
• bigquery.tables.list

Ciascuno dei seguenti ruoli IAM predefiniti include le autorizzazioni precedenti:

• roles/bigquery.dataViewer
• roles/bigquery.dataEditor
• roles/bigquery.metadataViewer
• roles/bigquery.admin

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

Schema

La vista INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER ha il seguente schema:

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:

• (Facoltativo) PROJECT_ID: l'ID del progetto Google Cloud . Se non specificato, viene utilizzato il progetto predefinito.
• REGION: qualsiasi nome della regione del set di dati. Ad esempio: `region-us`.

Per recuperare le informazioni sullo spazio di archiviazione per le tabelle nella cartella principale del progetto specificato, esegui la seguente query:

SELECT * FROM `myProject`.`region-REGION`.INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER;

Esempio

La seguente query mostra l'utilizzo di tutte le tabelle nella cartella alla data più recente:

SELECT
  usage_date,
  project_id,
  table_schema,
  table_name,
  billable_total_logical_usage,
  billable_total_physical_usage
FROM
  (
    SELECT
      *,
      ROW_NUMBER()
        OVER (PARTITION BY project_id, table_schema, table_name ORDER BY usage_date DESC) AS rank
    FROM
      `region-REGION`.INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER
  )
WHERE rank = 1;

Il risultato è simile al seguente:

+--------------+------------+--------------+------------+------------------------------+-------------------------------+
| usage_date   | project_id | table_schema | table_name | billable_total_logical_usage | billable_total_physical_usage |
+--------------+------------+--------------+------------+------------------------------+-------------------------------+
|  2023-04-03  | project1   | dataset_A    | table_x    |     734893409201             |              0                |
+--------------+------------+--------------+------------+------------------------------+-------------------------------+
|  2023-04-03  | project1   | dataset_A    | table_z    |     110070445455             |              0                |
+--------------+------------+--------------+------------+------------------------------+-------------------------------+
|  2023-04-03  | project1   | dataset_B    | table_y    |            0                 |         52500873256           |
+--------------+------------+--------------+------------+------------------------------+-------------------------------+
|  2023-04-03  | project1   | dataset_B    | table_t    |            0                 |         32513713981           |
+--------------+------------+--------------+------------+------------------------------+-------------------------------+
|  2023-04-03  | project2   | dataset_C    | table_m    |      8894535352              |              0                |
+--------------+------------+--------------+------------+------------------------------+-------------------------------+
|  2023-04-03  | project2   | dataset_C    | table_n    |      4183337201              |              0                |
+--------------+------------+--------------+------------+------------------------------+-------------------------------+