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 oleh panduan 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.

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

  • Kapasitas disk 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 di sistem file lokal untuk menulis data yang dipulihkan.
  • ID cadangan atau titik waktu tertentu yang ingin Anda pulihkan.

Saat menjalankan perintah pgbackrest restore dalam container, ingatlah untuk menggunakan jalur sistem file dari sudut pandang container. Misalnya, jalur ke direktori data AlloyDB Omni Anda selalu /mnt/disks/pgsql, terlepas dari 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 memberi nama titik waktu tertentu untuk dipulihkan. Jika Anda telah menentukan beberapa repositori dalam file pgbackrest.conf lingkungan target, pgBackRest akan memilih repositori yang akan dipulihkan berdasarkan ketersediaan, kecepatan yang diharapkan, dan faktor lainnya.

Contoh ini mengasumsikan hal berikut:

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

  • Anda telah mengaktifkan pencadangan berkelanjutan dengan konfigurasi pgBackRest.

  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 ke pemulihan ini—misalnya, omni.

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

  2. Di lingkungan target, hentikan server database:

    sudo alloydb database-server stop

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

    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, dan 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 demikian, Anda dapat menghapus salinan data-OLD dari subdirektori data yang Anda buat sebelumnya.

Untuk mengetahui informasi selengkapnya tentang PITR di pgBackRest, lihat Pemulihan Point-in-Time. Untuk mengetahui informasi selengkapnya tentang cara 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 opsi command line yang berbeda. Contoh ini meliputi:

  • Membatasi pemulihan hanya ke file yang diubah.
  • Hanya memulihkan database yang dipilih.

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