Ansicht TABLE_STORAGE_TIMELINE_BY_ORGANIZATION

Die Ansicht INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_ORGANIZATION gibt den Gesamtwert der Speichernutzung für die letzten 90 Tage für die folgenden Tabellentypen an:

Standardtabellen
Materialisierte Ansichten
Tabellenklone mit einem Byte-Delta aus der Basistabelle
Tabellen-Snapshots mit einem Byte-Delta aus der Basistabelle

Tabellen ohne kostenpflichtige Byte sind in der Ansicht INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_ORGANIZATION nicht enthalten. Dazu gehören die folgenden Tabellentypen:

Externe Tabellen
Anonyme Tabellen
Leere Tabellen
Tabellenklone ohne Byte-Delta aus der Basistabelle
Tabellen-Snapshots ohne Byte-Delta aus der Basistabelle

Wenn Sie die Ansicht INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_ORGANIZATION abfragen, enthalten die Ergebnisse eine Zeile pro Tag für jede Tabelle oder materialisierte Ansicht für die gesamte Organisation, die dem aktuellen Projekt zugeordnet ist.

Die Daten in dieser Tabelle sind nicht in Echtzeit verfügbar. Es dauert ungefähr 72 Stunden, bis die realen Tabellendaten in dieser Ansicht wiedergegeben werden.

Die Speichernutzung wird in MB-Sekunden zurückgegeben. Wenn ein Projekt beispielsweise 1.000.000 physische Byte für 86.400 Sekunden (24 Stunden) verwendet, beträgt die physische Nutzung insgesamt 86.400.000.000 Bytesekunden. Dies wird in 82.397 MB-Sekunden umgewandelt, wie im folgenden Beispiel gezeigt:

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

Das ist der Wert, der in der Spalte BILLABLE_TOTAL_PHYSICAL_USAGE zurückgegeben wird.

Weitere Informationen finden Sie unter Details zu Speicherpreisen.

Erforderliche Berechtigungen

Zum Abfragen der Ansicht INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_ORGANIZATION benötigen Sie die folgenden IAM-Berechtigungen (Identity and Access Management) für Ihre Organisation:

bigquery.tables.get
bigquery.tables.list

Die folgenden vordefinierten IAM-Rollen enthalten jeweils die vorherigen Berechtigungen:

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

Diese Schemaansicht ist nur für Nutzer mit definierten Google Cloud-Organisationen verfügbar.

Weitere Informationen zu BigQuery-Berechtigungen finden Sie unter Zugriffssteuerung mit IAM.

Schema

Die Ansicht INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_ORGANIZATION hat das folgende Schema:

`USAGE_DATE`	`DATE`	Das Abrechnungsdatum für die angezeigten Byte
`PROJECT_ID`	`STRING`	Die ID des Projekts, das das Dataset enthält
`TABLE_CATALOG`	`STRING`	Die ID des Projekts, das das Dataset enthält
`PROJECT_NUMBER`	`INT64`	Die Nummer des Projekts, das das Dataset enthält
`TABLE_SCHEMA`	`STRING`	Der Name des Datasets, das die Tabelle oder materialisierte Ansicht enthält (auch als `datasetId` bezeichnet)
`TABLE_NAME`	`STRING`	Der Name der Tabelle oder materialisierten Ansicht (auch als `tableId` bezeichnet)
`BILLABLE_TOTAL_LOGICAL_USAGE`	`INT64`	Die logische Gesamtnutzung in MB-Sekunden. Gibt 0 zurück, wenn das Dataset das Abrechnungsmodell für physischen Speicher verwendet.
`BILLABLE_ACTIVE_LOGICAL_USAGE`	`INT64`	Die logische Nutzung, die weniger als 90 Tage alt ist, in MB-Sekunden. Gibt 0 zurück, wenn das Dataset das Abrechnungsmodell für physischen Speicher verwendet.
`BILLABLE_LONG_TERM_LOGICAL_USAGE`	`INT64`	Die logische Nutzung, die älter als 90 Tage ist, in MB-Sekunden. Gibt 0 zurück, wenn das Dataset das Abrechnungsmodell für physischen Speicher verwendet.
`BILLABLE_TOTAL_PHYSICAL_USAGE`	`INT64`	Die Gesamtnutzung in MB-Sekunden. Dies schließt physische Byte ein, die für die Ausfallsicherheit und Zeitreisenspeicher verwendet werden. Gibt 0 zurück, wenn das Dataset das Abrechnungsmodell für logischen Speicher verwendet.
`BILLABLE_ACTIVE_PHYSICAL_USAGE`	`INT64`	Die physische Nutzung, die weniger als 90 Tage alt ist, in MB-Sekunden. Dies schließt physische Byte ein, die für die Ausfallsicherheit und Zeitreisenspeicher verwendet werden. Gibt 0 zurück, wenn das Dataset das Abrechnungsmodell für logischen Speicher verwendet.
`BILLABLE_LONG_TERM_PHYSICAL_USAGE`	`INT64`	Die physische Nutzung, die älter als 90 Tage ist, in MB-Sekunden. Gibt 0 zurück, wenn das Dataset das Abrechnungsmodell für logischen Speicher verwendet.

Bereich und Syntax

Für Abfragen dieser Ansicht muss ein Regions-Qualifier verwendet werden. Wenn Sie keinen Regions-Qualifier angeben, werden Metadaten aus allen Regionen abgerufen. In der folgenden Tabelle wird der Regionsbereich für diese Ansicht erläutert:

Ansichtsname	Ressourcenbereich	Regionsbereich
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_ORGANIZATION	Organisation, die das angegebene Projekt enthält	`REGION`

Dabei gilt:

Optional: PROJECT_ID: die ID Ihres Google Cloud-Projekts. Wenn keine Angabe erfolgt, wird das Standardprojekt verwendet.
REGION: ist ein beliebiger Dataset-Regionsname. Beispiel: region-us

Hinweis: Sie müssen den Standort angeben, um die INFORMATION_SCHEMA-Ansichten abzufragen, und der Standort der Abfrageausführung muss mit der Region der Ansicht INFORMATION_SCHEMA übereinstimmen.

Im folgenden Beispiel wird gezeigt, wie Speicherinformationen für Tabellen in einem bestimmten Projekt einer Organisation zurückgegeben werden:

SELECT * FROM myProject.`region-REGION`.INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_ORGANIZATION;

Im folgenden Beispiel wird gezeigt, wie Speicherinformationen nach Projekt für Tabellen in einer Organisation zurückgegeben werden:

SELECT * FROM `region-REGION`.INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_ORGANIZATION;

Beispiel

Das folgende Beispiel zeigt die Nutzung aller Tabellen in der Organisation für das neueste Nutzungsdatum.

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;

Das Ergebnis sieht etwa so aus:

+--------------+------------+--------------+------------+------------------------------+-------------------------------+
| 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                   |
+--------------+------------+--------------+------------+------------------------------+-------------------------------+