Visualizzazione TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER

La visualizzazione INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER fornisce i totali di utilizzo dello spazio di archiviazione giornaliero degli ultimi 90 giorni per i seguenti tipi di tabelle.

• Tabelle standard
• Viste materializzate
• Cloni della tabella con un delta in byte rispetto alla tabella di base
• Snapshot della tabella 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 senza delta in byte rispetto alla tabella di base
• Snapshot della tabella senza delta in byte rispetto alla tabella di base

Quando esegui una query sulla visualizzazione 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 relative sottocartelle.

I dati di questa tabella non sono disponibili in tempo reale. I dati della tabella richiedono circa 72 ore per essere visualizzati in questa visualizzazione.

La visualizzazione restituisce l'utilizzo dello spazio di archiviazione in MiB secondi. Ad esempio, se un progetto utilizza 1.000.000 di byte fisici per 86.400 secondi (24 ore), l'utilizzo fisico totale è di 86.400.000.000 byte secondi, che si convertono 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, devi disporre delle seguenti autorizzazioni Identity and Access Management (IAM) per la cartella padre del progetto:

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

Ognuno 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 lo schema seguente:

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:

• (Facoltativo) PROJECT_ID: l'ID del tuo Trusted Cloud progetto. 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 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 nella 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                |
+--------------+------------+--------------+------------+------------------------------+-------------------------------+