ייצוא קובץ DMP

בדף הזה מוסבר איך להשתמש בכלי pg_dump כדי לייצא מסד נתונים של AlloyDB לקובץ DMP בארכיון בפורמט מותאם אישית, שאפשר לייבא אותו מאוחר יותר באמצעות הכלי pg_restore.

התהליך לייצוא הנתונים כולל את המשימות הבאות:

1. יוצרים קטגוריה של Cloud Storage לאחסון קובץ ה-DMP.

2. מכינים לקוח מארח כדי לבצע את פעולת הייצוא.

3. מייצאים את מסד הנתונים לקובץ DMP.

4. מחיקת משאבי הבדיקה שנוצרו כדי לבצע את התהליך.

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

• אתם צריכים להיות בעלי התפקיד הבסיסי 'בעלים' (roles/owner) או 'עריכה' (roles/editor) ב-IAM ב Google Cloud פרויקט שבו אתם משתמשים, או שצריכים להיות לכם התפקידים המוגדרים מראש ב-IAM הבאים:
  • אדמין של AlloyDB‏ (roles/alloydb.admin) או צפייה ב-AlloyDB‏ (roles/alloydb.viewer)
  • אדמין לניהול נפח האחסון (roles/storage.admin)
  • Compute Instance Admin (v1) (roles/compute.instanceAdmin.v1)

יצירת קטגוריה של Cloud Storage

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

הכנת מארח לקוח

כדי להכין את המארח של הלקוח לביצוע פעולת הייצוא, יוצרים מכונה וירטואלית ב-Compute Engine שיכולה להתחבר למכונה הראשית של AlloyDB שבה נמצא מסד הנתונים, ומתקינים במכונה הווירטואלית את הכלי pg_dump ואת Google Cloud CLI.

1. פועלים לפי ההוראות שבמאמר חיבור לקוח psql למופע כדי ליצור מכונת VM ב-Compute Engine עם הקישוריות המתאימה והכלי pg_dump מותקן. כשפועלים לפי ההוראות האלה, חשוב להקצות מספיק אחסון מקומי למכונת ה-VM ב-Compute Engine כדי לאחסן את קובץ ה-DMP שייווצר.

2. מתקינים את ה-CLI של gcloud כדי לקבל גישה משורת הפקודה ליצירת קובץ ה-DMP בקטגוריית Cloud Storage.

ייצוא מסד הנתונים

כדי לייצא את מסד הנתונים לקובץ DMP, צריך לקבל את כתובת ה-IP של המופע הראשי של AlloyDB שבו נמצא מסד הנתונים, ואז להשתמש בכלי pg_dump.

1. כדי לקבל את כתובת ה-IP של המופע הראשי של AlloyDB שבו נמצא מסד הנתונים, מעיינים בפרטים שלו.
2. מתחברים למכונה הווירטואלית ב-Compute Engine באמצעות SSH.

   המסוף

   1. נכנסים לדף VM instances במסוף Google Cloud .

      כניסה לדף VM instances

   2. ברשימת המכונות הווירטואליות, לוחצים על SSH בשורה של המכונה שיצרתם.

      

   gcloud

   משתמשים בפקודה gcloud compute ssh כדי להתחבר למכונה שיצרתם.

   gcloud compute ssh --project=PROJECT_ID --zone=ZONE VM_NAME

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

   • ‫PROJECT_ID: מזהה הפרויקט שמכיל את המכונה.
   • ‫ZONE: השם של האזור שבו נמצאת המכונה.
   • ‫VM_NAME: השם של המכונה.
3. מייצאים את מסד הנתונים לקובץ DMP:

   pg_dump -h IP_ADDRESS -U postgres -F custom \
     DB_NAME > DMP_FILE_NAME
   

   תוצג בקשה להזין את הסיסמה של המשתמש postgres.

   • ‫IP_ADDRESS: כתובת ה-IP של המופע הראשי.
   • ‫-F custom: מגדיר את הפורמט של קובץ ה-DMP כארכיון בפורמט מותאם אישית שאפשר לייבא מאוחר יותר באמצעות הכלי pg_restore.
   • ‫DB_NAME: השם של מסד הנתונים שרוצים לייצא.
   • ‫DMP_FILE_NAME: מציינים שם לקובץ ה-DMP שרוצים ליצור במערכת הקבצים המקומית של המארח של הלקוח.

   בדוגמה שלמעלה מוצגת פקודת pg_dump פשוטה. למידע על מגוון האפשרויות שהפקודה תומכת בהן, אפשר לעיין במסמכי התיעוד של PostgreSQL.

4. מעתיקים את קובץ ה-DMP לקטגוריה של Cloud Storage שיצרתם קודם:

   gcloud storage cp DMP_FILE_NAME gs://BUCKET_NAME

פינוי משאבים

אחרי שמייצאים בהצלחה את קובץ ה-DMP, אפשר למחוק את המכונה הווירטואלית של Compute Engine שבה השתמשתם במהלך תהליך הייצוא.

המאמרים הבאים

• איך מייצאים קובץ CSV
• איך מייצאים קובץ SQL מוכן לשימוש