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

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

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

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

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

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

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

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

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

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

התוצאה של הפעלה מחדש של עבודת העברה תלויה בסיבה לכישלון:

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

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

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

    עוברים אל 'משימות העברה'

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

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

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

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

המסוף

אפשר להתחיל משימת מיגרציה ממסוף Database Migration Service או מדף יעד המכונה.

ממסוף Database Migration Service:

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

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

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

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

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

ממופע היעד:

  1. נכנסים לדף Cloud SQL Instances במסוף Google Cloud .

    כניסה לדף Cloud SQL Instances

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

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

  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

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

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

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

המסוף

אפשר להפסיק את עבודת ההעברה במסוף של Database Migration Service או בדף של מופע היעד.

ממסוף Database Migration Service:

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

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

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

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

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

ממופע היעד:

  1. נכנסים לדף Cloud SQL Instances במסוף Google Cloud .

    כניסה לדף Cloud SQL Instances

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

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

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

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

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

המסוף

אפשר להמשיך את עבודת ההעברה ממסוף Database Migration Service או מדף מופע היעד.

ממסוף Database Migration Service:

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

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

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

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

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

ממופע היעד:

  1. נכנסים לדף Cloud SQL Instances במסוף Google Cloud .

    כניסה לדף Cloud SQL Instances

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

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

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

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

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

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

המסוף

אפשר להפעיל מחדש משימת העברה ממסוף Database Migration Service או מדף יעד המופע.

ממסוף Database Migration Service:

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

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

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

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

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

ממופע היעד:

  1. נכנסים לדף Cloud SQL Instances במסוף Google Cloud .

    כניסה לדף Cloud SQL Instances

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

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

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

gcloud

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

  • ‫MIGRATION_JOB_ID מחליפים במזהה של עבודת ההעברה.

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

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

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

‫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. בכרטיסייה טיוטות, לוחצים על השם המוצג של משימת ההעברה שרוצים לסיים ליצור.

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

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

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

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

הוספה או הסרה של אובייקטים מההעברה

כדי להוסיף או להסיר טבלאות או סכימות מההעברה:

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

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

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

  3. בקטע Select objects to migrate (בחירת אובייקטים להעברה), מסמנים או מבטלים את הסימון של תיבות הסימון כדי לשנות את הטבלאות והסכימות במקור ש-Database Migration Service יעביר ליעד.

  4. לוחצים על שמירה או על שמירה והפעלה מחדש.

    • אם לוחצים על שמירה, Database Migration Service יעביר רק נתונים היסטוריים של הסכימות והטבלאות שבוחרים.

    • אם לוחצים על שמירה והפעלה מחדש, Database Migration Service יתחיל את ההעברה מההתחלה, אחרי ניקוי של כל הטבלאות שבוחרים ביעד.

שינוי המספר המקסימלי של חיבורים בו-זמניים למסד הנתונים של המקור

אתם יכולים להתאים אישית את מספר החיבורים המקסימלי בו-זמנית ש-Database Migration Service יכול ליצור למופע המקור במהלך השלב של יצירת עותק מלא או השלב של CDC.

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

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

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

  3. מרחיבים את הקטע Customize source configuration (התאמה אישית של הגדרות המקור) > Source read settings (הגדרות קריאת המקור).

  4. בקטעים Maximum concurrent full dump connections או Maximum concurrent CDC connections, משתמשים בשדה Custom כדי להזין את מגבלת החיבורים המקסימלית לשלבי הגיבוי המלא או ה-CDC.

  5. לוחצים על שמירה או על שמירה והפעלה מחדש.

שינוי הגדרות של הגדרת היעד

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

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

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

  2. לוחצים על השם לתצוגה של עבודת ההעברה שרוצים לשנות.

    יופיע דף סקירה כללית של עבודת המיגרציה.

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

    ערך ברירת המחדל: 128

    ערכים מותרים: מינימום 2, מקסימום 256

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

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

    הזמן הקצוב לתפוגה של טרנזקציה

    ערך ברירת המחדל: 30

    ערכים מותרים: מינימום 30, מקסימום 300

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

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

  4. לוחצים על שמירה או על שמירה והפעלה מחדש.

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

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

ניהול טבלאות ספציפיות

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

הצגת כל הטבלאות בעבודה

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

המסוף

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

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

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

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

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

gcloud

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

  • ‫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: {'schema': 'Schema1', 'table': 'MyTable1', 'type': 'TABLE'}
STATE: RUNNING
PHASE: CDC
ERROR: {}

SOURCE_OBJECT: {'schema': 'Production', 'table': 'MyTable2', 'type': 'TABLE'}
STATE: RUNNING
PHASE: FULL_DUMP
ERROR:
  { 'code': 2,
    'details': [
        { '@type': 'type.googleapis.com/google.rpc.ErrorInfo',
          'domain': 'datamigration.googleapis.com',
          'metadata': {
            'errorMessage': '[DATABASE] error trying to write processed rows.
              Line: 2619 Position: 0 Schema: production Table: mytable2',
            'errorScope': 'NON_GLOBAL',
            'objectId': 'Production_MyTable2',
            'projectName': 'PROJECT_ID',
            'resourceName': 'MIGRATION_JOB_ID',
            'severity': 'ERROR'
          },
          'reason': 'DESTINATION_WRITE_ERROR'
        }
      ],
    'message': 'Encountered errors with your migration job table. Check the `details`
                  array for specific information on each issue.'
  }

הצגת פרטים של טבלה אחת

כדי לראות את פרטי ההעברה של טבלה אחת:

המסוף

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

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

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

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

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

    תיפתח חלונית צדדית עם פרטי הטבלה.

gcloud

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

  • ‫MIGRATION_JOB_ID מחליפים במזהה של עבודת ההעברה.

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

  • ‫REGION עם המזהה של האזור שבו נשמרת משימת ההעברה.
  • ‫SCHEMA_NAME בשם של סכימת האב שמכילה את הטבלה.
  • TABLE_NAME בשם הטבלה.

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

‫Linux,‏ macOS או Cloud Shell

gcloud database-migration objects lookup \
  --migration-job=MIGRATION_JOB_ID \
  --region=REGION \
  --schema=SCHEMA_NAME \
  --table=TABLE_NAME

‏Windows (PowerShell)

gcloud database-migration objects lookup `
  --migration-job=MIGRATION_JOB_ID `
  --region=REGION `
  --schema=SCHEMA_NAME `
  --table=TABLE_NAME

Windows‏ (cmd.exe)

gcloud database-migration objects lookup ^
  --migration-job=MIGRATION_JOB_ID ^
  --region=REGION ^
  --schema=SCHEMA_NAME ^
  --table=TABLE_NAME

תוצאה

הפקודה הזו מחזירה את המצב, השלב, זמן היצירה ופרטי השגיאה של הטבלה. התשובה כולה היא מחרוזת מרובת שורות בפורמט YAML. לדוגמה: 

createTime: '2025-06-02T10:20:29.792832Z'
error:
  code: 2
  details:
  - '@type': type.googleapis.com/google.rpc.ErrorInfo
    domain: datamigration.googleapis.com
    metadata:
      errorMessage: '[DATABASE] error trying to write processed rows.
              Line: 2619 Position: 0 Schema: production Table: mytable2'
      errorScope: NON_GLOBAL
      objectId: Production_MyTable2
      projectName: PROJECT_ID
      resourceName: MIGRATION_JOB_ID
      severity: ERROR
    reason: DESTINATION_WRITE_ERROR
  message: Encountered errors with your migration job table. Check the `details` array
    for specific information on each issue.
name: projects/PROJECT_ID/locations/REGION/migrationJobs/MIGRATION_JOB_ID/objects/TABLE_UUID
phase: FULL_DUMP
sourceObject:
  schema: Production
  table: MyTable2
  type: TABLE
state: RUNNING