Memperbarui metadata snapshot tabel
Dokumen ini menjelaskan cara memperbarui deskripsi, tanggal habis masa berlaku, atau
kebijakan akses untuk snapshot
tabel menggunakan konsol Google Cloud, perintah
bq update
, atau
tables.patch
API.
Panduan ini ditujukan bagi pengguna yang sudah memahami
tabel dan
snapshot tabel di BigQuery.
Izin dan peran
Bagian ini menjelaskan izin Identity and Access Management (IAM) yang Anda perlukan untuk memperbarui metadata untuk snapshot tabel, dan peran IAM bawaan yang memberikan izin tersebut.
Izin
Untuk memperbarui metadata snapshot tabel, Anda memerlukan izin berikut:
Izin | Resource |
---|---|
bigquery.tables.update
|
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.dataEditor bigquery.dataOwner biguqery.admin
|
Snapshot tabel |
Batasan
Anda dapat memperbarui metadata snapshot tabel, tetapi tidak dapat memperbarui datanya karena data snapshot tabel bersifat hanya baca. Untuk memperbarui data snapshot tabel, Anda harus memulihkan snapshot tabel ke tabel standar terlebih dahulu, lalu memperbarui data tabel standar. Untuk mengetahui informasi selengkapnya, lihat Memulihkan snapshot tabel.
Memperbarui metadata snapshot tabel
Anda dapat mengubah deskripsi, masa berlaku, dan kebijakan akses snapshot tabel dengan cara yang sama seperti mengubah metadata tabel standar. Beberapa contohnya disediakan di bagian berikut.
Memperbarui deskripsi
Anda dapat mengubah deskripsi untuk snapshot tabel menggunakan salah satu opsi berikut:
Konsol
Di konsol Google Cloud, buka halaman BigQuery.
Di panel Penjelajah, luaskan node project dan set data dari snapshot tabel yang ingin Anda perbarui.
Klik nama snapshot tabel.
Di panel snapshot yang muncul, klik tab Detail, lalu klik Edit Detail.
Di kolom Deskripsi, tambahkan atau perbarui deskripsi untuk snapshot tabel.
Klik Simpan.
bq
Masukkan perintah berikut di Cloud Shell:
bq update \ --description="DESCRIPTION" \ PROJECT_ID:DATASET_NAME.SNAPSHOT_NAME
Ganti kode berikut:
DESCRIPTION
: teks yang menjelaskan snapshot. Contoh,Snapshot after table schema change X.
.PROJECT_ID
: project ID dari project yang berisi snapshot.DATASET_NAME
: nama set data yang berisi snapshot.SNAPSHOT_NAME
: nama snapshot.
API
Panggil
metode tables.patch
dengan parameter berikut:
Parameter | Nilai |
---|---|
projectId |
ID project untuk project yang berisi snapshot. |
datasetId |
Nama set data yang berisi snapshot |
tableId |
Nama snapshot. |
Kolom description isi permintaan |
Teks yang menjelaskan snapshot. Misalnya, Snapshot after table schema change X . |
Pilih metode tables.patch
daripada metode tables.update
karena metode
tables.update
menggantikan seluruh resource Table
.
Memperbarui akhir masa berlaku
Anda dapat mengubah akhir masa berlaku snapshot tabel menggunakan salah satu opsi berikut:
Konsol
Di konsol Google Cloud, buka halaman BigQuery.
Di panel Penjelajah, luaskan node project dan set data dari snapshot tabel yang ingin Anda perbarui.
Klik nama snapshot tabel.
Di panel snapshot yang muncul, klik tab Detail, lalu klik Edit Detail.
Di kolom Waktu akhir masa berlaku, masukkan waktu akhir masa berlaku yang baru untuk snapshot tabel.
Klik Simpan.
bq
Masukkan perintah berikut di Cloud Shell:
bq update \ --expiration=EXPIRATION_TIME \ PROJECT_ID:DATASET_NAME.SNAPSHOT_NAME
Ganti kode berikut:
EXPIRATION_TIME
: jumlah detik dari waktu saat ini hingga waktu akhir masa berlaku.PROJECT_ID
: project ID dari project yang berisi snapshot.DATASET_NAME
: nama set data yang berisi snapshot.SNAPSHOT_NAME
: nama snapshot.
API
Panggil
metode tables.patch
dengan parameter berikut:
Parameter | Nilai |
---|---|
projectId |
ID project untuk project yang berisi snapshot. |
datasetId |
Nama set data yang berisi snapshot |
tableId |
Nama snapshot. |
Kolom expirationTime isi permintaan |
Waktu saat snapshot berakhir, dalam milidetik sejak epoch. |
Pilih metode tables.patch
daripada metode tables.update
karena metode
tables.update
menggantikan seluruh resource Table
.
Memperbarui akses
Anda dapat memberi pengguna akses untuk melihat data dalam snapshot tabel dengan menggunakan salah satu opsi berikut:
Konsol
Di konsol Google Cloud, buka halaman BigQuery.
Di panel Penjelajah, luaskan node project dan set data dari snapshot tabel yang ingin Anda perbarui.
Klik nama snapshot tabel.
Di panel snapshot yang muncul, klik Bagikan, lalu klik Tambahkan akun utama.
Di panel Tambahkan akun utama yang muncul, masukkan ID akun utama yang ingin Anda berikan akses ke snapshot tabel.
Di menu dropdown Pilih peran, pilih BigQuery, lalu BigQuery Data Viewer.
Klik Simpan.
bq
Masukkan perintah berikut di Cloud Shell:
bq add-iam-policy-binding \ --member="user:PRINCIPAL" \ --role="roles/bigquery.dataViewer" \ PROJECT_ID:DATASET_NAME.SNAPSHOT_NAME
Ganti kode berikut:
PRINCIPAL
: akun utama yang ingin Anda berikan akses ke snapshot tabel.PROJECT_ID
: project ID dari project yang berisi snapshot.DATASET_NAME
: nama set data yang berisi snapshot.SNAPSHOT_NAME
: nama snapshot.
API
Panggil
metode tables.setIamPolicy
dengan parameter berikut:
Parameter | Nilai |
---|---|
Resource |
projects/PROJECT_ID/datasets/DATASET_NAME/tables/SNAPSHOT_NAME |
Isi permintaan | { "policy": { "bindings": [ { "members": [ "user:PRINCIPAL" ], "role": "roles/bigquery.dataViewer" } ] } } |
Ganti kode berikut:
PROJECT_ID
: project ID dari project yang berisi snapshot.DATASET_NAME
: nama set data yang berisi snapshot.SNAPSHOT_NAME
: nama snapshot.PRINCIPAL
: akun utama yang ingin Anda berikan akses ke snapshot tabel.
Langkah selanjutnya
- Mencantumkan snapshot tabel dalam set data.
- Melihat metadata untuk snapshot tabel.
- Menghapus snapshot tabel.