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

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

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

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

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

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

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

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

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

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

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

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

המסוף

  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

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

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

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

המסוף

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

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

כדי להמשיך משימת העברה שנעצרה:

המסוף

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

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

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

המסוף

  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

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

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

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

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

אתם יכולים להוסיף מסדי נתונים למשימת העברה או להסיר אותם ממנה במסוף Google Cloud או באמצעות Google Cloud CLI, בתנאי שמשימת ההעברה לא נמצאת במצב Running:

  • משימת ההעברה צריכה להיות במצב Not started,‏ Stopped או Failed. אם משימת ההעברה נמצאת במצב Running, צריך לעצור את משימת ההעברה לפני שאפשר לערוך את בחירת מסד הנתונים.
  • חשוב: אם מוסיפים או מסירים מסדי נתונים במשימת העברה שכבר התחילה, Database Migration Service מאפס את התקדמות ההעברה לשלב ה-dump המלא. כל מסדי הנתונים שנבחרו למשימת ההעברה (כולל מסדי נתונים שכבר הועברו) נמחקים במכונה של Cloud SQL ביעד, ונוצר להם קובץ dump חדש מהמכונה במקור.
  • כשמסירים מסד נתונים ממשימת העברה, השירות Database Migration Service מפסיק לשכפל את השינויים במסד הנתונים הזה, אבל לא מוחק את הנתונים שכבר הועברו ממסד הנתונים הזה למכונה ביעד.

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

המסוף

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

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

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

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

  3. אם הסטטוס של משימת ההעברה הוא Running, לוחצים על Stop, מאשרים בתיבת הדו-שיח ומחכים שהסטטוס ישתנה ל-Stopped.
  4. לוחצים על Edit.
  5. בקטע Select objects to migrate, משתמשים בתפריט Databases to migrate כדי לבחור בין All databases לבין Specific databases. אם בוחרים באפשרות Specific databases, משתמשים בתיבות הסימון כדי לבחור את מסדי הנתונים שרוצים להוסיף או לבטל את הסימון של אלה שרוצים להסיר.
  6. לוחצים על Save and restart (או על Save and start אם המשימה עדיין לא התחילה) כדי להחיל את השינויים ולהריץ את משימת ההעברה, או לוחצים על Save.

gcloud

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

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

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

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

  • REGION במזהה של האזור שבו נשמרת משימת ההעברה.
  • DATABASE_LIST ברשימה מופרדת בפסיקים של כל שמות מסדי הנתונים שרוצים להעביר באמצעות משימת ההעברה (לדוגמה, my-db-1,my-db-2). כדי להחזיר את משימת ההעברה להעברת כל מסדי הנתונים במכונה של המקור, מחליפים את --databases-filter=DATABASE_LIST ב---all-databases.

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

‫Linux,‏ macOS או Cloud Shell

gcloud database-migration migration-jobs \
update MIGRATION_JOB_ID \
  --region=REGION \
  --databases-filter=DATABASE_LIST

‏Windows (PowerShell)

gcloud database-migration migration-jobs `
update MIGRATION_JOB_ID `
  --region=REGION `
  --databases-filter=DATABASE_LIST

Windows‏ (cmd.exe)

gcloud database-migration migration-jobs ^
update MIGRATION_JOB_ID ^
  --region=REGION ^
  --databases-filter=DATABASE_LIST

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

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]

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

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