Visualizzazione TABLE_STORAGE_USAGE_TIMELINE_BY_organization
La vista INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_ORGANIZATION
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 dalla tabella di base
- Snapshot 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 dalla tabella di base
- Snapshot tabella senza delta in byte dalla 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. Occorrono circa 72 ore per visualizzare i dati della tabella in questa visualizzazione.
L'utilizzo dello spazio di archiviazione viene restituito in MB 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 di secondi di byte, che vengono convertiti in 82.397 MB di secondi, come mostrato nell'esempio seguente:
86,400,000,000 / 1,024 / 1,024 = 82,397
Questo è il valore restituito dalla colonna BILLABLE_TOTAL_PHYSICAL_USAGE
.
Per ulteriori informazioni, consulta i dettagli dei prezzi dell'archiviazione.
Autorizzazioni obbligatorie
Per eseguire una query sulla vista INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_ORGANIZATION
, devi disporre 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 schema è disponibile solo per gli utenti con organizzazioni Google Cloud definite.
Per maggiori 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 |
PROJECT_ID |
STRING |
L'ID del progetto che contiene il set di dati |
TABLE_CATALOG |
STRING |
L'ID del progetto che contiene il set di dati |
PROJECT_NUMBER |
INT64 |
Il numero del progetto che contiene il set di dati |
TABLE_SCHEMA |
STRING |
Il nome del set di dati che contiene la tabella o la vista materializzata, denominata anche datasetId |
TABLE_NAME |
STRING |
Il nome della tabella o della vista materializzata, denominata anche
tableId |
BILLABLE_TOTAL_LOGICAL_USAGE |
INT64 |
L'utilizzo logico totale, in MB al secondo. Restituisce 0 se il set di dati utilizza il modello di fatturazione dell'archiviazione fisica. |
BILLABLE_ACTIVE_LOGICAL_USAGE |
INT64 |
L'utilizzo logico risalente a meno di 90 giorni fa, in MB al secondo. Restituisce 0 se il set di dati utilizza il modello di fatturazione dell'archiviazione fisica. |
BILLABLE_LONG_TERM_LOGICAL_USAGE |
INT64 |
L'utilizzo logico risalente a più di 90 giorni fa, in MB al secondo. Restituisce 0 se il set di dati utilizza il modello di fatturazione dell'archiviazione fisica. |
BILLABLE_TOTAL_PHYSICAL_USAGE |
INT64 |
L'utilizzo totale in MB al secondo. Sono inclusi i byte fisici utilizzati per l'archiviazione a prova di errore e per l'archiviazione dei viaggi nel tempo. Restituisce 0 se il set di dati utilizza il modello di fatturazione di archiviazione logico. |
BILLABLE_ACTIVE_PHYSICAL_USAGE |
INT64 |
L'utilizzo fisico risalente a meno di 90 giorni fa, in MB al secondo. Ciò include i byte fisici utilizzati per l'archiviazione a prova di errore e per l'archiviazione dei viaggi nel tempo. Restituisce 0 se il set di dati utilizza il modello di fatturazione di archiviazione logico. |
BILLABLE_LONG_TERM_PHYSICAL_USAGE |
INT64 |
L'utilizzo fisico risalente a più di 90 giorni, in MB al secondo. Restituisce 0 se il set di dati utilizza il modello di fatturazione di archiviazione logico. |
Ambito e sintassi
Le query in questa vista devono includere un qualificatore 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:
Nome vista | Ambito risorsa | Ambito regione |
---|---|---|
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_ORGANIZATION |
Organizzazione contenente il progetto specificato | REGION |
- (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 informazioni di archiviazione per le tabelle in 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 informazioni sullo spazio di archiviazione per progetto per le tabelle in 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 nell'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 | +--------------+------------+--------------+------------+------------------------------+-------------------------------+