יצירת עבודת העברה למופע יעד קיים

‫MySQL   |  PostgreSQL   |  מ-PostgreSQL ל-AlloyDB

סקירה כללית

ב-Database Migration Service, משימות העברה משמשות להעברת נתונים ממכונה של מסד נתונים במקור למכונה של מסד נתונים ביעד.

כדי ליצור משימת העברה למכונה קיימת של יעד:

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

יש כמה מגבלות שצריך להביא בחשבון כשרוצים להעביר נתונים למכונה שנוצרה מחוץ ל-Database Migration Service. מידע נוסף זמין במאמר מגבלות ידועות.

האשף של Database Migration Service עוזר ליצור משימת העברה. האשף הזה כולל את החלוניות הבאות: תחילת העבודה, הגדרת מקור, יצירת יעד, הגדרת שיטת קישוריות, הגדרת מסדי נתונים להעברה ובדיקה ויצירה של משימת העברה. בקטעים הבאים בדף הזה מוסבר איך לאכלס כל חלונית.

יצירת משימת העברה באמצעות מסוף Google Cloud

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

כדי לסיים את היצירה של משימת ההעברה, עוברים לכרטיסייה ולוחצים על המשימה. תהליך היצירה ימשיך מהמקום שבו הוא הופסק. המשימה תישאר כטיוטה עד שתלחצו על יצירה או על יצירה והפעלה.

הגדרת משימת ההעברה

1. נכנסים לדף Migration jobs במסוף Google Cloud .

2. בחלק העליון של הדף, לוחצים על Create migration job.

3. נותנים שם למשימת ההעברה. בוחרים שם ידידותי שיעזור לכם לזהות את משימת ההעברה. אל תכללו בשם המשימה מידע רגיש או פרטים אישיים מזהים.

4. משאירים את הערך שנוצר אוטומטית בשדה מזהה משימת מיגרציה.

5. בוחרים את המנוע של מסד הנתונים במקור.

6. בוחרים באפשרות AlloyDB ל-PostgreSQL כמנוע היעד.

7. בוחרים את אזור היעד להעברה. האזור הזה צריך להיות זהה לאזור שבו נמצא מסד הנתונים של היעד. אחרי שבוחרים את אזור היעד, אי אפשר לשנות את הבחירה.

8. בוחרים באפשרות רציפה (תמונת מצב + שינויים שוטפים) כסוג העבודה של משימת ההעברה.

9. בקטע Before you continue, review the prerequisites, לוחצים על Open כדי לראות הוראות שנוצרו באופן אוטומטי ויכולות לעזור לכם להכין את מסד הנתונים של המקור להעברה. מומלץ להשלים את הדרישות המוקדמות האלה בשלב הזה, אבל אפשר להשלים אותן בכל שלב לפני שבודקים או מתחילים את משימת ההעברה. מידע נוסף זמין במאמר הגדרת המקור.

10. לוחצים על שמירה והמשך.

מציינים מידע על פרופיל החיבור של המקור

1. אם יצרתם פרופיל חיבור, בחרו אותו מרשימת פרופילי החיבור הקיימים.

   אם לא יצרתם פרופיל חיבור, לוחצים על Create a connection profile בתחתית הרשימה הנפתחת ומבצעים את אותם השלבים כמו ביצירת פרופיל חיבור למקור.

   מומלץ ליצור פרופיל חיבור ייעודי להעברה ל-AlloyDB.

2. בקטע Customize data dump configurations, לוחצים על Show data dump configurations.

   מהירות ההקבלה של ה-data dump קשורה לעומס על מסד הנתונים של המקור. אפשר להשתמש בהגדרות הבאות:

   • אופטימלי (מומלץ): ביצועים מאוזנים עם עומס אופטימלי על מסד הנתונים של המקור.
   • מקסימלית: מספקת את מהירויות ה-dump הגבוהות ביותר, אבל עלולה לגרום לעומס מוגבר על מסד הנתונים של המקור.
   • מינימלי: צורך את הכמות הנמוכה ביותר של משאבי מחשוב במסד הנתונים של המקור, אבל קצב העברת הנתונים של ה-dump עשוי להיות איטי יותר.

   אם רוצים להשתמש בהגדרות מותאמות של מקביליות ב-data dump, צריך להגדיל את הפרמטרים max_replication_slots,‏ max_wal_senders ו-max_worker_processes במסד הנתונים של המקור. כדי לוודא שההגדרות נכונות, אתם יכולים להריץ את הבדיקה של משימת ההעברה בסיום היצירה של משימת ההעברה.

