Mencadangkan dan memulihkan data

Halaman ini berisi penjelasan mengenai cara menggunakan fitur pencadangan terjadwal Cloud Firestore. Gunakan pencadangan untuk melindungi data Anda dari kerusakan data tingkat aplikasi atau dari penghapusan data yang tidak disengaja.

Dengan pencadangan, Anda dapat mengonfigurasi jadwal pencadangan untuk mengambil cadangan harian atau mingguan dari database yang ditentukan. Anda kemudian dapat menggunakan cadangan ini untuk memulihkan data ke database baru.

Tentang pencadangan

Cadangan adalah salinan database yang konsisten pada suatu waktu. Cadangan berisi semua konfigurasi data dan indeks pada saat itu. Cadangan tidak berisi kebijakan waktu aktif database. Cadangan berada di lokasi yang sama dengan database sumber.

Cadangan memiliki periode retensi yang dapat dikonfigurasi dan disimpan hingga periode retensi data berakhir atau sampai Anda menghapus cadangan. Menghapus database sumber tidak akan otomatis menghapus cadangan terkait.

Cloud Firestore menyimpan metadata yang terkait dengan pencadangan dan jadwal pencadangan terkait database. Cloud Firestore menyimpan metadata ini hingga semua cadangan untuk database habis masa berlakunya atau dihapus.

Pembuatan atau penyimpanan cadangan tidak memengaruhi performa operasi baca atau tulis dalam database live Anda.

Biaya

Jika menggunakan cadangan, Anda dikenai biaya untuk hal-hal berikut:

  • Jumlah penyimpanan yang digunakan oleh setiap cadangan.
  • Untuk operasi pemulihan, Anda akan ditagih berdasarkan ukuran cadangan.

Untuk mengetahui detail dan tarif persisnya, lihat halaman Harga.

Sebelum memulai

Fitur ini memerlukan paket harga Blaze.

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan guna mengelola pencadangan dan jadwal pencadangan, minta administrator Anda memberikan satu atau beberapa peran Identity and Access Management berikut:

  • roles/datastore.owner: Akses penuh ke database Cloud Firestore

  • Peran berikut ini juga tersedia, tetapi tidak terlihat di Google Cloud Platform Console. Gunakan Google Cloud CLI untuk menetapkan peran ini:

    • roles/datastore.backupsAdmin: Akses baca dan tulis ke cadangan
    • roles/datastore.backupsViewer: Akses baca ke cadangan
    • roles/datastore.backupSchedulesAdmin: Akses baca dan tulis ke jadwal pencadangan
    • roles/datastore.backupSchedulesViewer: Akses baca ke jadwal pencadangan
    • roles/datastore.restoreAdmin: Izin untuk memulai operasi pemulihan

Membuat dan mengelola jadwal pencadangan

Contoh di bawah menunjukkan cara menyiapkan jadwal pencadangan. Untuk setiap database, Anda dapat mengonfigurasi hingga satu jadwal pencadangan harian dan satu jadwal pencadangan mingguan. Anda tidak dapat mengonfigurasi beberapa jadwal pencadangan mingguan untuk hari yang berbeda dalam seminggu.

Anda tidak dapat mengonfigurasi waktu persis untuk pencadangan. Pencadangan dilakukan pada waktu yang berbeda setiap hari. Untuk jadwal pencadangan mingguan, Anda dapat mengonfigurasi hari dalam seminggu untuk mengambil cadangan.

Membuat jadwal pencadangan

Untuk membuat jadwal pencadangan database, gunakan perintah gcloud alpha firestore backups schedules create.

Membuat jadwal pencadangan harian

Untuk membuat jadwal pencadangan harian, tetapkan flag --recurrence ke daily:

gcloud alpha firestore backups schedules create \
--database='DATABASE_ID' \
--recurrence=daily \
--retention=RETENTION_PERIOD

Ganti kode berikut:

  • DATABASE_ID: ID database yang akan dicadangkan. Tetapkan ke (default) untuk database default.
  • RETENTION_PERIOD: Untuk pengulangan pencadangan daily, tetapkan nilai ini ke nilai hingga 7 hari (7d). Jika Anda menetapkan pengulangan pencadangan weekly, tetapkan ini ke nilai hingga 14 minggu (14w).

Membuat jadwal pencadangan mingguan

Untuk membuat jadwal pencadangan mingguan, tetapkan flag --recurrence ke weekly:

gcloud alpha firestore backups schedules create \
--database='DATABASE_ID' \
--recurrence=weekly \
--retention=RETENTION_PERIOD \
--day-of-week=DAY

Ganti kode berikut:

  • DATABASE_ID: ID database yang akan dicadangkan. Tetapkan ke (default) untuk database default.
  • RETENTION_PERIOD: Untuk pengulangan pencadangan weekly, tetapkan ini ke nilai hingga 14 minggu (14w).
  • DAY: Tanggal untuk melakukan pencadangan. Tetapkan ke salah satu opsi berikut:
    • SUN untuk hari Minggu
    • MON untuk hari Senin
    • TUE untuk hari Selasa
    • WED untuk hari Rabu
    • THU untuk hari Kamis
    • FRI untuk hari Jumat
    • SAT untuk hari Sabtu

