Membuat clone tabel

Dokumen ini menjelaskan cara menyalin tabel ke clone tabel menggunakan pernyataan SQL CREATE TABLE CLONE, perintah bq cp, atau panggilan API jobs.insert. Dokumen ini ditujukan bagi pengguna yang sudah memahami clone tabel.

Izin dan peran

Bagian ini menjelaskan izin Identity and Access Management (IAM) bahwa Anda perlu membuat clone tabel, danperan IAM yang telah ditetapkan yang memberikan izin akses tersebut.

Izin

Untuk membuat clone tabel, Anda memerlukan izin berikut:

Izin Resource
Semua yang berikut ini:

bigquery.tables.get
bigquery.tables.getData
 Tabel yang ingin Anda buat clone-nya.
bigquery.tables.create
bigquery.tables.updateData 		Set data yang berisi clone tabel.

Peran

Peran BigQuery yang telah ditetapkan dan menyediakan izin yang diperlukan adalah sebagai berikut:

Role Resource
Mana pun dari yang berikut ini:

bigquery.dataViewer
bigquery.dataEditor
bigquery.dataOwner
bigquery.admin 		Tabel yang ingin Anda buat clone-nya.
Mana pun dari yang berikut ini:

bigquery.dataEditor
bigquery.dataOwner
bigquery.admin 		Set data yang berisi clone tabel baru.

Membuat clone tabel

Gunakan GoogleSQL, alat command line bq, atau BigQuery API untuk membuat clone tabel.

SQL

Untuk meng-clone tabel, gunakan pernyataan CREATE TABLE CLONE.

  1. Di konsol Google Cloud, buka halaman BigQuery.

    Buka BigQuery

  2. Di editor kueri, masukkan pernyataan berikut:

    CREATE TABLE
myproject.myDataset_backup.myTableClone
CLONE myproject.myDataset.myTable;

  3. Klik Run.

Untuk informasi selengkapnya tentang cara menjalankan kueri, lihat Menjalankan kueri interaktif.

Ganti kode berikut:

  • PROJECT adalah project ID project target. Project ini harus berada dalam organisasi yang sama dengan project yang berisi tabel yang Anda clone.
  • DATASET adalah nama set data target. Set data ini harus berada di region yang sama dengan set data yang berisi tabel yang Anda clone.
  • CLONE_NAME adalah nama clone tabel yang Anda buat.

bq

Gunakan perintah bq cp dengan flag --clone:

Buka Cloud Shell 

bq cp --clone -n project1:myDataset.myTable PROJECT:DATASET.CLONE_NAME

Ganti yang berikut ini:

  • PROJECT adalah project ID project target. Project ini harus berada di organisasi yang sama dengan project yang berisi tabel yang Anda clone.
  • DATASET adalah nama set data target. Set data ini harus berada di region yang sama dengan set data yang berisi tabel yang Anda clone. Jika set data tidak berada di region yang sama dengan set data yang berisi tabel yang Anda clone, tabel lengkap akan disalin.
  • CLONE_NAME adalah nama clone tabel yang Anda buat.

Jika membuat clone dalam project yang sama dengan tabel dasar, Anda dapat melewati langkah menentukan project, seperti ditunjukkan berikut ini:

bq cp --clone -n myDataset.myTable DATASET.CLONE_NAME

API

Panggil metode jobs.insert dengan kolom operationType yang ditetapkan ke CLONE:

Parameter Nilai
projectId Project ID dari project yang menjalankan tugas.
Isi permintaan 
{
  "configuration": {
    "copy": {
      "sourceTables": [
        {
          "projectId": "myProject",
          "datasetId": "myDataset",
          "tableId": "myTable"
        }
      ],
      "destinationTable": {
        "projectId": "PROJECT",
        "datasetId": "DATASET",
        "tableId": "CLONE_NAME"
      },
      "operationType": "CLONE",
      "writeDisposition": "WRITE_EMPTY",
    }
  }
}

Ganti yang berikut ini:

  • PROJECT adalah project ID project target. Project ini harus berada dalam organisasi yang sama dengan project yang berisi tabel yang Anda clone.
  • DATASET adalah nama set data target. Set data ini harus berada di region yang sama dengan set data yang berisi tabel yang Anda clone. Jika set data tidak berada di region yang sama dengan set data yang berisi tabel yang Anda clone, tabel lengkap akan disalin.
  • CLONE_NAME adalah nama clone tabel yang Anda buat.

Kontrol akses

Saat Anda membuat clone tabel, akses ke clone tabel ditetapkan sebagai berikut:

  • Kebijakan akses tingkat baris disalin dari tabel dasar ke clone tabel.
  • Kebijakan akses tingkat kolom disalin dari tabel dasar ke clone tabel.

  • Akses tingkat tabel ditentukan sebagai berikut:

    • Jika clone tabel menimpa tabel yang ada, akses tingkat tabel untuk tabel yang ada akan dipertahankan. Tag tidak disalin dari tabel dasar.
    • Jika clone tabel adalah resource baru, akses tingkat tabel untuk clone tabel tersebut ditentukan oleh kebijakan akses dari set data tempat clone tabel dibuat. Selain itu, tag disalin dari tabel dasar ke clone tabel.

Langkah selanjutnya

  • Setelah membuat clone tabel, Anda dapat menggunakannya seperti menggunakan tabel standar. Untuk informasi lebih lanjut, lihat Mengelola tabel.