Tampilan TABLE_SNAPSHOTS

Tampilan INFORMATION_SCHEMA.TABLE_SNAPSHOTS berisi metadata tentang snapshot tabel Anda. Untuk informasi selengkapnya, lihat Pengantar snapshot tabel.

Izin yang diperlukan

Untuk membuat kueri tabel virtual INFORMATION_SCHEMA.TABLE_SNAPSHOTS, Anda memerlukan izin Identity and Access Management (IAM) bigquery.tables.list untuk set data. Peran bawaan roles/bigquery.metadataViewer menyertakan izin yang diperlukan.

Untuk mengetahui informasi selengkapnya tentang izin BigQuery, lihat Kontrol akses dengan IAM.

Skema

Saat Anda membuat kueri tabel INFORMATION_SCHEMA.TABLE_SNAPSHOTS, hasilnya akan berisi satu baris untuk setiap snapshot tabel dalam set data atau region yang ditentukan.

Tabel INFORMATION_SCHEMA.TABLE_SNAPSHOTS memiliki skema berikut. Tabel standar tempat snapshot tabel diambil disebut tabel dasar.

Nama kolom	Jenis data	Nilai
`table_catalog`	`STRING`	Nama project yang berisi snapshot tabel
`table_schema`	`STRING`	Nama set data yang berisi snapshot tabel
`table_name`	`STRING`	Nama snapshot tabel
`base_table_catalog`	`STRING`	Nama project yang berisi tabel dasar
`base_table_schema`	`STRING`	Nama set data yang berisi tabel dasar
`base_table_name`	`STRING`	Nama tabel dasar
`snapshot_time`	`TIMESTAMP`	Waktu snapshot tabel dibuat

Cakupan dan sintaksis

Kueri terhadap tabel virtual ini harus menyertakan set data atau penentu region. Untuk kueri dengan penentu set data, Anda harus memiliki izin untuk set data. Untuk kueri dengan penentu region, Anda harus memiliki izin untuk project. Untuk informasi selengkapnya, lihat Sintaksis. Tabel berikut menjelaskan cakupan region dan resource untuk tabel virtual ini:

Nama tabel virtual	Cakupan resource	Cakupan region
[`PROJECT_ID`.]`region-REGION`.INFORMATION_SCHEMA.TABLE_SNAPSHOTS	Level project	`REGION`
[`PROJECT_ID`.]DATASET_ID.INFORMATION_SCHEMA.TABLE_SNAPSHOTS	Level set data	Lokasi set data

Ganti kode berikut:

Opsional: PROJECT_ID: ID project Google Cloud Anda. Jika tidak ditentukan, project default akan digunakan.
REGION: nama region set data apa pun. Misalnya, region-us.
DATASET_ID: ID set data Anda. Untuk mengetahui informasi selengkapnya, lihat Penentu set data.

Catatan: Anda harus menentukan lokasi untuk membuat kueri tabel virtual INFORMATION_SCHEMA dan lokasi eksekusi kueri harus cocok dengan region tabel virtual INFORMATION_SCHEMA.

Contoh

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

Contoh

Kueri berikut mengambil metadata untuk snapshot tabel dalam set data mydataset. Dalam contoh ini, snapshot menampilkan snapshot tabel myproject.mydataset.mytablesnapshot, yang diambil dari tabel dasar myproject.mydataset.mytable pada 14 Mei 2021, pukul 24.00 UTC.

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

Hasilnya akan mirip dengan berikut ini:

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