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.

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