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

בחירת גרסה של מאמר העזרה:

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

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

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

במאמר גיבוי ושחזור ב-Kubernetes מוסבר על מידע שמבוסס על Kubernetes.

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

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

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

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

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

סקירה כללית

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

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

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

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

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

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

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

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

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

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

    Docker

    docker exec CONTAINER_NAME pgbackrest \
      --config-path=/var/lib/postgresql/data \
      --stanza=STANZA \
      --type=time \
      --pg1-path=/var/lib/postgresql/data/data-RESTORED \
      --target="TIMESTAMP" \
      restore

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

    • ‫CONTAINER_NAME: השם שהקציתם למאגר AlloyDB Omni כשהתקנתם אותו, לדוגמה, my-omni.

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

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

    Podman

    podman exec CONTAINER_NAME pgbackrest \
      --config-path=/var/lib/postgresql/data \
      --stanza=STANZA \
      --type=time \
      --pg1-path=/var/lib/postgresql/data/data-RESTORED \
      --target="TIMESTAMP" \
      restore

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

    • ‫CONTAINER_NAME: השם שהקציתם למאגר AlloyDB Omni כשהתקנתם אותו, לדוגמה, my-omni.

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

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

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

    Docker

    docker container stop CONTAINER_NAME

    Podman

    podman container stop CONTAINER_NAME
  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. מפעילים את מאגר AlloyDB Omni עם שרת מסד הנתונים:

    Docker

    docker container start CONTAINER_NAME

    Podman

    podman container start CONTAINER_NAME

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

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

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

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

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

מדריך מלא לביצוע שחזורים ב-pgBackRest זמין במאמר שחזור.