3. לוחצים על שמירה והמשך.

אם מסד הנתונים של המקור הוא מכונה של Cloud SQL ומופעלת בו רק כתובת IP ציבורית, צריך להפעיל את כתובת ה-IP הפרטית לפני שממשיכים לקטע הבא. חשוב לזכור לעדכן את פרופיל החיבור עם כתובת ה-IP הפרטית.

בוחרים את המכונה של היעד.

במקורות של Cloud SQL: אם אתם מעבירים ממכונה של Cloud SQL שמשתמשת בקישור דרך IP פרטי למכונה של Cloud SQL שמשתמשת בטווח כתובות IP שאינן RFC 1918, הוסיפו את הטווח שאינו RFC 1918 להגדרות הרשת של מכונת המקור של Cloud SQL. איך מגדירים רשתות מורשות במסמכי התיעוד של Cloud SQL

1. בתפריט Type of destination cluster, בוחרים באפשרות Existing cluster.
2. בקטע Select destination cluster, בוחרים את אשכול היעד.
3. בודקים את המידע על האשכול ולוחצים על Select and continue.
4. כדי להעביר למסד נתונים קיים ביעד, Database Migration Service מוריד בדרגה את מכונת היעד וממיר אותה לרפליקה. כדי לאשר שאפשר לבצע את ההורדה בדרגה, מזינים את המזהה של מכונת היעד בחלון האישור.
5. לוחצים על אישור והמשך.

הגדרת הקישוריות בין המכונות של מסד הנתונים במקור וביעד

הערה: אם המקור הוא Cloud SQL ל-PostgreSQL, אפשרויות הקישוריות מוגבלות לקישור בין רשתות VPC ולשרת proxy ל-TCP באמצעות מכונה וירטואלית שמתארחת בענן, בהתאם לארכיטקטורת הרשת של מכונת המקור ב-Cloud SQL (הישנה או החדשה).

1. בתפריט הנפתח Connectivity method, בוחרים שיטה לחיבור לרשת. השיטה הזו מגדירה איך אשכול AlloyDB החדש שנוצר יתחבר למסד הנתונים של המקור. השיטות הקיימות לחיבור לרשת כוללות רשימת היתרים של כתובות IP, קישור בין רשתות VPC שכנות (peering), ממשקי Private Service Connect, מנהרת SSH הפוכה ושרת proxy של TCP דרך VM שמתארח בענן.
2. אם בוחרים בשיטת הקישוריות לרשת "רשימת היתרים של כתובות IP", צריך לציין את כתובת ה-IP היוצאת של מכונת היעד. מעתיקים את כתובות ה-IP היוצאות של המכונה הראשית ושל המכונה המשנית, ומשתמשים בהן כדי להגדיר את חומת האש של הרשת לשרת של מסד הנתונים במקור ובקובץ pg_hba.conf, כדי שהמקור יוכל לקבל חיבורים מהכתובות האלה.

3. אם בוחרים בשיטת הקישוריות לרשת "מנהרת SSH הפוכה", צריך לבחור את המכונה הווירטואלית של Compute Engine שתארח את המנהרה.

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

   מריצים את הפקודות ממכונה שמחוברת גם למסד הנתונים של המקור וגם ל-Google Cloud.

4. אם אתם משתמשים באחת מהשיטות של קישור דרך IP פרטי, בחרו באפשרות VPC peering או PSC interface.
5. אם בוחרים בשיטת הקישוריות VPC peering, בוחרים את רשת ה-VPC שבה נמצא מסד הנתונים של המקור. מכונת Cloud SQL תעודכן כדי להתחבר לרשת הזו.

6. אם בוחרים בשיטת הקישוריות "שרת proxy של TCP דרך מכונה וירטואלית שמתארחת בענן", צריך להזין את הפרטים הנדרשים למכונה הווירטואלית החדשה של Compute Engine שתארח את שרת ה-proxy של TCP.

   אחרי שמציינים את הפרטים, מסוף Google Cloud מספק סקריפט שמבצע את השלבים להגדרת שרת ה-proxy בין מסדי הנתונים של המקור והיעד. צריך להריץ את הסקריפט במכונה עם גרסה מעודכנת של Google Cloud CLI.

   אחרי הרצת הסקריפט, הוא יפיק את כתובת ה-IP הפרטית של המכונה הווירטואלית החדשה שנוצרה. מזינים את כתובת ה-IP ולוחצים על הגדרה והמשך.

