Visualizzazione TABLE_STORAGE_BY_organization

La vista INFORMATION_SCHEMA.TABLE_STORAGE_BY_ORGANIZATION contiene una riga per ogni tabella o la 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 qualche secondo a qualche minuto.

Le viste dell'archiviazione della tabella offrono un modo pratico per osservare l'attuale consumo di archiviazione e, inoltre, forniscono dettagli sull'utilizzo da parte dello spazio di archiviazione di byte logici non compressi, byte fisici compressi o byte di viaggio nel tempo. Queste informazioni possono aiutarti con attività come la pianificazione della crescita futura e la comprensione dei pattern di aggiornamento per le tabelle.

Dati inclusi in *_BYTES colonne

Le colonne *_BYTES nelle visualizzazioni di archiviazione della tabella 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 le tabelle.
  • Tabelle temporanee create in sessioni. Queste tabelle vengono inserite in set di dati con nomi generati come "_c018003e063d09570001ef33ae401fad6ab92a6a".
  • Tabelle temporanee create in query a più istruzioni ("script"). Queste tabelle vengono inserite in set di dati con nomi generati come "_script72280c173c88442c3a7200183a50eeeaa4073719".

I dati archiviati nella cache dei risultati delle query non ti vengono fatturati, quindi non sono inclusi nei valori della colonna *_BYTES.

Cloni e snapshot mostrano i valori delle colonne *_BYTES come se fossero tabelle complete, anziché mostrare il delta rispetto allo spazio di archiviazione utilizzato dalla tabella di base, perciò si tratta di 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 per cloni e snapshot, consulta la vista TABLE_STORAGE_USAGE_TIMELINE.

Fatturazione per l'archiviazione delle previsioni

Per prevedere la fatturazione mensile dello spazio di archiviazione per un set di dati, puoi utilizzare le colonne logical o physical *_BYTES in questa vista, a seconda del modello di fatturazione dell'archiviazione del set di dati utilizzato dal set di dati. Tieni presente che questa è solo una previsione approssimativa e che gli importi di fatturazione precisi vengono calcolati in base all'utilizzo da parte dell'infrastruttura di fatturazione dello spazio di archiviazione di BigQuery e sono visibili in Fatturazione Cloud.

Per i set di dati che utilizzano un modello di fatturazione logico, puoi prevedere i costi di archiviazione mensili come segue:

((Valore ACTIVE_LOGICAL_BYTES / POW(1024, 3)) * Prezzi dei byte logici attivi) + ((LONG_TERM_LOGICAL_BYTESvalore / POW(1024, 3)) * Prezzi dei byte logici a lungo termine)

Il valore ACTIVE_LOGICAL_BYTES per 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:

((ACTIVE_PHYSICAL_BYTES + FAIL_SAFE_PHYSICAL_BYTES valore / POW(1024, 3)) * prezzo byte fisici attivi) + ((LONG_TERM_PHYSICAL_BYTES valore / POW(1024, 3)) * prezzo byte fisici a lungo termine)

Il valore ACTIVE_PHYSICAL_BYTES per una tabella riflette i byte attivi attualmente utilizzati da quella tabella più i byte utilizzati per il viaggio nel tempo per quella tabella.

Per vedere i byte attivi della sola tabella, sottrai il valore TIME_TRAVEL_PHYSICAL_BYTES dal valore di ACTIVE_PHYSICAL_BYTES.

Per maggiori informazioni, vedi Prezzi dell'archiviazione.

Autorizzazioni obbligatorie

Per eseguire una query sulla vista 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 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_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
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
CREATION_TIME TIMESTAMP L'ora di creazione della tabella
DELETED BOOLEAN Indica se la tabella è stata eliminata o meno
STORAGE_LAST_MODIFIED_TIME TIMESTAMP L'ultima volta in cui i dati sono stati scritti nella 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) risalenti a meno di 90 giorni fa
LONG_TERM_LOGICAL_BYTES INT64 Numero di byte logici (non compressi) risalenti a più di 90 giorni
TOTAL_PHYSICAL_BYTES INT64 Numero totale di byte fisici (compressi) utilizzati per l'archiviazione, inclusi byte attivi, a lungo termine e relativi al tempo di percorrenza (dati eliminati o modificati)
ACTIVE_PHYSICAL_BYTES INT64 Numero di byte fisici (compressi) risalenti a meno di 90 giorni fa, inclusi i byte relativi ai viaggi nel tempo (dati eliminati o modificati)
LONG_TERM_PHYSICAL_BYTES INT64 Numero di byte fisici (compressi) vecchi di 90 giorni
TIME_TRAVEL_PHYSICAL_BYTES INT64 Numero di byte fisici (compressi) utilizzati dall'archiviazione dei viaggi nel tempo (dati eliminati o modificati)
FAIL_SAFE_PHYSICAL_BYTES INT64 Numero di byte fisici (compressi) utilizzati dall'archiviazione a prova di errore (dati eliminati o modificati)
TABLE_TYPE STRING Il tipo di tabella. Ad esempio, "EXTERNAL" o "BASE TABLE"

Ambito e sintassi

Le query in questa vista devono includere un qualificatore regione. 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_BY_ORGANIZATION Organizzazione contenente 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 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 informazioni sullo spazio di archiviazione per 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 la maggiore 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 |
+---------------------+---------------------+