Memulihkan cluster AlloyDB Omni menggunakan pgBackRest

Pilih versi dokumentasi:

Halaman ini menunjukkan cara memulihkan cluster AlloyDB Omni menggunakan cadangan yang dibuat dengan pgBackRest, solusi pencadangan open source yang disertakan dengan container Docker AlloyDB Omni.

Karena AlloyDB Omni kompatibel dengan PostgreSQL, perintah dan teknik pemulihan data yang dijelaskan dalam manual pgBackRest juga berlaku untuk AlloyDB Omni. Halaman ini menunjukkan pilihan tugas pemulihan umum, dengan contoh perintah yang relevan.

Untuk mengetahui informasi selengkapnya tentang cara mengonfigurasi pgBackRest agar berfungsi dengan AlloyDB Omni, lihat Menyiapkan pgBackRest untuk AlloyDB Omni.

Sebelum memulai

Sebelum mengonfigurasi AlloyDB Omni agar berfungsi dengan pgBackrest, Anda harus menginstal dan menjalankan AlloyDB Omni di server yang Anda kontrol.

  • Server database target, yang menjalankan versi utama AlloyDB Omni yang sama dengan server database sumber. Untuk mengetahui informasi selengkapnya tentang cara menginstal AlloyDB Omni, lihat Menginstal AlloyDB Omni.

    Server target dapat berupa mesin yang sama dengan server sumber.

  • Repository cadangan pgBackRest yang berisi setidaknya satu cadangan database AlloyDB Omni sumber.

  • Ruang disk kosong yang cukup di server target untuk menyimpan database yang dipulihkan.

Ringkasan

Untuk melakukan pemulihan AlloyDB Omni menggunakan pgBackRest, jalankan perintah pgbackrest restore. Argumen yang Anda berikan ke perintah bervariasi bergantung pada situasi Anda.

Secara umum, Anda menjalankan perintah pgbackrest restore dengan flag yang memberikan informasi berikut:

  • Lokasi file pgbackrest.conf Anda.
  • Nama repositori cadangan pgBackRest yang ingin Anda pulihkan. Repositori ini diberi nama dan ditentukan dalam file pgbackest.conf.
  • Lokasi pada sistem file lokal untuk menulis data yang dipulihkan.
  • ID cadangan atau titik waktu tertentu yang ingin Anda pulihkan.

Saat menjalankan perintah pgbackrest restore yang di-container, ingatlah untuk menggunakan jalur sistem file dari sudut pandang container. Misalnya, jalur ke direktori data AlloyDB Omni Anda selalu /mnt/disks/pgsql, di mana pun lokasinya di server host Anda. Untuk mengetahui informasi selengkapnya, lihat Catatan tentang jalur sistem file.

Melakukan pemulihan point-in-time

Contoh ini memulihkan data dari repositori pgBackRest, dengan menentukan titik waktu tertentu untuk dipulihkan. Jika Anda telah menentukan beberapa repositori di file pgbackrest.conf lingkungan target, pgBackRest akan memilih repositori yang akan dipulihkan berdasarkan ketersediaan, perkiraan kecepatan, dan faktor lainnya.

Contoh ini mengasumsikan hal berikut:

  • Anda memiliki file pgbackrest.conf yang terletak di level teratas direktori data AlloyDB Omni target Anda. Hal ini membuat file tersedia untuk pgbackrest yang di-container sebagai /mnt/disks/pgsql/pgbackrest.conf.

  • Anda telah mengaktifkan pencadangan berkelanjutan dengan konfigurasi pgBackRest Anda.

  1. Di lingkungan target, lakukan pemulihan PITR, dengan menentukan stempel waktu untuk dipulihkan:

    sudo docker exec pg-service pgbackrest \
  --config-path=/mnt/disks/pgsql \
  --stanza=STANZA \
  --type=time \
  --pg1-path=/mnt/disks/pgsql/data-RESTORED \
  --target="TIMESTAMP" \
  restore

    Ganti kode berikut:

    • STANZA: stanza konfigurasi, yang ditentukan oleh file pgbackrest.conf, untuk diterapkan pada pemulihan ini—misalnya, omni.

    • TIMESTAMP: waktu untuk memulihkan dari—misalnya, 2024-02-22 19:50:00.

  2. Di lingkungan target, hentikan server database:

    sudo alloydb database-server stop

  3. Ganti nama subdirektori data dari direktori data Anda, sebagai tindakan pencegahan:

    cd DATA_DIR
sudo mv data data-OLD

    Ganti DATA_DIR dengan jalur sistem file ke direktori data AlloyDB Omni Anda.

  4. Pindahkan data yang dipulihkan ke tempatnya, lalu bersihkan postgresql.auto.conf:

    sudo mv data-RESTORED data
sudo sed -i 's|data-RESTORED|data|' data/postgresql.auto.conf

  5. Mulai server database:

    sudo alloydb database-server start

Sekarang Anda dapat terhubung ke database menggunakan psql dan mengonfirmasi bahwa data telah dipulihkan seperti yang Anda harapkan. Jika ya, Anda dapat menghapus salinan data-OLD dari subdirektori data yang Anda buat sebelumnya.

Untuk mengetahui informasi selengkapnya tentang PITR di pgBackRest, lihat Point-in-Time Recovery. Untuk mengetahui informasi selengkapnya tentang menyiapkan file pgbackrest.conf untuk digunakan dengan AlloyDB Omni, lihat Menyiapkan pgBackRest untuk AlloyDB Omni.

Opsi lain

Perintah pgbackrest restore sangat fleksibel, dengan berbagai opsi dan fitur yang dapat Anda kontrol dengan meneruskan berbagai opsi command line. Contoh ini meliputi:

  • Membatasi pemulihan hanya ke file yang diubah.
  • Memulihkan hanya database yang dipilih.

Untuk panduan lengkap tentang cara melakukan pemulihan di pgBackRest, lihat Pemulihan.