Menampilkan daftar snapshot tabel

Dokumen ini menjelaskan cara mendapatkan daftar snapshot tabel dalam set data BigQuery di konsol Google Cloud, dengan membuat kueri tabel INFORMATION_SCHEMA.TABLE_SNAPSHOTS, menggunakan bq ls, atau dengan memanggil tables.list API. Panduan ini juga menjelaskan cara menampilkan daftar semua snapshot tabel dari tabel dasar yang ditentukan dengan membuat kueri tabel INFORMATION_SCHEMA.TABLE_SNAPSHOTS. Dokumen ini ditujukan untuk pengguna yang sudah memahami tabel BigQuery dan snapshot tabel.

Izin dan peran

Bagian ini menjelaskan izin Identity and Access Management (IAM) yang Anda perlukan untuk menampilkan daftar snapshot tabel dalam set data, dan peran IAM yang telah ditetapkan sebelumnya yang memberikan izin tersebut. Izin dan peran untuk menampilkan daftar snapshot tabel sama dengan izin dan peran yang diperlukan untuk menampilkan daftar jenis tabel lainnya.

Izin

Untuk menampilkan daftar snapshot tabel dalam set data, Anda memerlukan izin berikut:

Izin Resource
bigquery.tables.list Set data yang berisi snapshot tabel.

Peran

Peran BigQuery yang telah ditetapkan dan memberikan izin yang diperlukan adalah sebagai berikut:

Role Resource
Salah satu dari yang berikut ini:

bigquery.dataUser
bigquery.dataViewer
bigquery.dataEditor
bigquery.dataOwner
bigquery.admin
Set data yang berisi snapshot tabel.

Menampilkan daftar snapshot tabel dalam set data

Cara menampilkan daftar snapshot tabel dalam set data mirip dengan menampilkan daftar jenis tabel lainnya. Snapshot tabel memiliki jenis SNAPSHOT.

Anda dapat manampilkan daftar snapshot tabel menggunakan salah satu opsi berikut:

Konsol

  1. Di konsol Google Cloud, buka halaman BigQuery.

    Buka BigQuery

  2. Di panel Explorer, luaskan node project dan set data dari set data yang snapshot tabelnya ingin Anda lihat dalam daftar.

  3. Anda dapat mengidentifikasi snapshot tabel dalam set data berdasarkan ikonnya.

    Ikon snapshot tabel

SQL

Buat kueri tampilan INFORMATION_SCHEMA.TABLE_SNAPSHOTS:

  1. Di konsol Google Cloud, buka halaman BigQuery.

    Buka BigQuery

  2. Di editor kueri, masukkan pernyataan berikut:

    SELECT
      *
    FROM
      PROJECT_ID.DATASET_NAME.INFORMATION_SCHEMA.TABLE_SNAPSHOTS;

    Ganti kode berikut:

    • PROJECT_ID: project ID untuk project yang berisi snapshot yang ingin Anda lihat dalam daftar.
    • DATASET_NAME: nama set data yang berisi snapshot yang ingin Anda lihat dalam daftar.

  3. Klik Run.

Untuk informasi selengkapnya tentang cara menjalankan kueri, lihat Menjalankan kueri interaktif.

Hasilnya akan terlihat mirip dengan berikut ini:

+---------------+----------------+------------------+--------------------+-------------------+-----------------+-----------------------------+
| table_catalog | table_schema   | table_name       | base_table_catalog | base_table_schema | base_table_name | snapshot_time               |
+---------------+----------------+------------------+--------------------+-------------------+-----------------+-----------------------------+
| myproject     | mydataset      | mysnapshot       | basetableproject   | basetabledataset           | basetable           | 2021-04-16 14:05:27.519 UTC |
+---------------+----------------+------------------+--------------------+-------------------+-----------------+-----------------------------+

bq

Masukkan perintah berikut di Cloud Shell:

Buka Cloud Shell

bq ls \
PROJECT_ID:DATASET_NAME

Ganti kode berikut:

  • PROJECT_ID: project ID untuk project yang berisi snapshot yang ingin Anda lihat dalam daftar.
  • DATASET_NAME: nama set data yang berisi snapshot yang ingin Anda lihat dalam daftar.

Outputnya terlihat mirip seperti berikut ini:

+-------------------------+--------+---------------------+-------------------+
|         tableId         |  Type  |       Labels        | Time Partitioning |
+-------------------------+--------+---------------------+-------------------+
| mysnapshot              |SNAPSHOT|                     |                   |
+-------------------------+--------+---------------------+-------------------+

API

Panggil metode tables.list dengan parameter berikut:

Parameter Nilai
projectId Project ID project yang berisi snapshot yang ingin Anda lihat dalam daftar.
datasetId Nama set data yang berisi snapshot yang ingin Anda lihat dalam daftar.

Menampilkan daftar snapshot tabel untuk tabel dasar tertentu

Anda dapat menampilkan daftar snapshot tabel dari tabel dasar tertentu dengan membuat kueri tampilan INFORMATION_SCHEMA.TABLE_SNAPSHOTS:

SELECT
  *
FROM
  PROJECT_ID.DATASET_NAME.INFORMATION_SCHEMA.TABLE_SNAPSHOTS
WHERE
  base_table_name = 'books';
  

Ganti kode berikut:

  • PROJECT_ID: project ID untuk project yang berisi snapshot yang ingin Anda lihat dalam daftar.
  • DATASET_NAME: nama set data yang berisi snapshot yang ingin Anda lihat dalam daftar.

Langkah selanjutnya