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 perintah 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 bagi 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
Apa saja dari daftar berikut:

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 kiri, klik Explorer:

    Tombol yang ditandai untuk panel Explorer.

    Jika Anda tidak melihat panel kiri, klik Luaskan panel kiri untuk membuka panel.

  3. Di panel Explorer, luaskan project, klik Set data, lalu pilih set data yang berisi snapshot tabel yang ingin Anda lihat dalam daftar.

  4. Klik Ringkasan > Tabel. Untuk menemukan snapshot dari daftar, periksa nilai SNAPSHOT di kolom Jenis.

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 mengetahui informasi selengkapnya tentang cara menjalankan kueri, lihat artikel 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 berikutnya