Questa pagina è stata tradotta dall'API Cloud Translation.

Visualizzazione TABLE_STORAGE_USAGE_TIMELINE_BY_ORGANIZATION

La vista INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_ORGANIZATION fornisce i totali giornalieri di utilizzo dello spazio di archiviazione per gli ultimi 90 giorni per i seguenti tipi di tabelle:

Tabelle standard
Viste materializzate
Cloni di tabelle che hanno un delta in byte dalla tabella di base
Snapshot della tabella con un delta in byte dalla tabella di base

Le tabelle che non hanno byte fatturabili non sono incluse nel INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_ORGANIZATION visualizzazione. Questo include i seguenti tipi di tabelle:

Tabelle esterne
Tabelle anonime
Tabelle vuote
Cloni di tabelle senza delta in byte dalla tabella di base
Snapshot della tabella senza delta in byte dalla tabella di base

Quando esegui una query su 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 progetto attuale.

I dati di questa tabella non sono disponibili in tempo reale. Ci vogliono circa 72 ore necessarie per la visualizzazione dei dati della tabella in questa vista.

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), il totale è di 86.400.000.000 di secondi, che viene convertito in 82.397 MB secondi, come mostrato nell'esempio seguente:

86,400,000,000 / 1,024 / 1,024 = 82,397

Questo è il valore che verrebbe restituito dall'BILLABLE_TOTAL_PHYSICAL_USAGE colonna.

Per ulteriori informazioni, vedi Dettagli sui prezzi dell'archiviazione.

Autorizzazioni obbligatorie

Per eseguire una query sulla vista INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_ORGANIZATION, devi 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 autorizzazioni:

roles/bigquery.dataViewer
roles/bigquery.dataEditor
roles/bigquery.metadataViewer
roles/bigquery.admin

Questa vista schema è disponibile solo per gli utenti che hanno definito Google Cloud organizations.

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

Schema

La vista INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_ORGANIZATION ha le schema riportato di seguito:

`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, noto anche come `datasetId`
`TABLE_NAME`	`STRING`	Il nome della tabella o della vista materializzata, indicato anche come `tableId`
`BILLABLE_TOTAL_LOGICAL_USAGE`	`INT64`	L'utilizzo logico totale, in MB secondi. Restituisce 0 se il set di dati utilizza l'archiviazione fisica modello di fatturazione.
`BILLABLE_ACTIVE_LOGICAL_USAGE`	`INT64`	L'utilizzo logico risalente a non più di 90 giorni, in MB secondo. Restituisce 0 se il set di dati utilizza l'archiviazione fisica modello di fatturazione.
`BILLABLE_LONG_TERM_LOGICAL_USAGE`	`INT64`	L'utilizzo logico risalente a più di 90 giorni, in MB secondo. Restituisce 0 se il set di dati utilizza l'archiviazione fisica modello di fatturazione.
`BILLABLE_TOTAL_PHYSICAL_USAGE`	`INT64`	L'utilizzo totale in MB secondo. Sono inclusi byte fisici utilizzati per attività di sicurezza di archiviazione dei viaggi nel tempo. Restituisce 0 se il set di dati utilizza l'archiviazione logica modello di fatturazione.
`BILLABLE_ACTIVE_PHYSICAL_USAGE`	`INT64`	L'utilizzo fisico da meno di 90 giorni, in MB al secondo. Questo include i byte fisici utilizzati per le attività di sicurezza di archiviazione dei viaggi nel tempo. Restituisce 0 se il set di dati utilizza l'archiviazione logica modello di fatturazione.
`BILLABLE_LONG_TERM_PHYSICAL_USAGE`	`INT64`	Per l'utilizzo fisico da più di 90 giorni, in MB al secondo. Restituisce 0 se il set di dati utilizza l'archiviazione logica modello di fatturazione.

Ambito e sintassi

Le query relative a questa vista devono includere un qualificatore regione. Se non specifichi un qualificatore regionale, i metadati vengono recuperati da tutti regioni. 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_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.

Nota: devi utilizzare un qualificatore di regione per eseguire query su INFORMATION_SCHEMA viste. La posizione della query l'esecuzione deve corrispondere alla regione della vista INFORMATION_SCHEMA.

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_USAGE_TIMELINE_BY_ORGANIZATION;

L'esempio seguente mostra come restituire le informazioni di archiviazione per progetto tabelle in 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 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                   |
+--------------+------------+--------------+------------+------------------------------+-------------------------------+