Memulihkan tabel yang dihapus
Dokumen ini menjelaskan cara memulihkan (atau membatalkan penghapusan) tabel yang dihapus di BigQuery. Anda dapat memulihkan tabel yang dihapus dalam periode perjalanan waktu yang ditentukan untuk set data, termasuk penghapusan eksplisit dan penghapusan implisit karena akhir masa berlaku tabel. Anda juga dapat mengonfigurasi periode perjalanan waktu.
Untuk mengetahui informasi tentang cara memulihkan seluruh set data atau snapshot yang dihapus, lihat referensi berikut:
Periode perjalanan waktu dapat memiliki durasi antara dua dan tujuh hari. Setelah periode perjalanan waktu berakhir, BigQuery menyediakan periode fail-safe di mana data yang dihapus akan otomatis disimpan selama tujuh hari lagi. Setelah periode fail-safe berlalu, Anda tidak dapat memulihkan tabel menggunakan metode apa pun, termasuk membuka tiket dukungan.
Sebelum memulai
Pastikan Anda memiliki izin Identity and Access Management (IAM) yang diperlukan untuk memulihkan tabel yang dihapus.
Peran yang diperlukan
Untuk mendapatkan izin yang diperlukan untuk memulihkan tabel yang dihapus, minta administrator Anda untuk memberi Anda peran IAM BigQuery User (roles/bigquery.user
) di project.
Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.
Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.
Memulihkan tabel
Saat Anda memulihkan tabel dari data historis, tag dari tabel sumber tidak disalin ke tabel tujuan.
Anda dapat memulihkan tabel yang telah dihapus, tetapi masih dalam jangka waktu perjalanan dengan menyalin tabel tersebut ke tabel baru, menggunakan dekorator waktu @<time>
.
Anda tidak dapat membuat kueri tabel yang dihapus, meskipun Anda menggunakan dekorator waktu. Anda harus memulihkannya terlebih dahulu.
Untuk memulihkan tabel, pilih salah satu opsi berikut:
Konsol
Anda tidak dapat membatalkan penghapusan tabel menggunakan Google Cloud konsol.
bq
-
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
Untuk memulihkan tabel, tentukan terlebih dahulu stempel waktu UNIX saat tabel ada (dalam milidetik). Anda dapat menggunakan perintah
date
Linux untuk membuat stempel waktu Unix dari nilai stempel waktu biasa:date -d '2023-08-04 16:00:34.456789Z' +%s000
Kemudian, gunakan perintah
bq copy
dengan dekorator perjalanan waktu@<time>
untuk melakukan operasi penyalinan tabel.Misalnya, masukkan perintah berikut untuk menyalin tabel
mydataset.mytable
pada saat1418864998000
ke tabel barumydataset.newtable
.bq cp mydataset.mytable@1418864998000 mydataset.newtable
(Opsional) Berikan flag
--location
dan tetapkan nilainya ke lokasi Anda.Anda juga dapat menentukan offset relatif. Contoh berikut menyalin versi tabel dari satu jam yang lalu:
bq cp mydataset.mytable@-3600000 mydataset.newtable
Untuk informasi selengkapnya, lihat Memulihkan tabel dari titik waktu.
Go
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Go di Panduan memulai BigQuery menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat Dokumentasi referensi BigQuery Go API.
Untuk melakukan autentikasi ke BigQuery, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.
Java
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Java di Panduan memulai BigQuery menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat Dokumentasi referensi BigQuery Java API.
Untuk melakukan autentikasi ke BigQuery, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.
Node.js
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Node.js di Panduan memulai BigQuery menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat Dokumentasi referensi BigQuery Node.js API.
Untuk melakukan autentikasi ke BigQuery, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.
Python
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Python di Panduan memulai BigQuery menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat Dokumentasi referensi BigQuery Python API.
Untuk melakukan autentikasi ke BigQuery, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.
Jika mengantisipasi bahwa Anda mungkin ingin memulihkan tabel lebih lama dari yang diizinkan oleh periode perjalanan waktu, buat snapshot tabel dari tabel tersebut. Untuk informasi selengkapnya, lihat Pengantar snapshot tabel.
Langkah berikutnya
- Pelajari cara membuat dan menggunakan tabel.
- Pelajari cara mengelola tabel.
- Pelajari cara mengubah skema tabel.
- Pelajari cara menggunakan data tabel.