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 da alcuni secondi ad alcuni minuti.
Le visualizzazioni dello spazio di archiviazione delle tabelle offrono un modo conveniente per osservare il consumo attuale di spazio di archiviazione e forniscono dettagli sull'utilizzo o meno di byte logici non compressi, byte compressi fisici o byte viaggi nel tempo. Queste informazioni possono aiutarti con attività come la pianificazione della crescita futura e la comprensione dei pattern di aggiornamento delle tabelle.
Dati inclusi nelle colonne *_BYTES
Le colonne *_BYTES nelle visualizzazioni tabella dello spazio di archiviazione includono informazioni sull'utilizzo dei byte di archiviazione. Queste informazioni vengono determinate esaminando l'utilizzo dello spazio di archiviazione per le viste materializzate e i seguenti tipi di tabelle:
- Tabelle permanenti create tramite uno dei metodi descritti in Creare e utilizzare 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 ("script"). Queste tabelle sono inserite in set di dati con nomi generati come "_script72280c173c88442c3a7200183a50eeeaa4073719".
I dati archiviati nella cache dei risultati delle query non ti vengono addebitati e quindi non sono inclusi nei valori della colonna *_BYTES.
I cloni e gli snapshot mostrano i valori di colonna *_BYTES come se fossero tabelle complete, anziché mostrare il delta dello spazio di archiviazione utilizzato dalla tabella di base, pertanto sono una sovrastima. La tua fattura tiene conto correttamente di questo
delta nell'utilizzo dello spazio di archiviazione. Per ulteriori informazioni sui byte delta archiviati e fatturati da cloni e
snapshot, consulta la vista TABLE_STORAGE_USAGE_TIMELINE.
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 questa è solo una previsione approssimativa e gli importi esatti di fatturazione sono calcolati in base all'utilizzo da parte dell'infrastruttura di fatturazione dello spazio di archiviazione di BigQuery ed sono visibili in Fatturazione Cloud.
Per i set di dati che utilizzano un modello di fatturazione logica, puoi prevedere i costi di archiviazione mensili come segue:
(((valore ACTIVE_LOGICAL_BYTES / POW(1024, 3)) * prezzo per byte logici attivi) +
((valore di LONG_TERM_LOGICAL_BYTES / POW(1024, 3)) * prezzo per byte logici a lungo termine)
Il valore ACTIVE_LOGICAL_BYTES di una tabella riflette i byte attivi
attualmente utilizzati dalla tabella.
Per i set di dati che utilizzano un modello di fatturazione fisico, puoi prevedere i costi di archiviazione come segue:
(((valore di ACTIVE_PHYSICAL_BYTES + FAIL_SAFE_PHYSICAL_BYTES / POW(1024, 3))) * prezzo per byte fisici attivi) +
((valore di LONG_TERM_PHYSICAL_BYTES / POW(1024, 3)) * prezzo di byte fisici a lungo termine)
Il valore ACTIVE_PHYSICAL_BYTES di una tabella riflette i byte attivi attualmente utilizzati dalla tabella più i byte utilizzati per il viaggio cronologico della 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 vista INFORMATION_SCHEMA.TABLE_STORAGE_BY_ORGANIZATION, devi disporre delle seguenti autorizzazioni di Identity and Access Management (IAM) per la tua organizzazione:
bigquery.tables.getbigquery.tables.list
Ciascuno dei seguenti ruoli IAM predefiniti include le autorizzazioni precedenti:
roles/bigquery.adminroles/bigquery.dataViewerroles/bigquery.dataEditorroles/bigquery.metadataViewer
Questa visualizzazione 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 che contiene 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, chiamato anche datasetId. |
TABLE_NAME |
STRING |
Il nome della tabella o della vista materializzata, indicato anche come
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 nella vista materializzata. |
ACTIVE_LOGICAL_BYTES |
INT64 |
Numero di byte logici (non compressi) precedenti a 90 giorni. |
LONG_TERM_LOGICAL_BYTES |
INT64 |
Numero di byte logici (non compressi) precedenti a 90 giorni. |
CURRENT_PHYSICAL_BYTES |
INT64 |
Numero totale di byte fisici per l'archiviazione attuale della tabella in tutte le partizioni. |
TOTAL_PHYSICAL_BYTES |
INT64 |
Numero totale di byte fisici (compressi) utilizzati per l'archiviazione, inclusi i byte attivi, a lungo termine e per i viaggi nel tempo (dati eliminati o modificati). I byte a prova di errore (dati eliminati o modificati conservati dopo il periodo di viaggio temporale) non sono inclusi. |
ACTIVE_PHYSICAL_BYTES |
INT64 |
Numero di byte fisici (compressi) meno di 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 dall'archiviazione a prova di errore (dati eliminati o modificati). |
Ambito e sintassi
Le query relative a questa vista 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 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 di archiviazione per le tabelle in un progetto specificato in un'organizzazione:
SELECT * FROM `myProject`.`region-REGION`.INFORMATION_SCHEMA.TABLE_STORAGE_BY_ORGANIZATION;
L'esempio seguente mostra come restituire le informazioni di archiviazione in base al progetto per le tabelle in un'organizzazione:
SELECT * FROM `region-REGION`.INFORMATION_SCHEMA.TABLE_STORAGE_BY_ORGANIZATION;
Esempio
L'esempio seguente mostra quali progetti di un'organizzazione utilizzano attualmente più 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 | +---------------------+---------------------+