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 negli 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

Le tabelle che non hanno byte fatturabili non sono incluse nella INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_ORGANIZATION visualizzazione. Sono inclusi 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_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 in questa tabella non sono disponibili in tempo reale. Sono necessarie circa 72 ore affinché 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 è pari a 86.400.000.000 byte secondi, che viene convertito 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, hai bisogno delle seguenti autorizzazioni IAM (Identity and Access Management) per la tua organizzazione:

  • 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

Questa visualizzazione dello schema è disponibile solo per gli utenti con organizzazioni Google Cloud definite.

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

Schema

La vista INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_ORGANIZATION ha il seguente schema:

USAGE_DATE DATE La data di fatturazione per i byte mostrati, utilizzando il fuso orario America/Los_Angeles
PROJECT_ID STRING L'ID del progetto contenente il set di dati
TABLE_CATALOG STRING L'ID del progetto contenente il set di dati
PROJECT_NUMBER INT64 Il numero del progetto contenente il set di dati
TABLE_SCHEMA STRING Il nome del set di dati che contiene la tabella o la vista materializzata, noto anche come datasetId
TABLE_NAME STRING Il nome della tabella o della vista materializzata, chiamato anche tableId
BILLABLE_TOTAL_LOGICAL_USAGE INT64

L'utilizzo logico totale, in MiB al secondo.

Restituisce 0 se il set di dati utilizza il modello di fatturazione dello spazio di archiviazione fisico.

BILLABLE_ACTIVE_LOGICAL_USAGE INT64

L'utilizzo logico risale a meno di 90 giorni fa, in MiB al secondo.

Restituisce 0 se il set di dati utilizza il modello di fatturazione dello spazio di archiviazione fisico.

BILLABLE_LONG_TERM_LOGICAL_USAGE INT64

L'utilizzo logico risalente a più di 90 giorni fa, in MiB secondo.

Restituisce 0 se il set di dati utilizza il modello di fatturazione dello spazio di archiviazione fisico.

BILLABLE_TOTAL_PHYSICAL_USAGE INT64

L'utilizzo totale in MiB al secondo. Sono inclusi i byte fisici utilizzati per lo archiviazione con fail-safe e spostamento cronologico.

Restituisce 0 se il set di dati utilizza il modello di fatturazione dello spazio di archiviazione logico.

BILLABLE_ACTIVE_PHYSICAL_USAGE INT64

L'utilizzo fisico risalente a meno di 90 giorni fa, in MiB al secondo. Sono inclusi i byte fisici utilizzati per lo spazio di archiviazione con fail-safe e spostamento cronologico.

Restituisce 0 se il set di dati utilizza il modello di fatturazione dello spazio di archiviazione logico.

BILLABLE_LONG_TERM_PHYSICAL_USAGE INT64

L'utilizzo fisico risalente a più di 90 giorni fa, in MiB al secondo.

Restituisce 0 se il set di dati utilizza il modello di fatturazione dello spazio di archiviazione logico.

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:

Nome vista Ambito risorsa Ambito regione
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_ORGANIZATION Organizzazione che contiene il progetto specificato 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`.

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

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

    L'esempio seguente mostra come restituire le informazioni sullo spazio 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 di 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                   |
    +--------------+------------+--------------+------------+------------------------------+-------------------------------+