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
Di konsol Google Cloud, buka halaman BigQuery.
Di panel Explorer, luaskan node project dan set data dari set data yang snapshot tabelnya ingin Anda lihat dalam daftar.
Anda dapat mengidentifikasi snapshot tabel dalam set data berdasarkan ikonnya.
SQL
Buat kueri
tampilan INFORMATION_SCHEMA.TABLE_SNAPSHOTS
:
Di konsol Google Cloud, buka halaman BigQuery.
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.
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:
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
- Dapatkan informasi tentang snapshot tabel.
- Memperbarui deskripsi, tanggal habis masa berlaku, atau kebijakan akses untuk snapshot tabel.
- Menghapus snapshot tabel.