Mencantumkan jadwal pencadangan

Untuk mencantumkan semua jadwal pencadangan untuk database, gunakan perintah gcloud alpha firestore backups schedules list. Perintah ini akan menampilkan informasi tentang semua jadwal pencadangan. 

gcloud alpha firestore backups schedules list \
--database='DATABASE_ID'

Ganti DATABASE_ID dengan ID database. Gunakan (default) untuk database default.

Mendeskripsikan jadwal pencadangan

Untuk mengambil informasi tentang jadwal pencadangan, gunakan perintah gcloud alpha firestore backups schedules describe:

gcloud alpha firestore backups schedules describe \
--database='DATABASE_ID' \
--backup-schedule=BACKUP_SCHEDULE_ID

Ganti kode berikut:

  • DATABASE_ID: ID database yang akan dicadangkan. Tetapkan ke (default) untuk database default.
  • BACKUP_SCHEDULE_ID: ID jadwal pencadangan. Anda dapat melihat ID setiap jadwal pencadangan saat mencantumkan semua jadwal pencadangan.

Memperbarui jadwal pencadangan

Untuk memperbarui periode retensi jadwal pencadangan, gunakan perintah gcloud alpha firestore backups schedules update:

gcloud alpha firestore backups schedules update \
--database='DATABASE_ID' \
--backup-schedule=BACKUP_SCHEDULE_ID
--retention=RETENTION_PERIOD

Ganti kode berikut:

  • DATABASE_ID: ID database yang akan dicadangkan. Tetapkan ke (default) untuk database default.
  • BACKUP_SCHEDULE_ID: ID jadwal pencadangan. Anda dapat melihat ID setiap jadwal pencadangan saat mencantumkan semua jadwal pencadangan.
  • RETENTION_PERIOD: Jika Anda menetapkan pengulangan pencadangan daily, tetapkan ini ke nilai hingga 7 hari (7d). Jika Anda menetapkan pengulangan pencadangan weekly, tetapkan ini ke nilai hingga 14 minggu (14w).

Menghapus jadwal pencadangan

Untuk menghapus jadwal pencadangan, gunakan perintah gcloud alpha firestore backups schedules delete:

gcloud alpha firestore backups schedules delete \
--database='DATABASE_ID' \
--backup-schedule=BACKUP_SCHEDULE_ID

Ganti kode berikut:

  • DATABASE_ID: ID database yang akan dicadangkan. Tetapkan ke (default) untuk database default.
  • BACKUP_SCHEDULE_ID: ID jadwal pencadangan. Anda dapat melihat ID setiap jadwal pencadangan saat mencantumkan semua jadwal pencadangan.

Perhatikan bahwa menghapus jadwal pencadangan tidak akan menghapus cadangan yang sudah dibuat dengan jadwal ini. Anda dapat menunggu hingga masa berlakunya habis setelah periode retensi data, atau menghapus cadangan secara manual, lihat menghapus cadangan.

Mengelola pencadangan

Mencantumkan pencadangan

Untuk mencantumkan cadangan yang tersedia, gunakan perintah gcloud alpha firestore backups list:

gcloud alpha firestore backups list \
--format="table(name, database, state)"

Flag --format="table(name, database, state)" memformat output ke dalam format yang lebih mudah dibaca.

Untuk mencantumkan hanya cadangan dari lokasi tertentu, gunakan tanda --location:

gcloud alpha firestore backups list \
--location=LOCATION \
--format="table(name, database, state)"

Ganti LOCATION dengan nama lokasi Cloud Firestore.

Mendeskripsikan pencadangan

Untuk melihat detail pencadangan, gunakan perintah gcloud alpha firestore backups describe:

gcloud alpha firestore backups describe \
--location=LOCATION \
--backup=BACKUP_ID

Menghapus pencadangan

Untuk menghapus database, gunakan perintah gcloud alpha firestore backups delete.

gcloud alpha firestore backups delete \
--location=LOCATION \
--backup=BACKUP_ID

Memulihkan data dari cadangan database

Operasi pemulihan akan menulis data dari cadangan ke database Cloud Firestore yang baru. Untuk memulai operasi pemulihan, gunakan perintah gcloud alpha firestore databases restore:

gcloud alpha firestore databases restore \
--source-backup=projects/PROJECT_ID/locations/LOCATION/backups/BACKUP_ID \
--destination-database='DATABASE_ID'
  • PROJECT_ID: Project ID Anda.
  • LOCATION: Lokasi pencadangan database dan lokasi database baru yang dibuat untuk data yang dipulihkan.
  • BACKUP_ID: ID cadangan. Anda dapat melihat ID setiap cadangan saat mencantumkan semua cadangan.
  • DATABASE_ID: ID database untuk database yang baru. Anda tidak dapat menggunakan ID database yang sudah digunakan.