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

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

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

אפשר לבצע את הפעולות הבאות במשימות העברה:

פעולה תיאור
לעריכה

כדי לבצע את השינויים הבאים, צריך לערוך את משימת ההעברה:

  • לעבור בין העברה של כל מסדי הנתונים לבין העברה של מסדי נתונים ספציפיים.
  • אפשר להוסיף או להסיר מסדי נתונים בכל שלב או מצב של ההעברה, כמה פעמים שרוצים. כשמסירים מסד נתונים, Database Migration Service מפסיק את תהליך השכפול במסד הנתונים הזה, אבל לא מסיר אותו ממכונת היעד. מידע נוסף זמין במאמר הוספה או הסרה של מסדי נתונים.
  • עורכים את רמת ההקבלה של ה-data dump של משימת העברה שפועלת. אחרי שמבצעים את השינויים, צריך לשמור ולהפעיל מחדש את המשימה.
  • עדכון השם המוצג של משימת ההעברה באמצעות ה-CLI של gcloud. מידע נוסף זמין במאמר עריכת משימת העברה שהיא לא טיוטה.
התחלה להתחיל משימות העברה שנוצרו אבל לא הופעלו. אפשר להפעיל משימות שלא נמצאות במצב Running או Starting. למידע על הסטטוסים של משימות ההעברה
הפסקה

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

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

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

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

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

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

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

למחוק משימת העברה. אפשר למחוק משימות העברה בכל מצב. עם זאת, אפשר למחוק משימת העברה פעילה רק במסוף Google Cloud .

התוצאה תלויה בסטטוס של המשימה:

  • אם סטטוס משימת ההעברה הוא Completed, הרשומה נמחקת מרשימת משימות ההעברה.
  • אם משימת ההעברה נמצאת בסטטוס אחר, במסוף Google Cloud יש אפשרות לבחור אם למחוק את מכונת היעד של Cloud SQL.

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

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

התחלת משימת העברה

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

כדי להתחיל משימת העברה:

המסוף

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

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

  2. בכרטיסייה Jobs, לוחצים על השם המוצג של משימת ההעברה שרוצים להתחיל.

    דף הפרטים של משימת ההעברה נפתח.

  3. לוחצים על התחלה.
  4. בתיבת הדו-שיח, לוחצים על התחלה.

gcloud

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

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

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

  • REGION במזהה של האזור שבו נשמרת משימת ההעברה.

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

‫Linux,‏ macOS או Cloud Shell

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

‏Windows (PowerShell)

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

Windows‏ (cmd.exe)

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

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

הפסקת משימת העברה

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

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

המסוף

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

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

  2. בכרטיסייה Jobs, לוחצים על השם המוצג של משימת ההעברה שרוצים לעצור.

    דף הפרטים של משימת ההעברה נפתח.

  3. לוחצים על הפסקה.
  4. בתיבת הדו-שיח, לוחצים על עצירה.

gcloud

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

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

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

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

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

‫Linux,‏ macOS או Cloud Shell

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

‏Windows (PowerShell)

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

Windows‏ (cmd.exe)

gcloud database-migration migration-jobs ^
stop 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: stop
name: OPERATION_ID
כדי לבדוק אם הפעולה הצליחה, אפשר לשלוח שאילתה לאובייקט הפעולה שהוחזר, או לבדוק את הסטטוס של משימת ההעברה:

המשך של משימת העברה

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

כדי להמשיך משימת העברה שהופסקה:

המסוף

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

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

  2. בכרטיסייה Jobs, לוחצים על השם המוצג של משימת ההעברה שרוצים להמשיך.

    דף הפרטים של משימת ההעברה נפתח.

  3. לוחצים על המשך.
  4. בתיבת הדו-שיח, לוחצים על המשך.

gcloud

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

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

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

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

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

‫Linux,‏ macOS או Cloud Shell

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

‏Windows (PowerShell)

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

Windows‏ (cmd.exe)

gcloud database-migration migration-jobs ^
resume 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: resume
name: OPERATION_ID
כדי לבדוק אם הפעולה הצליחה, אפשר לשלוח שאילתה לאובייקט הפעולה שהוחזר, או לבדוק את הסטטוס של משימת ההעברה:

הפעלה מחדש של משימת העברה

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

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

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

כדי להפעיל מחדש משימת העברה, מבצעים את השלבים הבאים:

המסוף

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

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

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

    דף הפרטים של משימת ההעברה נפתח.

  3. מבצעים אחת מהפעולות הבאות להפעלה מחדש:

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

      מופיעה תיבת הדו-שיח להפעלה מחדש של משימת ההעברה.

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

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

  4. בתיבת הדו-שיח, לוחצים על הפעלה מחדש.

gcloud

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

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

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

  • REGION במזהה של האזור שבו נשמרת משימת ההעברה.

  • אופציונלי: כברירת מחדל, 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

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

‏Windows (PowerShell)

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

Windows‏ (cmd.exe)

gcloud database-migration migration-jobs ^
restart 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: restart
name: OPERATION_ID
כדי לבדוק אם הפעולה הצליחה, אפשר לשלוח שאילתה לאובייקט הפעולה שהוחזר, או לבדוק את הסטטוס של משימת ההעברה:

