Ansicht TABLE_SNAPSHOTS

Die Ansicht INFORMATION_SCHEMA.TABLE_SNAPSHOTS enthält Metadaten zu Ihren Tabellen-Snapshots. Weitere Informationen finden Sie unter Einführung in Tabellen-Snapshots.

Erforderliche Berechtigungen

Zum Abfragen der Ansicht INFORMATION_SCHEMA.TABLE_SNAPSHOTS benötigen Sie die IAM-Berechtigung (Identity and Access Management) bigquery.tables.list für den Datensatz. Die vordefinierte Rolle roles/bigquery.metadataViewer enthält die erforderliche Berechtigung.

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

Schema

Wenn Sie die Tabelle INFORMATION_SCHEMA.TABLE_SNAPSHOTS abfragen, wird im Ergebnis jeder Tabellen-Snapshot im angegebenen Dataset oder in der angegebenen Region in einer eigenen Zeile dargestellt.

Die Tabelle INFORMATION_SCHEMA.TABLE_SNAPSHOTS hat das folgende Schema: Die Standardtabelle, aus der der Tabellen-Snapshot erstellt wurde, wird als Basistabelle bezeichnet.

Spaltenname Datentyp Wert
table_catalog STRING Der Name des Projekts, das den Tabellen-Snapshot enthält
table_schema STRING Der Name des Datasets, das den Tabellen-Snapshot enthält
table_name STRING Der Name des Tabellen-Snapshots
base_table_catalog STRING Der Name des Projekts, das die Basistabelle enthält
base_table_schema STRING Der Name des Datasets, das die Basistabelle enthält
base_table_name STRING Der Name der Basistabelle
snapshot_time TIMESTAMP Der Zeitpunkt, zu dem der Tabellen-Snapshot erstellt wurde

Bereich und Syntax

Für Abfragen dieser Ansicht muss ein Dataset- oder Regions-Qualifier verwendet werden. Für Abfragen mit einem Dataset-Qualifier benötigen Sie Berechtigungen für das Dataset. Für Abfragen mit einem Regions-Qualifier müssen Sie Berechtigungen für das Projekt haben. Weitere Informationen finden Sie unter Syntax. In der folgenden Tabelle werden die Regions- und Ressourcenbereiche für diese Ansicht erläutert:

Ansichtsname Ressourcenbereich Regionsbereich
[`PROJECT_ID`.]`region-REGION`.INFORMATION_SCHEMA.TABLE_SNAPSHOTS auf Projektebene REGION
[`PROJECT_ID`.]DATASET_ID.INFORMATION_SCHEMA.TABLE_SNAPSHOTS Dataset-Ebene Dataset-Standort
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
  • DATASET_ID: die ID Ihres Datasets. Weitere Informationen finden Sie unter Dataset-Qualifier.

Beispiel

-- Returns metadata for the table snapshots in the specified dataset.
SELECT * FROM myDataset.INFORMATION_SCHEMA.TABLE_SNAPSHOTS;

-- Returns metadata for the table snapshots in the specified region.
SELECT * FROM `region-us`.INFORMATION_SCHEMA.TABLE_SNAPSHOTS;

Beispiel

Durch die folgende Abfrage werden Metadaten für die Tabellen-Snapshots im Dataset mydataset abgerufen. In diesem Beispiel wird der Tabellen-Snapshot myproject.mydataset.mytablesnapshot angezeigt, der aus der Basistabelle myproject.mydataset.mytable am 14. Mai 2021 um 12:00 Uhr UTC erstellt wurde.

SELECT *
FROM
  `myproject`.mydataset.INFORMATION_SCHEMA.TABLE_SNAPSHOTS;

Das Ergebnis sieht etwa so aus:

+----------------+---------------+-----------------+--------------------+-------------------+-----------------+-----------------------------+
| table_catalog  | table_schema  | table_name      | base_table_catalog | base_table_schema | base_table_name | snapshot_time               |
+----------------+---------------+-----------------+----------------------------------------------------------------------------------------+
| myproject      | mydataset     | mytablesnapshot | myProject          | mydataset         | mytable         | 2021-05-14 12:00:00.000 UTC |
+----------------+---------------+-----------------+--------------------+-------------------+-----------------+-----------------------------+