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

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

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

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

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

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

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

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

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

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

המסוף

  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 המלא הראשוני, אתם יכולים להפעיל אותה מחדש מההתחלה.

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

  • ‫Restart all databases: מחיקת כל הנתונים מכל מסדי הנתונים שמועברים באשכול היעד, והתחלת העברה מלאה חדשה שלהם. אם משימת ההעברה מוגדרת להעביר את כל מסדי הנתונים, ונוצרו מסדי נתונים חדשים בשרת המקור של PostgreSQL מאז שההעברה התחילה, הפעלה מחדש של משימת ההעברה גם משכפלת את מסדי הנתונים החדשים האלה לאשכול היעד.
  • ‫Restart failed databases: מחיקת כל הנתונים רק ממסדי הנתונים ביעד שבהם היו שגיאות, והתחלת העברה מלאה חדשה שלהם. מסדי נתונים אחרים באשכול היעד לא מושפעים.

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

המסוף

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

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

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

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

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

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

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

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

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

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

gcloud

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

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

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

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

  • אופציונלי: כברירת מחדל, הפעלה מחדש של משימת העברה מפעילה מחדש את כל מסדי הנתונים שנכללים במשימת ההעברה. אם רוצים להפעיל מחדש רק את מסדי הנתונים שנכשלו בלי להשפיע על מסדי נתונים אחרים שמועברים, מוסיפים את הדגל --restart-failed-objects.

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

‫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 \
update 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 `
update 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 ^
update 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 מפסיק את תהליך הרפליקציה במסד הנתונים הזה, אבל לא מסיר אותו מאשכול היעד של AlloyDB ל-PostgreSQL.

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

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

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

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

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

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

במשימות העברה שהן לא טיוטה, אתם יכולים להשתמש ב-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 \
  --no-async \
  --region=REGION \
  --display-name=MIGRATION_JOB_NAME

‏Windows (PowerShell)

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

Windows‏ (cmd.exe)

gcloud database-migration migration-jobs ^
update MIGRATION_JOB_ID ^
  --no-async ^
  --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 כדי לראות פרטים על מסד נתונים ספציפי במשימת ההעברה:

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

  • ‫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: projects/PROJECT_ID/locations/REGION/migrationJobs/MIGRATION_JOB_ID/objects/OBJECT_ID
phase: FULL_DUMP
sourceObject:
  database: DATABASE_NAME
  type: DATABASE
state: RUNNING

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

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

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

  • ‫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

תוצאה

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

SOURCE_OBJECT                            STATE    PHASE      ERROR
{'database': 'db1', 'type': 'DATABASE'}  RUNNING  FULL_DUMP
{'database': 'db2', 'type': 'DATABASE'}  STOPPED  CDC        {'code': 1, 'message': 'Internal error'}