עדכון של טיוטת משימת העברה

כדי לסיים את היצירה של משימת ההעברה, מבצעים את השלבים הבאים:

המסוף

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

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

  2. בכרטיסייה Drafts, לוחצים על השם המוצג של משימת ההעברה שרוצים לסיים את היצירה שלה.

    אשף היצירה של משימת ההעברה נפתח.

  3. מסיימים ליצור את משימת ההעברה. איך יוצרים משימת העברה

gcloud

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

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

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

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

‫Linux,‏ macOS או Cloud Shell

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 \
  --databases-filter=COMMA_SEPARATED_DATABASE_ID_LIST \
  --type=CONTINUOUS

‏Windows (PowerShell)

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 `
  --databases-filter=COMMA_SEPARATED_DATABASE_ID_LIST `
  --type=CONTINUOUS

Windows‏ (cmd.exe)

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 ^
  --databases-filter=COMMA_SEPARATED_DATABASE_ID_LIST ^
  --type=CONTINUOUS

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

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

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

Updated migration job MIGRATION_JOB_ID [OPERATION_ID]

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

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

כדי להוסיף מסדי נתונים למשימת ההעברה או להסיר אותם ממנה:

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

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

  2. בכרטיסייה Jobs, לוחצים על השם המוצג של משימת ההעברה. דף הפרטים של משימת ההעברה נפתח.
  3. לוחצים על Edit.
  4. בקטע Select databases to migrate, מסמנים את התיבות של מסדי הנתונים החדשים שרוצים להוסיף למשימת ההעברה, או מבטלים את הסימון של מסדי הנתונים שרוצים להסיר.
  5. לוחצים על Save.

עריכת משימת העברה שהיא לא טיוטה

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

במשימות העברה שהן לא טיוטה, אתם יכולים להשתמש ב-Google Cloud CLI כדי לשנות את השם המוצג של משימת ההעברה:

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

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

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

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

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

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

‫Linux,‏ macOS או Cloud Shell

gcloud database-migration migration-jobs \
update MIGRATION_JOB_ID \
  --region=REGION \
  --display-name=MIGRATION_JOB_NAME

‏Windows (PowerShell)

gcloud database-migration migration-jobs `
update MIGRATION_JOB_ID `
  --region=REGION `
  --display-name=MIGRATION_JOB_NAME

Windows‏ (cmd.exe)

gcloud database-migration migration-jobs ^
update MIGRATION_JOB_ID ^
  --region=REGION ^
  --display-name=MIGRATION_JOB_NAME

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

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

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

Updated migration job MIGRATION_JOB_ID [OPERATION_ID]

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

לפני שמריצים את משימת ההעברה, אפשר לבצע פעולת בדיקה כדי לוודא ש-Database Migration Service יכול להגיע לכל הישויות הנדרשות במקור וביעד. במסוף Google Cloud , אפשר לבדוק רק טיוטות של משימות העברה שנוצרו באשף ליצירת משימות העברה (ראו יצירת משימת העברה).

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

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

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

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

  • REGION במזהה של האזור שבו נשמרת משימת ההעברה.

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

‫Linux,‏ macOS או Cloud Shell

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

‏Windows (PowerShell)

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

Windows‏ (cmd.exe)

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

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

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

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

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

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

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

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

  • ‫REGION במזהה האזור שבו נשמר פרופיל החיבור.
  • ‫DATABASE_NAME בשם של מסד הנתונים.

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

‫Linux,‏ macOS או Cloud Shell

gcloud database-migration objects lookup --migration-job=MIGRATION_JOB_ID \
  --region=REGION --database=DATABASE_NAME

‏Windows (PowerShell)

gcloud database-migration objects lookup --migration-job=MIGRATION_JOB_ID `
  --region=REGION --database=DATABASE_NAME

Windows‏ (cmd.exe)

gcloud database-migration objects lookup --migration-job=MIGRATION_JOB_ID ^
  --region=REGION --database=DATABASE_NAME

תוצאה

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

createTime: '2025-03-21T17:05:19.211441641Z'
name: PROJECT_ID
phase: FULL_DUMP
sourceObject:
  database: DATABASE_NAME
  type: DATABASE
state: RUNNING
כדי לבדוק אם הפעולה הצליחה, אפשר לשלוח שאילתה לאובייקט הפעולה שהוחזר, או לבדוק את הסטטוס של משימת ההעברה:

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

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

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

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

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

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

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

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

‫Linux,‏ macOS או Cloud Shell

gcloud database-migration objects list --migration-job=MIGRATION_JOB_ID \
  --region=REGION

‏Windows (PowerShell)

gcloud database-migration objects list --migration-job=MIGRATION_JOB_ID `
  --region=REGION

Windows‏ (cmd.exe)

gcloud database-migration objects list --migration-job=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': 'db1', 'type': 'DATABASE'}  RUNNING  FULL_DUMP
{'database': 'db2', 'type': 'DATABASE'}  STOPPED  CDC        {'code': 1, 'message': 'Internal error'}
כדי לבדוק אם הפעולה הצליחה, אפשר לשלוח שאילתה לאובייקט הפעולה שהוחזר, או לבדוק את הסטטוס של משימת ההעברה: