Visualizzazione TABLE_STORAGE_BY_ORGANIZATION
La vista INFORMATION_SCHEMA.TABLE_STORAGE_BY_ORGANIZATION
contiene una riga per ogni tabella o vista materializzata per l'intera organizzazione associata al progetto corrente. I dati in questa tabella non vengono conservati in tempo reale e potrebbero essere ritardati di alcuni secondi o minuti.
Le visualizzazioni dello spazio di archiviazione delle tabelle ti offrono un modo pratico per osservare il tuo attuale consumo di spazio di archiviazione e, inoltre, forniscono dettagli su se lo suo spazio di archiviazione utilizza byte logici non compressi, byte fisici compressi o byte di viaggio nel tempo. Queste informazioni possono aiutarti con attività come la pianificazione la crescita futura e comprendere i pattern di aggiornamento delle tabelle.
Dati inclusi nelle colonne *_BYTES
Le colonne *_BYTES
nelle visualizzazioni dello spazio di archiviazione delle tabelle includono informazioni sull'utilizzo dei byte di spazio di archiviazione. Queste informazioni vengono determinate esaminando il tuo spazio di archiviazione
per le viste materializzate e i seguenti tipi di tabelle:
- Tabelle permanenti create con uno dei metodi descritti in Creare e utilizzare le tabelle.
- Tabelle temporanee create nelle sessioni. Queste tabelle sono inserite in set di dati con nomi generati come "_c018003e063d09570001ef33ae401fad6ab92a6a".
- Tabelle temporanee create in query con più istruzioni ("scripts"). Queste tabelle sono inserite in set di dati con nomi generati come "_script72280c173c88442c3a7200183a50eeeaa4073719".
I dati archiviati nel
cache dei risultati delle query
non ti viene addebitato e quindi non è incluso nei valori della colonna *_BYTES
.
Cloni e snapshot mostrano i valori di colonna *_BYTES
come se fossero completi
anziché mostrare il delta rispetto allo spazio di archiviazione utilizzato dalla tabella di base,
quindi sono una sovrastima. La fattura tiene conto correttamente di questo delta
nell'utilizzo dello spazio di archiviazione. Per ulteriori informazioni sui byte delta archiviati e fatturati tramite cloni
di snapshot, consulta TABLE_STORAGE_USAGE_TIMELINE
vista.
Previsione della fatturazione dello spazio di archiviazione
Per prevedere la fatturazione mensile dello spazio di archiviazione per un set di dati, puoi utilizzare le colonne logical
o physical *_BYTES
in questa visualizzazione, a seconda del modello di fatturazione dello spazio di archiviazione del set di dati utilizzato dal set di dati. Tieni presente che si tratta solo di una previsione approssimativa e che gli importi esatti della fatturazione vengono calcolati in base all'utilizzo dell'infrastruttura di fatturazione dello spazio di archiviazione BigQuery e sono visibili in Cloud Billing.
Per i set di dati che utilizzano un modello di fatturazione logico, puoi prevedere i costi di archiviazione mensili come segue:
((ACTIVE_LOGICAL_BYTES
value / POW
(1024, 3)) * active logical bytes pricing) +
((LONG_TERM_LOGICAL_BYTES
value / POW
(1024, 3)) * long-term logical bytes pricing)
Il valore ACTIVE_LOGICAL_BYTES
di una tabella riflette i byte attivi
attualmente usati dalla tabella.
Per i set di dati che utilizzano un modello di fatturazione fisico, puoi prevedere lo spazio di archiviazione come indicato di seguito:
((valore ACTIVE_PHYSICAL_BYTES + FAIL_SAFE_PHYSICAL_BYTES
/ POW
(1024, 3)) * prezzo per byte fisici attivi) +
((valore LONG_TERM_PHYSICAL_BYTES
/ POW
(1024, 3)) * prezzo per byte fisici a lungo termine)
Il valore ACTIVE_PHYSICAL_BYTES
di una tabella riflette i byte attivi
attualmente utilizzato da quella tabella più i byte utilizzati per lo spostamento cronologico di quella tabella.
Per visualizzare solo i byte attivi della tabella, sottrai il valore TIME_TRAVEL_PHYSICAL_BYTES
dal valore ACTIVE_PHYSICAL_BYTES
.
Per ulteriori informazioni, vedi Prezzi dello spazio di archiviazione.
Autorizzazioni obbligatorie
Per eseguire query sulla visualizzazione INFORMATION_SCHEMA.TABLE_STORAGE_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.admin
roles/bigquery.dataViewer
roles/bigquery.dataEditor
roles/bigquery.metadataViewer
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_BY_ORGANIZATION
ha il seguente schema:
Nome colonna | Tipo di dati | Valore |
---|---|---|
PROJECT_ID |
STRING |
L'ID del progetto che contiene il set di dati. |
PROJECT_NUMBER |
INT64 |
Il numero del progetto contenente il set di dati. |
TABLE_CATALOG |
STRING |
L'ID 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,
noto anche come datasetId . |
TABLE_NAME |
STRING |
Il nome della tabella o della vista materializzata, chiamato anche
tableId . |
CREATION_TIME |
TIMESTAMP |
L'ora di creazione della tabella. |
TOTAL_ROWS |
INT64 |
Il numero totale di righe nella tabella o nella vista materializzata. |
TOTAL_PARTITIONS |
INT64 |
Il numero di partizioni presenti nella tabella o nella vista materializzata. Le tabelle non partizionate restituiscono 0. |
TOTAL_LOGICAL_BYTES |
INT64 |
Numero totale di byte logici (non compressi) nella tabella o vista materializzata. |
ACTIVE_LOGICAL_BYTES |
INT64 |
Numero di byte logici (non compressi) risalenti a meno di 90 giorni fa. |
LONG_TERM_LOGICAL_BYTES |
INT64 |
Numero di byte logici (non compressi) che risalgono a più di 90 giorni fa. |
CURRENT_PHYSICAL_BYTES |
INT64 |
Numero totale di byte fisici per l'archiviazione corrente della tabella in tutte le partizioni. |
TOTAL_PHYSICAL_BYTES |
INT64 |
Numero totale di byte fisici (compressi) utilizzati per l'archiviazione, inclusi i viaggi attivi, a lungo termine e nel tempo (dati eliminati o modificati) byte. I byte di fail-safe (dati eliminati o modificati conservati dopo la finestra di time-travel) non sono inclusi. |
ACTIVE_PHYSICAL_BYTES |
INT64 |
Numero di byte fisici (compressi) inferiori a 90 giorni, inclusi i byte relativi ai viaggi nel tempo (dati eliminati o modificati). |
LONG_TERM_PHYSICAL_BYTES |
INT64 |
Numero di byte fisici (compressi) risalenti a più di 90 giorni fa. |
TIME_TRAVEL_PHYSICAL_BYTES |
INT64 |
Numero di byte fisici (compressi) utilizzati per l'archiviazione dei viaggi nel tempo (dati eliminati o modificati). |
STORAGE_LAST_MODIFIED_TIME |
TIMESTAMP |
L'ora più recente in cui i dati sono stati scritti nella tabella. |
DELETED |
BOOLEAN |
Indica se la tabella è stata eliminata o meno. |
TABLE_TYPE |
STRING |
Il tipo di tabella. Ad esempio, EXTERNAL o
BASE TABLE .
|
FAIL_SAFE_PHYSICAL_BYTES |
INT64 |
Numero di byte fisici (compressi) utilizzati dallo spazio di archiviazione fail-safe (dati eliminati o modificati). |
LAST_METADATA_INDEX_REFRESH_TIME |
TIMESTAMP |
L'ora dell'ultimo aggiornamento dell'indice dei metadati della tabella. |
Ambito e sintassi
Le query su questa visualizzazione devono includere un qualificatore regione. La tabella seguente spiega l'ambito della regione per questa visualizzazione:
Nome vista | Ambito risorsa | Ambito della regione |
---|---|---|
[`PROJECT_ID`.]`region-REGION`.INFORMATION_SCHEMA.TABLE_STORAGE_BY_ORGANIZATION |
Organizzazione che contiene il progetto specificato | REGION |
- (Facoltativo)
PROJECT_ID
: l'ID del tuo progetto Google Cloud. Se non viene 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_BY_ORGANIZATION;
Il seguente esempio 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_BY_ORGANIZATION;
Esempio
L'esempio riportato di seguito mostra quali progetti di un'organizzazione utilizzano attualmente la maggior quantità di spazio di archiviazione.
SELECT project_id, SUM(total_logical_bytes) AS total_logical_bytes FROM `region-REGION`.INFORMATION_SCHEMA.TABLE_STORAGE_BY_ORGANIZATION GROUP BY project_id ORDER BY total_logical_bytes DESC;
Il risultato è simile al seguente:
+---------------------+---------------------+ | project_id | total_logical_bytes | +---------------------+---------------------+ | projecta | 971329178274633 | +---------------------+---------------------+ | projectb | 834638211024843 | +---------------------+---------------------+ | projectc | 562910385625126 | +---------------------+---------------------+