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

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

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

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

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

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

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

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

המשך כשממשיכים משימת העברה, השירות Database Migration Service ממשיך את פעולות העברת הנתונים:
  • בהעברות רציפות שהופסקו במהלך שלב ה-CDC, השירות Database Migration Service ממשיך את השכפול של אירועי השינוי שהצטברו כשהמשימה הופסקה.
  • במשימות העברה שהופסקו במהלך שלב ה-dump המלא (העברה חד-פעמית או רציפה), 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. בכרטיסייה Jobs, לוחצים על השם המוצג של משימת ההעברה שרוצים להתחיל.

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

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

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

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

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

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

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

המסוף

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

במסוף Database Migration Service:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

אתם יכולים להתאים אישית את המספר המקסימלי של חיבורים בו-זמניים ש-Database Migration Service יכול ליצור למכונה של המקור בשלב ה-dump המלא או בשלב ה-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 כדי להזין את מגבלת החיבורים המקסימלית לשלבי ה-dump המלא או ה-CDC.

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

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

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

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

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

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

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

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

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

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

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

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

    הזמן הקצוב לתפוגת העסקה

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

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

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

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

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

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

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

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

  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