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
Mana pun 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

  1. Di konsol Google Cloud, buka halaman BigQuery.

    Buka BigQuery

  2. Di panel Penjelajah, luaskan node project dan set data dari snapshot tabel yang ingin Anda perbarui.

  3. Klik nama snapshot tabel

  4. Di panel snapshot yang muncul, klik tab Detail, lalu klik Edit Detail.

  5. Di kolom Deskripsi, tambahkan atau perbarui deskripsi untuk snapshot tabel.

  6. Klik Simpan.

bq

Masukkan perintah berikut di Cloud Shell:

Buka 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

  1. Di konsol Google Cloud, buka halaman BigQuery.

    Buka BigQuery

  2. Di panel Penjelajah, luaskan node project dan set data dari snapshot tabel yang ingin Anda perbarui.

  3. Klik nama snapshot tabel

  4. Di panel snapshot yang muncul, klik tab Detail, lalu klik Edit Detail.

  5. Di kolom Waktu akhir masa berlaku, masukkan waktu akhir masa berlaku yang baru untuk snapshot tabel.

  6. Klik Simpan.

bq

Masukkan perintah berikut di Cloud Shell:

Buka 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

  1. Di konsol Google Cloud, buka halaman BigQuery.

    Buka BigQuery

  2. Di panel Penjelajah, luaskan node project dan set data dari snapshot tabel yang ingin Anda perbarui.

  3. Klik nama snapshot tabel

  4. Di panel snapshot yang muncul, klik Bagikan, lalu klik Tambahkan akun utama.

  5. Di panel Tambahkan akun utama yang muncul, masukkan ID akun utama yang ingin Anda berikan akses ke snapshot tabel.

  6. Di menu dropdown Pilih peran, pilih BigQuery, lalu BigQuery Data Viewer.

  7. Klik Simpan.

bq

Masukkan perintah berikut di Cloud Shell:

Buka 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 berikutnya