7. אחרי שבוחרים את שיטת הקישוריות לרשת ומספקים את כל המידע הנוסף שנדרש לשיטה, לוחצים על CONFIGURE & CONTINUE.

הגדרת מסדי נתונים להעברה

אתם יכולים לבחור את מסדי הנתונים שאתם רוצים להעביר.

1. ברשימה Databases to migrate, בוחרים אחת מהאפשרויות הבאות:
   • ‫All databases: בחירה בכל מסדי הנתונים שקיימים במקור.
   • מסדי נתונים ספציפיים: מאפשר לבחור מסדי נתונים ספציפיים מכל מסדי הנתונים שקיימים במקור.

2. אם אתם רוצים להעביר מסדי נתונים ספציפיים, אתם יכולים לסנן את הרשימה שמופיעה ולבחור את מסדי הנתונים שאתם רוצים ש-Database Migration Service יעביר ליעד.

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

3. לוחצים על שמירה והמשך.

בדיקה ויצירה של משימת ההעברה

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

1. לוחצים על TEST JOB כדי לוודא ש:

   • מסד הנתונים של המקור הוגדר בצורה נכונה, בהתאם לדרישות המוקדמות.
   • מכונות המקור והיעד יכולות לתקשר זו עם זו.
   • כל העדכונים הנדרשים בכתובות ה-IP הפרטיות ביעד בוצעו.
   • משימת ההעברה תקינה, והגרסאות של המקור והיעד תואמות.

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

   למידע נוסף על הסיבות לכך שהבדיקה עלולה להיכשל ואיך לפתור בעיות שקשורות לכשל בבדיקה, ראו אבחון בעיות ב-AlloyDB.

   אפשר ליצור את משימת ההעברה גם אם הבדיקה נכשלת, אבל אחרי שהמשימה מתחילה, יכול להיות שהיא תיכשל בשלב כלשהו במהלך ההרצה.

2. לוחצים על CREATE & START JOB כדי ליצור את משימת ההעברה ולהתחיל אותה מיד, או על CREATE JOB כדי ליצור את משימת ההעברה בלי להתחיל אותה מיד.

   אם המשימה לא מתחילה בזמן שהיא נוצרת, אפשר להפעיל אותה מהדף Migration jobs בלחיצה על START.

   לא משנה מתי משימת ההעברה מתחילה, הארגון שלכם מחויב על קיום המכונה של היעד.

   כשמפעילים את משימת ההעברה, Database Migration Service מתחיל את ה-dump המלא ונועל לזמן קצר את מסד הנתונים של המקור. אם מקור הנתונים נמצא ב-Amazon RDS או ב-Amazon Aurora, ‏ Database Migration Service דורש גם זמן השבתה קצר (פחות מדקה בערך) של פעולות הכתיבה בתחילת ההעברה. מידע נוסף זמין במאמר שיקולים לגבי מקביליות של העברת נתונים.

3. משימת ההעברה נוספת לרשימת משימות ההעברה ואפשר לראות אותה ישירות.

4. עוברים לקטע בדיקת משימת ההעברה.

יצירת משימת העברה באמצעות Google Cloud CLI

כשמעבירים למכונה קיימת באמצעות Google Cloud CLI, צריך ליצור באופן ידני את פרופיל החיבור של מכונת היעד. לא צריך לעשות את זה כשמשתמשים במסוף Google Cloud , כי Database Migration Service יוצר ומסיר בשבילכם את פרופיל החיבור של היעד.

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

לפני שמשתמשים ב-CLI של gcloud כדי ליצור משימת העברה למכונה קיימת של מסד נתונים ביעד, צריך:

• יוצרים את מכונת מסד הנתונים של היעד.
• מכינים את המכונה של מסד הנתונים במקור. קישורים להנחיות ולשיטות המומלצות:
  • הגדרת המקור
  • יוצרים את פרופיל החיבור של המקור (כדי ליצור משימת העברה, צריך את המזהה של פרופיל החיבור של המקור).
  • הגדרת הקישוריות

יצירת פרופיל חיבור ליעד

מריצים את הפקודה gcloud database-migration connection-profiles create כדי ליצור את פרופיל החיבור של היעד במכונה הקיימת:

