Melihat metadata snapshot tabel
Dokumen ini menjelaskan cara melihat metadata untuk snapshot tabel BigQuery di konsol Google Cloud, dengan membuat kueri tampilan TABLE_SNAPSHOTS
dari tabel INFORMATION_SCHEMA
, dengan menggunakan perintah bq show
, atau dengan memanggil tables.get
API.
Opsi 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 melihat metadata untuk snapshot tabel, dan peran IAM yang telah ditetapkan sebelumnya yang memberikan izin tersebut.
Izin
Untuk melihat metadata snapshot tabel, Anda memerlukan izin berikut:
Izin | Resource |
---|---|
bigquery.tables.get
|
Snapshot tabel |
Peran
Peran BigQuery yang telah ditetapkan dan memberikan izin yang diperlukan adalah sebagai berikut:
Role | Resource |
---|---|
Salah satu dari berikut ini:bigquery.metadataViewer bigquery.dataViewer bigquery.dataEditor bigquery.dataOwner bigquery.admin
|
Snapshot tabel |
Mendapatkan metadata snapshot tabel
Metadata untuk snapshot tabel mirip dengan metadata untuk tabel standar, dengan perbedaan berikut:
- Kolom
baseTableReference
tambahan mengidentifikasi tabel dasar tempat snapshot diambil. - Kolom
type
memiliki nilaiSNAPSHOT
.
Anda dapat melihat metadata untuk 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 snapshot tabel yang ingin Anda lihat.
Klik nama snapshot tabel
Pada panel snapshot yang muncul, Anda dapat melakukan hal berikut:
Klik tab Schema untuk melihat skema dan tag kebijakan snapshot tabel.
Klik tabel Details untuk melihat ukuran snapshot tabel, masa berlaku, tabel dasar, waktu snapshot, dan informasi lainnya.
SQL
Guna melihat metadata untuk snapshot tabel, 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 WHERE table_name = 'SNAPSHOT_NAME';
Ganti kode berikut:
PROJECT_ID
: project ID dari project yang berisi snapshot.DATASET_NAME
: nama set data yang berisi snapshot.SNAPSHOT_NAME
: nama snapshot.
Klik
Run.
Untuk informasi selengkapnya tentang cara menjalankan kueri, lihat Menjalankan kueri interaktif.
bq
Masukkan perintah berikut di Cloud Shell:
bq show \ --format=prettyjson \ PROJECT_ID:DATASET_NAME.SNAPSHOT_NAME
Ganti kode berikut:
PROJECT_ID
: project ID dari project yang berisi snapshot.DATASET_NAME
: nama set data yang berisi snapshot.SNAPSHOT_NAME
: nama snapshot.
Outputnya mirip dengan hal berikut ini:
{ "creationTime": "1593194331936", ... "snapshotDefinition": { "baseTableReference": { "datasetId": "myDataset", "projectId": "myProject", "tableId": "mytable" }, "snapshotTime": "2020-06-26T17:58:50.815Z" }, "tableReference": { "datasetId": "otherDataset", "projectId": "myProject", "tableId": "mySnapshot" }, "type": "SNAPSHOT" }
API
Panggil
metode tables.get
dengan parameter berikut:
Parameter | Nilai |
---|---|
projectId |
ID project untuk project yang berisi snapshot. |
datasetId |
Nama set data yang berisi snapshot |
tableId |
Nama snapshot. |
Isi respons mirip dengan berikut ini:
{ "kind": "bigquery#table", "etag": "...", "id": "myProject:myDataset.mySnapshot", "selfLink": "https://content-bigquery.googleapis.com/bigquery/v2/projects/myProject/datasets/myDataset/tables/mySnapshot", "tableReference": { "projectId": "myProject", "datasetId": "myDataset", "tableId": "mySnapshot" }, "description": "...", "schema": { "fields": [ ... ] }, "numBytes": "637931", "numLongTermBytes": "0", "numRows": "33266", "creationTime": "1593194331936", "lastModifiedTime": "1593194331936", "type": "SNAPSHOT", "location": "US", "snapshotDefinition": { "baseTableReference": { "projectId": "myProject", "datasetId": "otherDataset", "tableId": "myTable" }, "snapshotTime": "2020-06-26T17:58:50.815Z" } }
Langkah selanjutnya
- Memperbarui deskripsi, tanggal habis masa berlaku, atau kebijakan akses untuk snapshot tabel.
- Menghapus snapshot tabel.