Visualizzazione TABLE_STORAGE_USAGE_TIMELINE_BY_ORGANIZATION

La visualizzazione INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_ORGANIZATION fornisce i totali giornalieri dell'utilizzo dello spazio di archiviazione 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

Le tabelle che non hanno byte fatturabili non sono incluse nella visualizzazione INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_ORGANIZATION. Sono inclusi 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 vista INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_ORGANIZATION, i risultati della query contengono una riga al giorno per ogni tabella o vista materializzata per l'intera organizzazione associata al progetto corrente.

I dati di questa tabella non sono disponibili in tempo reale. Sono necessarie circa 72 ore prima che i dati della tabella vengano visualizzati in questa visualizzazione.

L'utilizzo dello spazio di archiviazione viene restituito in MiB al secondo. 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 vengono convertiti in 82.397 MiB secondi, come mostrato nell'esempio seguente:

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

Questo è il valore che verrebbe restituito dalla 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_ORGANIZATION, devi disporre delle seguenti autorizzazioni Identity and Access Management (IAM) per la tua organizzazione:

• 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

Questa visualizzazione dello schema è disponibile solo per gli utenti con organizzazioniTrusted Cloud by S3NSdefinite.

Per ulteriori informazioni sulle autorizzazioni BigQuery, consulta Controllo dell'accesso con IAM.

Schema

La vista INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_ORGANIZATION 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`.

L'esempio seguente mostra come restituire le informazioni sullo spazio di archiviazione per le tabelle in un progetto specificato di un'organizzazione:

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

L'esempio seguente mostra come restituire le informazioni di archiviazione per progetto per le tabelle di un'organizzazione:

SELECT * FROM `region-REGION`.INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_ORGANIZATION;

Esempio

L'esempio seguente mostra l'utilizzo per tutte le tabelle dell'organizzazione per la data di utilizzo 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_ORGANIZATION
  )
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                   |
+--------------+------------+--------------+------------+------------------------------+-------------------------------+