בדוגמה הזו נעשה שימוש בדגל האופציונלי --no-async כדי שכל הפעולות יתבצעו באופן סינכרוני. זה אומר שיכול להיות שייקח קצת זמן עד שחלק מהפקודות יסתיימו. אפשר לדלג על הדגל --no-async כדי להריץ פקודות באופן אסינכרוני. אם כן, צריך להשתמש בפקודה gcloud database-migration operations describe כדי לוודא שהפעולה הצליחה.

לפני השימוש בנתוני הפקודה הבאים, צריך להחליף את הנתונים הבאים:

• CONNECTION_PROFILE_ID עם מזהה בפורמט קריא למכונה עבור פרופיל החיבור שלך.
• ‫REGION במזהה של האזור שבו רוצים לשמור את פרופיל החיבור.
• ‫DESTINATION_INSTANCE_ID במזהה של מכונת היעד.
• (אופציונלי) CONNECTION_PROFILE_NAME עם שם קריא לאנשים לפרופיל החיבור. הערך הזה מוצג במסוף Google Cloud .

מריצים את הפקודה הבאה:

‫Linux,‏ macOS או Cloud Shell

הערה: חשוב לוודא שהפעלתם את Google Cloud CLI עם אימות ופרויקט, על ידי הרצת הפקודה gcloud init או הפקודות gcloud auth login ו- gcloud config set project.

gcloud database-migration connection-profiles \
create postgresql CONNECTION_PROFILE_ID \
  --no-async \
  --alloydb-cluster=DESTINATION_INSTANCE_ID \
  --region=REGION \
  --display-name=CONNECTION_PROFILE_NAME

‏Windows (PowerShell)

הערה: חשוב לוודא שהפעלתם את Google Cloud CLI עם אימות ופרויקט, על ידי הרצת הפקודה gcloud init או הפקודות gcloud auth login ו- gcloud config set project.

