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

‫MySQL   |  PostgreSQL   |  PostgreSQL ל-AlloyDB

סקירה כללית

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

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

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

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

אשף Database Migration Service עוזר לכם ליצור משימת העברה. אשף ההעברה כולל את החלוניות הבאות: Get started (תחילת העבודה), Define a source (הגדרת מקור), Create a destination (יצירת יעד), Define connectivity method (הגדרת שיטת קישוריות), Configure migration databases (הגדרת מסדי נתונים להעברה) ו-Test and create migration job (בדיקה ויצירה של משימת העברה). בקטעים הבאים בדף הזה מוסבר איך מאכלסים כל חלונית.

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

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

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

הגדרת הגדרות לעבודת ההעברה

1. נכנסים אל Migration jobs (משימות העברה) במסוף Google Cloud .

2. לוחצים על Create migration job (יצירת משימת העברה) בחלק העליון של הדף.

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

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

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

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

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

   חשוב: אם אתם מתכננים להשתמש במהדורת Cloud SQL ל-PostgreSQL Enterprise Plus, ודאו שהאזור שלכם נתמך במהדורה הזו. מידע על תמיכה באזורים ב-Cloud SQL ל-PostgreSQL Enterprise Plus

8. מציינים את סוג העבודה של ההעברה: One-time (חד-פעמי, צילום מצב בלבד) או Continuous (רציף, צילום מצב + שינויים שוטפים).

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

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

ציון מידע על פרופיל החיבור למקור

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

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

2. בקטע Customize data dump configurations (התאמה אישית של הגדרות יצוא נתונים), לוחצים על Show data dump configurations (הצגת הגדרות יצוא נתונים).

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

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

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

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

בחירת מכונת היעד

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

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

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

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

1. בתפריט שיטת הקישוריות, בוחרים שיטת קישוריות לרשת. בשיטה הזו מוגדר איך מכונת Cloud SQL החדשה תתחבר למסד הנתונים של המקור. שיטות הקישוריות הנוכחיות לרשת כוללות רשימת היתרים של IP, מנהרת SSH הפוכה, ממשקי Private Service Connect וקישור בין רשתות VPC שכנות.
   • אם בוחרים בשיטה של רשימת כתובות IP מותרות לחיבור לרשת, צריך לציין את כתובת ה-IP היוצאת של מכונת היעד. אם מכונת Cloud SQL שיצרתם היא מכונה עם זמינות גבוהה, צריך לכלול את כתובות ה-IP היוצאות של המכונה הראשית ושל המכונה המשנית.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

   זהירות: אם השתמשתם ב-Terraform כדי להקצות את מסד הנתונים של היעד, יכול להיות שתחוו סחף בהגדרות במהלך הביצוע של עבודת ההעברה. אל תנסו להחיל מחדש את ההגדרות של Terraform לפני שההעברה תסתיים. מידע נוסף זמין במאמר Terraform configuration drift.

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

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

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

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 \
  --cloudsql-instance=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 `
  --cloudsql-instance=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 ^
  --cloudsql-instance=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 peering או מנהרת SSH הפוכה), הקפידו להוסיף את הדגלים הנדרשים, כמו --peer-vpc או --vm, --vm-ip, --vm-port, --vpc. מידע נוסף זמין במאמרים הגדרת קישוריות ודוגמאות ל-Google Cloud CLI.

הערה: רק העברה רציפה נתמכת בהעברות אל Database Migration Service for PostgreSQL.

בדוגמה הזו נעשה שימוש בדגל האופציונלי --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

  אפשר לערוך בהמשך משימות העברה שיצרתם באמצעות --database-filter flag באמצעות הפקודה 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]

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

כדי להשתמש בשירות להעברת מסדי נתונים, צריך לוודא שמופע מסד הנתונים של היעד פועל כעותק לקריאה בזמן ההעברה. לפני שמתחילים את משימת ההעברה, מריצים את הפקודה 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 כדי לראות את הסטטוס של הפעולה עצמה.