Diese Seite wurde von der Cloud Translation API übersetzt.

Ansicht TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER

In der Ansicht INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER wird für die folgenden Tabellentypen die tägliche Gesamtspeichernutzung für die letzten 90 Tage angezeigt.

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

Die Ansicht INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER schließt Tabellen ohne abrechenbare Byte aus. Die folgenden Tabellentypen sind ausgeschlossen:

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_FOLDER abfragen, wird im Ergebnis jede Tabelle oder materialisierte Ansicht im übergeordneten Ordner des aktuellen Projekts, einschließlich der Unterordner, in einer eigenen Zeile pro Tag dargestellt.

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 Ansicht gibt die Speichernutzung in MiB/Sekunden zurück. 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 MiB-Sekunden umgewandelt, wie im folgenden Beispiel gezeigt:

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

Den Wert für die Speichernutzung finden Sie in der Spalte BILLABLE_TOTAL_PHYSICAL_USAGE. Weitere Informationen finden Sie unter Details zu Speicherpreisen.

Erforderliche Berechtigungen

Zum Abfragen der INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER-Ansicht benötigen Sie die folgenden IAM-Berechtigungen (Identity and Access Management) für den übergeordneten Ordner des Projekts:

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

Weitere Informationen zu BigQuery-Berechtigungen finden Sie unter BigQuery-IAM-Rollen und -Berechtigungen.

Schema

Die Ansicht INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER hat das folgende Schema:

`USAGE_DATE`	`DATE`	Das Abrechnungsdatum für die angezeigten Byte in der Zeitzone `America/Los_Angeles`
`FOLDER_NUMBERS`	`REPEATED INTEGER`	Nummern-IDs der Ordner, die das Projekt enthalten, beginnend mit dem Ordner, der das Projekt unmittelbar enthält, gefolgt vom Ordner, der den Unterordner enthält, und so weiter. Beispiel: `FOLDER_NUMBERS` ist `[1, 2, 3]`, dann enthält Ordner `1` sofort das Projekt, Ordner `2` enthält `1` und Ordner `3` enthält `2`. Diese Spalte enthält nur in `TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER` Werte.
`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 MiB-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 MiB-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 MiB-Sekunden. Gibt 0 zurück, wenn das Dataset das Abrechnungsmodell für physischen Speicher verwendet.
`BILLABLE_TOTAL_PHYSICAL_USAGE`	`INT64`	Die Gesamtnutzung in MiB-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 MiB-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 MiB-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_FOLDER	Ordner, der 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: Zum Abfragen von INFORMATION_SCHEMA-Ansichten müssen Sie einen Regions-Qualifier verwenden. Der Ort der Abfrageausführung muss mit der Region der INFORMATION_SCHEMA-Ansicht übereinstimmen.

Führen Sie die folgende Abfrage aus, um Speicherinformationen für Tabellen im übergeordneten Ordner des angegebenen Projekts abzurufen:

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

Beispiel

Die folgende Abfrage zeigt die Nutzung aller Tabellen im Ordner für das jeweils neueste Datum an:

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