gcloud database-migration connection-profiles `
create postgresql CONNECTION_PROFILE_ID `
  --no-async `
  --alloydb-cluster=DESTINATION_INSTANCE_ID `
  --region=REGION `
  --display-name=CONNECTION_PROFILE_NAME

Windows‏ (cmd.exe)

הערה: חשוב לוודא שהפעלתם את Google Cloud CLI עם אימות ופרויקט, על ידי הרצת הפקודה gcloud init או הפקודות gcloud auth login ו- gcloud config set project.

gcloud database-migration connection-profiles ^
create postgresql CONNECTION_PROFILE_ID ^
  --no-async ^
  --alloydb-cluster=DESTINATION_INSTANCE_ID ^
  --region=REGION ^
  --display-name=CONNECTION_PROFILE_NAME

אמורים לקבל תגובה שדומה לזו:

Waiting for connection profile [CONNECTION_PROFILE_ID]
to be created with [OPERATION_ID]

Waiting for operation [OPERATION_ID] to complete...done.

Created connection profile CONNECTION_PROFILE_ID [OPERATION_ID]

יצירת משימת ההעברה

הערה: הדוגמאות הבאות מייצגות תרחיש מיגרציה שבו משתמשים בקישור דרך IP פרטית בין מסדי הנתונים של המקור והיעד. אם אתם משתמשים בסוג קישוריות אחר (לדוגמה, קישור רשתות VPC או מנהרת SSH הפוכה), הקפידו להוסיף את הדגלים הנדרשים, כמו --peer-vpc או --vm, --vm-ip, --vm-port, --vpc. מידע נוסף זמין במאמרים הגדרת קישוריות ודוגמאות ל-Google Cloud CLI.

הערה: בהעברות ל-AlloyDB יש תמיכה רק בסוג העברה רציפה.

בדוגמה הזו נעשה שימוש בדגל האופציונלי --no-async כדי שכל הפעולות יתבצעו באופן סינכרוני. זה אומר שיכול להיות שייקח קצת זמן עד שחלק מהפקודות יסתיימו. אפשר לדלג על הדגל --no-async כדי להריץ פקודות באופן אסינכרוני. אם כן, צריך להשתמש בפקודה gcloud database-migration operations describe כדי לוודא שהפעולה הצליחה.

לפני השימוש בנתוני הפקודה הבאים, צריך להחליף את הנתונים הבאים:

• ‫MIGRATION_JOB_ID עם מזהה בפורמט קריא למכונה של משימת המיגרציה. הערך הזה משמש לעבודה עם משימות העברה באמצעות פקודות Google Cloud CLI או API של Database Migration Service.
• ‫REGION במזהה האזור שבו רוצים לשמור את משימת ההעברה.
• ‫MIGRATION_JOB_NAME בשם קריא לאנשים של משימת ההעברה. הערך הזה מוצג ב-Database Migration Service במסוף Google Cloud .
• ‫SOURCE_CONNECTION_PROFILE_ID עם מזהה בפורמט קריא למכונה של פרופיל החיבור של המקור.
• ‫DESTINATION_CONNECTION_PROFILE_ID במזהה בפורמט קריא למכונה של פרופיל החיבור של היעד.

• אופציונלי: כברירת מחדל, Database Migration Service מעביר את כל מסדי הנתונים במקור. אם רוצים להעביר רק מסדי נתונים ספציפיים, משתמשים בדגל --databases-filter ומציינים את המזהים שלהם ברשימה מופרדת בפסיקים.

  לדוגמה: --databases-filter=my-business-database,my-other-database

  אפשר לערוך בהמשך את משימות ההעברה שנוצרו באמצעות הדגל --databases-filter, באמצעות הפקודה gcloud database-migration migration-jobs update.

מריצים את הפקודה הבאה:

‫Linux,‏ macOS או Cloud Shell

הערה: חשוב לוודא שהפעלתם את Google Cloud CLI עם אימות ופרויקט, על ידי הרצת הפקודה gcloud init או הפקודות gcloud auth login ו- gcloud config set project.

gcloud database-migration migration-jobs \
create MIGRATION_JOB_ID \
  --no-async \
  --region=REGION \
  --display-name=MIGRATION_JOB_NAME \
  --source=SOURCE_CONNECTION_PROFILE_ID \
  --destination=DESTINATION_CONNECTION_PROFILE_ID \
  --type=CONTINUOUS \

‏Windows (PowerShell)

הערה: חשוב לוודא שהפעלתם את Google Cloud CLI עם אימות ופרויקט, על ידי הרצת הפקודה gcloud init או הפקודות gcloud auth login ו- gcloud config set project.

gcloud database-migration migration-jobs `
create MIGRATION_JOB_ID `
  --no-async `
  --region=REGION `
  --display-name=MIGRATION_JOB_NAME `
  --source=SOURCE_CONNECTION_PROFILE_ID `
  --destination=DESTINATION_CONNECTION_PROFILE_ID `
  --type=CONTINUOUS `

Windows‏ (cmd.exe)

הערה: חשוב לוודא שהפעלתם את Google Cloud CLI עם אימות ופרויקט, על ידי הרצת הפקודה gcloud init או הפקודות gcloud auth login ו- gcloud config set project.

gcloud database-migration migration-jobs ^
create MIGRATION_JOB_ID ^
  --no-async ^
  --region=REGION ^
  --display-name=MIGRATION_JOB_NAME ^
  --source=SOURCE_CONNECTION_PROFILE_ID ^
  --destination=DESTINATION_CONNECTION_PROFILE_ID ^
  --type=CONTINUOUS ^

אמורים לקבל תגובה שדומה לזו:

Waiting for migration job [MIGRATION_JOB_ID]
to be created with [OPERATION_ID]

Waiting for operation [OPERATION_ID] to complete...done.

Created migration job MIGRATION_JOB_ID [OPERATION_ID]

הורדה בדרגה של מסד הנתונים ביעד

כדי להשתמש ב-Database Migration Service, צריך להגדיר את המכונה של מסד הנתונים ביעד כעותק לקריאה בלבד בזמן ההעברה. לפני שמתחילים את משימת ההעברה, מריצים את הפקודה gcloud database-migration migration-jobs demote-destination כדי להוריד בדרגה את המכונה של מסד הנתונים ביעד.

לפני השימוש בנתוני הפקודה הבאים, צריך להחליף את הנתונים הבאים:

• ‫MIGRATION_JOB_ID במזהה של משימת ההעברה.

  אם אתם לא יודעים מה המזהה, אתם יכולים להשתמש בפקודה gcloud database-migration migration-jobs list כדי להציג את כל משימות ההעברה באזור מסוים ואת המזהים שלהן.

• ‫REGION במזהה האזור שבו נשמר פרופיל החיבור.

מריצים את הפקודה הבאה:

‫Linux,‏ macOS או Cloud Shell

הערה: חשוב לוודא שהפעלתם את Google Cloud CLI עם אימות ופרויקט, על ידי הרצת הפקודה gcloud init או הפקודות gcloud auth login ו- gcloud config set project.

gcloud database-migration migration-jobs \
demote-destination MIGRATION_JOB_ID \
  --region=REGION

‏Windows (PowerShell)

הערה: חשוב לוודא שהפעלתם את Google Cloud CLI עם אימות ופרויקט, על ידי הרצת הפקודה gcloud init או הפקודות gcloud auth login ו- gcloud config set project.

gcloud database-migration migration-jobs `
demote-destination MIGRATION_JOB_ID `
  --region=REGION

Windows‏ (cmd.exe)

הערה: חשוב לוודא שהפעלתם את Google Cloud CLI עם אימות ופרויקט, על ידי הרצת הפקודה gcloud init או הפקודות gcloud auth login ו- gcloud config set project.

gcloud database-migration migration-jobs ^
demote-destination MIGRATION_JOB_ID ^
  --region=REGION

תוצאה

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

done: false
metadata:
  '@type': type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata
  apiVersion: v1
  createTime: '2024-02-20T12:20:24.493106418Z'
  requestedCancellation: false
  target: MIGRATION_JOB_ID
  verb: demote-destination
name: OPERATION_ID

כדי לבדוק אם הפעולה הצליחה, אפשר לשלוח שאילתה לאובייקט הפעולה שהוחזר, או לבדוק את הסטטוס של משימת ההעברה:

• משתמשים בפקודה gcloud database-migration migration-jobs describe כדי לראות את הסטטוס של משימת ההעברה.
• כדי לראות את סטטוס הפעולה עצמה, משתמשים ב- gcloud database-migration operations describe עם OPERATION_ID.

ניהול משימות העברה

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

1. אופציונלי: אימות משימת ההעברה.
   מומלץ קודם לאמת את משימת ההעברה על ידי הרצת הפקודה gcloud database-migration migration-jobs verify.

   למידע נוסף, הרחיבו את הקטע הבא:

   gcloud database-migration migration-jobs verify

   לפני השימוש בנתוני הפקודה הבאים, צריך להחליף את הנתונים הבאים:

   • ‫MIGRATION_JOB_ID במזהה של משימת ההעברה.

     אם אתם לא יודעים מה המזהה, אתם יכולים להשתמש בפקודה gcloud database-migration migration-jobs list כדי להציג את כל משימות ההעברה באזור מסוים ואת המזהים שלהן.

   • ‫REGION במזהה האזור שבו נשמר פרופיל החיבור.

   מריצים את הפקודה הבאה:

   ‫Linux,‏ macOS או Cloud Shell

   הערה: חשוב לוודא שהפעלתם את Google Cloud CLI עם אימות ופרויקט, על ידי הרצת הפקודה gcloud init או הפקודות gcloud auth login ו- gcloud config set project.

   gcloud database-migration migration-jobs \
   verify MIGRATION_JOB_ID \
     --region=REGION

   ‏Windows (PowerShell)

   הערה: חשוב לוודא שהפעלתם את Google Cloud CLI עם אימות ופרויקט, על ידי הרצת הפקודה gcloud init או הפקודות gcloud auth login ו- gcloud config set project.

   gcloud database-migration migration-jobs `
   verify MIGRATION_JOB_ID `
     --region=REGION

   Windows‏ (cmd.exe)

   הערה: חשוב לוודא שהפעלתם את Google Cloud CLI עם אימות ופרויקט, על ידי הרצת הפקודה gcloud init או הפקודות gcloud auth login ו- gcloud config set project.

   gcloud database-migration migration-jobs ^
   verify MIGRATION_JOB_ID ^
     --region=REGION

   תוצאה

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

   done: false
   metadata:
     '@type': type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata
     apiVersion: v1
     createTime: '2024-02-20T12:20:24.493106418Z'
     requestedCancellation: false
     target: MIGRATION_JOB_ID
     verb: verify
   name: OPERATION_ID
   

   כדי לבדוק אם הפעולה הצליחה, אפשר לשלוח שאילתה לאובייקט הפעולה שהוחזר, או לבדוק את הסטטוס של משימת ההעברה:

   • משתמשים בפקודה gcloud database-migration migration-jobs describe עם MIGRATION_JOB_ID כדי לראות את הסטטוס של משימת ההעברה.
   • משתמשים בפקודה gcloud database-migration operations describe עם הדגל OPERATION_ID כדי לראות את סטטוס הפעולה עצמה.

2. אופציונלי: אחזור מידע על מסדי הנתונים שנבחרו להעברה.
   כשמעבירים מסדי נתונים ספציפיים, צריך לאחזר ב-Database Migration Service את הפרטים של מסדי הנתונים שנבחרו למשימת ההעברה באמצעות הדגל --database-filter.

   לפני שמתחילים את משימת ההעברה, מריצים את הפקודה gcloud database-migration migration-jobs fetch-source-objects.

   למידע נוסף, הרחיבו את הקטע הבא:

   gcloud database-migration migration-jobs fetch-source-objects

   לפני השימוש בנתוני הפקודה הבאים, צריך להחליף את הנתונים הבאים:

   • ‫MIGRATION_JOB_ID במזהה של משימת ההעברה.

     אם אתם לא יודעים מה המזהה, אתם יכולים להשתמש בפקודה gcloud database-migration migration-jobs list כדי להציג את כל משימות ההעברה באזור מסוים ואת המזהים שלהן.

   • ‫REGION במזהה האזור שבו נשמר פרופיל החיבור.

   מריצים את הפקודה הבאה:

   ‫Linux,‏ macOS או Cloud Shell

   הערה: חשוב לוודא שהפעלתם את Google Cloud CLI עם אימות ופרויקט, על ידי הרצת הפקודה gcloud init או הפקודות gcloud auth login ו- gcloud config set project.

   gcloud database-migration migration-jobs \
   fetch-source-objects MIGRATION_JOB_ID \
     --region=REGION

   ‏Windows (PowerShell)

   הערה: חשוב לוודא שהפעלתם את Google Cloud CLI עם אימות ופרויקט, על ידי הרצת הפקודה gcloud init או הפקודות gcloud auth login ו- gcloud config set project.

   gcloud database-migration migration-jobs `
   fetch-source-objects MIGRATION_JOB_ID `
     --region=REGION

   Windows‏ (cmd.exe)

   הערה: חשוב לוודא שהפעלתם את Google Cloud CLI עם אימות ופרויקט, על ידי הרצת הפקודה gcloud init או הפקודות gcloud auth login ו- gcloud config set project.

   gcloud database-migration migration-jobs ^
   fetch-source-objects MIGRATION_JOB_ID ^
     --region=REGION

   תוצאה

   הפלט אמור להיראות כך:

   Waiting for migration job MIGRATION_JOB_ID
   to fetch source objects with OPERATION_ID
   
   Waiting for operation OPERATION_ID to complete...done.
   
   SOURCE_OBJECT                                      STATE         PHASE              ERROR
   {'database': 'DATABASE_NAME', 'type': 'DATABASE'}  NOT_SELECTED  PHASE_UNSPECIFIED
   {'database': 'DATABASE_NAME', 'type': 'DATABASE'}  STOPPED       CDC                {'code': 1, 'message': 'Internal error'}
   

   כדי לבדוק אם הפעולה הצליחה, אפשר לשלוח שאילתה לאובייקט הפעולה שהוחזר, או לבדוק את הסטטוס של משימת ההעברה:

   • משתמשים בפקודה gcloud database-migration migration-jobs describe עם MIGRATION_JOB_ID כדי לראות את הסטטוס של משימת ההעברה.
   • משתמשים בפקודה gcloud database-migration operations describe עם הדגל OPERATION_ID כדי לראות את סטטוס הפעולה עצמה.

3. התחלת משימת ההעברה.
   מפעילים את משימת ההעברה באמצעות הפקודה gcloud database-migration migration-jobs start.

   למידע נוסף, הרחיבו את הקטע הבא:

   gcloud database-migration migration-jobs start

   לפני השימוש בנתוני הפקודה הבאים, צריך להחליף את הנתונים הבאים:

   • ‫MIGRATION_JOB_ID במזהה של משימת ההעברה.

     אם אתם לא יודעים מה המזהה, אתם יכולים להשתמש בפקודה gcloud database-migration migration-jobs list כדי להציג את כל משימות ההעברה באזור מסוים ואת המזהים שלהן.

   • ‫REGION במזהה האזור שבו נשמר פרופיל החיבור.

   מריצים את הפקודה הבאה:

   ‫Linux,‏ macOS או Cloud Shell

   הערה: חשוב לוודא שהפעלתם את Google Cloud CLI עם אימות ופרויקט, על ידי הרצת הפקודה gcloud init או הפקודות gcloud auth login ו- gcloud config set project.

   gcloud database-migration migration-jobs \
   start MIGRATION_JOB_ID \
     --region=REGION

   ‏Windows (PowerShell)

   הערה: חשוב לוודא שהפעלתם את Google Cloud CLI עם אימות ופרויקט, על ידי הרצת הפקודה gcloud init או הפקודות gcloud auth login ו- gcloud config set project.

   gcloud database-migration migration-jobs `
   start MIGRATION_JOB_ID `
     --region=REGION

   Windows‏ (cmd.exe)

   הערה: חשוב לוודא שהפעלתם את Google Cloud CLI עם אימות ופרויקט, על ידי הרצת הפקודה gcloud init או הפקודות gcloud auth login ו- gcloud config set project.

   gcloud database-migration migration-jobs ^
   start MIGRATION_JOB_ID ^
     --region=REGION

   תוצאה

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

   done: false
   metadata:
     '@type': type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata
     apiVersion: v1
     createTime: '2024-02-20T12:20:24.493106418Z'
     requestedCancellation: false
     target: MIGRATION_JOB_ID
     verb: start
   name: OPERATION_ID
   

   כדי לבדוק אם הפעולה הצליחה, אפשר לשלוח שאילתה לאובייקט הפעולה שהוחזר, או לבדוק את הסטטוס של משימת ההעברה:

   • משתמשים בפקודה gcloud database-migration migration-jobs describe עם MIGRATION_JOB_ID כדי לראות את הסטטוס של משימת ההעברה.
   • משתמשים בפקודה gcloud database-migration operations describe עם הדגל OPERATION_ID כדי לראות את סטטוס הפעולה עצמה.

קידום משימת ההעברה

אחרי שההעברה מגיעה לשלב של סימון נתונים שהשתנו (CDC), אפשר לקדם את מכונת מסד הנתונים של היעד מרפליקה לקריאה בלבד למכונה עצמאית. מריצים את הפקודה gcloud database-migration migration-jobs promote:

לפני השימוש בנתוני הפקודה הבאים, צריך להחליף את הנתונים הבאים:

• ‫MIGRATION_JOB_ID במזהה של משימת ההעברה.

  אם אתם לא יודעים מה המזהה, אתם יכולים להשתמש בפקודה gcloud database-migration migration-jobs list כדי להציג את כל משימות ההעברה באזור מסוים ואת המזהים שלהן.

• ‫REGION במזהה האזור שבו נשמר פרופיל החיבור.

מריצים את הפקודה הבאה:

‫Linux,‏ macOS או Cloud Shell

הערה: חשוב לוודא שהפעלתם את Google Cloud CLI עם אימות ופרויקט, על ידי הרצת הפקודה gcloud init או הפקודות gcloud auth login ו- gcloud config set project.

gcloud database-migration migration-jobs \
promote MIGRATION_JOB_ID \
  --region=REGION

‏Windows (PowerShell)

הערה: חשוב לוודא שהפעלתם את Google Cloud CLI עם אימות ופרויקט, על ידי הרצת הפקודה gcloud init או הפקודות gcloud auth login ו- gcloud config set project.

gcloud database-migration migration-jobs `
promote MIGRATION_JOB_ID `
  --region=REGION

Windows‏ (cmd.exe)

הערה: חשוב לוודא שהפעלתם את Google Cloud CLI עם אימות ופרויקט, על ידי הרצת הפקודה gcloud init או הפקודות gcloud auth login ו- gcloud config set project.

gcloud database-migration migration-jobs ^
promote MIGRATION_JOB_ID ^
  --region=REGION

תוצאה

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

done: false
metadata:
  '@type': type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata
  apiVersion: v1
  createTime: '2024-02-20T12:20:24.493106418Z'
  requestedCancellation: false
  target: MIGRATION_JOB_ID
  verb: start
name: OPERATION_ID

כדי לבדוק אם הפעולה הצליחה, אפשר לשלוח שאילתה לאובייקט הפעולה שהוחזר, או לבדוק את הסטטוס של משימת ההעברה:

• משתמשים בפקודה gcloud database-migration migration-jobs describe עם MIGRATION_JOB_ID כדי לראות את הסטטוס של משימת ההעברה.
• משתמשים בפקודה gcloud database-migration operations describe עם הדגל OPERATION_ID כדי לראות את סטטוס הפעולה עצמה.