שחזור אשכול AlloyDB Omni באמצעות pgBackRest

בוחרים גרסת תיעוד:

בדף הזה מוסבר איך לשחזר אשכול AlloyDB Omni באמצעות גיבוי שנוצר באמצעות pgBackRest, פתרון הגיבוי בקוד פתוח שכלול בקונטיינר AlloyDB Omni Docker.

‫AlloyDB Omni תואם ל-PostgreSQL, ולכן פקודות וטכניקות שחזור הנתונים שמתוארות במדריך pgBackRest רלוונטיות גם ל-AlloyDB Omni. בדף הזה מוצגות כמה משימות שחזור נפוצות, עם דוגמאות לפקודות רלוונטיות.

מידע נוסף על הגדרת pgBackRest לעבודה עם AlloyDB Omni זמין במאמר הגדרת pgBackRest ל-AlloyDB Omni.

לפני שמתחילים

לפני שמגדירים את AlloyDB Omni לעבודה עם pgBackrest, צריך לוודא שAlloyDB Omni מותקן ופועל בשרת שאתם שולטים בו.

  • שרת מסד נתונים יעד, שפועלת בו אותה גרסה ראשית של AlloyDB Omni כמו בשרת מסד הנתונים של המקור. מידע נוסף על התקנת AlloyDB Omni זמין במאמר התקנת AlloyDB Omni.

    שרת היעד יכול להיות אותה מכונה כמו שרת המקור.

  • מאגר גיבוי של pgBackRest שמכיל לפחות גיבוי אחד של מסד הנתונים של AlloyDB Omni.

  • מספיק מקום פנוי בדיסק בשרת היעד כדי להכיל את מסד הנתונים המשוחזר.

סקירה כללית

כדי לבצע שחזור של AlloyDB Omni באמצעות pgBackRest, מריצים את הפקודה pgbackrest restore. הארגומנטים שאתם מספקים לפקודה משתנים בהתאם למצב.

באופן כללי, מריצים את הפקודה pgbackrest restore עם דגלים שמספקים את הפרטים הבאים:

  • המיקום של קובץ pgbackrest.conf.
  • השם של מאגר הגיבוי של pgBackRest שממנו רוצים לשחזר. המאגרים האלה נקראים ומוגדרים בקובץ pgbackest.conf.
  • המיקום במערכת הקבצים המקומית שאליו ייכתבו הנתונים ששוחזרו.
  • מזהה של הגיבוי או של נקודת הזמן הספציפיים שמהם רוצים לשחזר.

כשמריצים את הפקודות של pgbackrest restore בקונטיינר, חשוב להשתמש בנתיבי מערכת הקבצים מנקודת המבט של הקונטיינר. לדוגמה, הנתיב לספריית הנתונים של AlloyDB Omni הוא תמיד /mnt/disks/pgsql, לא משנה איפה היא נמצאת בשרת המארח. מידע נוסף זמין במאמר בנושא הערה לגבי נתיבים במערכת הקבצים.

ביצוע שחזור מנקודה מסוימת בזמן

בדוגמה הזו, הנתונים משוחזרים ממאגר pgBackRest, ומוגדרת נקודת זמן מסוימת שממנה יתבצע השחזור. אם הגדרתם כמה מאגרים בקובץ pgbackrest.conf של סביבת היעד, מערכת pgBackRest בוחרת את המאגר שממנו יתבצע השחזור על סמך הזמינות, המהירות הצפויה וגורמים אחרים.

בדוגמה הזו מניחים את הדברים הבאים:

  • יש לכם קובץ pgbackrest.conf שנמצא ברמה העליונה של ספריית הנתונים של AlloyDB Omni. כך הקובץ יהיה זמין ל-pgbackrest שמופעל בתוך קונטיינר בתור /mnt/disks/pgsql/pgbackrest.conf.

  • הפעלתם גיבויים רציפים בהגדרת pgBackRest.

  1. בסביבת היעד, מבצעים שחזור PITR ומציינים חותמת זמן לשחזור ממנה:

    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

    מחליפים את מה שכתוב בשדות הבאים:

    • ‫STANZA: ה-stanza של התצורה, שמוגדר בקובץ pgbackrest.conf, שרוצים להחיל על השחזור הזה. לדוגמה: omni.

    • ‫TIMESTAMP: השעה שממנה רוצים לשחזר. לדוגמה, 2024-02-22 19:50:00.

  2. בסביבת היעד, עוצרים את שרת מסד הנתונים:

    sudo alloydb database-server stop
  3. כדי לנקוט אמצעי זהירות, משנים את השם של ספריית המשנה data בספריית הנתונים:

    cd DATA_DIR
    sudo mv data data-OLD

    מחליפים את הערך DATA_DIR בנתיב של מערכת הקבצים לספריית הנתונים של AlloyDB Omni.

  4. מעבירים את הנתונים המשוחזרים למקום שלהם ומנקים את postgresql.auto.conf:

    sudo mv data-RESTORED data
    sudo sed -i 's|data-RESTORED|data|' data/postgresql.auto.conf
  5. מפעילים את שרת מסד הנתונים:

    sudo alloydb database-server start

עכשיו אפשר להתחבר למסד הנתונים באמצעות psql ולוודא שהנתונים שוחזרו כמו שציפיתם. אם כן, אפשר למחוק את data-OLD העותק של ספריית המשנה data שיצרתם קודם.

מידע נוסף על PITR ב-pgBackRest מופיע במאמר בנושא שחזור לנקודת זמן. מידע נוסף על הכנת קובץ pgbackrest.conf לשימוש ב-AlloyDB Omni מופיע במאמר בנושא הגדרת pgBackRest ל-AlloyDB Omni.

אפשרויות אחרות

הפקודה pgbackrest restore היא גמישה מאוד, ויש לה מגוון אפשרויות ותכונות שאפשר לשלוט בהן באמצעות העברת אפשרויות שונות בשורת הפקודה. למשל:

  • להגביל את השחזור רק לקבצים שהשתנו.
  • שחזור רק של מסדי נתונים נבחרים.

הוראות מפורטות לביצוע שחזורים ב-pgBackRest מופיעות במאמר שחזור.