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

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

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

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

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

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

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

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

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

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

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

המסוף

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

במסוף Database Migration Service:

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

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

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

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

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

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

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

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

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

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

ממכונת היעד:

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

    לדף Cloud SQL Instances

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

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

  3. בקטע העברה, לוחצים על הפעלה מחדש.
  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 במזהה בפורמט קריא למכונה של פרופיל החיבור של היעד.
  • הגדרת גיבוי דיפרנציאלי: אתם יכולים להגדיר אם משימת ההעברה יכולה להשתמש בקובצי גיבוי דיפרנציאליים מהקטגוריה של Cloud Storage. מוסיפים לפקודה את אחד מהדגלים הבאים:
    • --sqlserver-diff-backup כדי להפעיל קובצי גיבוי דיפרנציאליים להעברה
    • ‫--no-sqlserver-diff-backup כדי להשבית קובצי גיבוי דיפרנציאליים בהעברה

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

  • ‫COMMA_SEPARATED_DATABASE_ID_LIST ברשימה מופרדת בפסיקים של מזהי מסדי הנתונים של SQL Server שרוצים להעביר מקובצי הגיבוי.

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

‫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 \
  --sqlserver-databases=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 `
  --sqlserver-databases=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 ^
  --sqlserver-databases=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]

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

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

אחרי שקובצי הגיבוי הנדרשים נמצאים בקטגוריה של Cloud Storage, מבצעים את הפעולות הבאות:

המסוף

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

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

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

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

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

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

    • לוחצים על Edit details לצד מסד הנתונים שבחרתם להעביר.

      החלונית הצדדית הצפנה נפתחת.

    • בתפריטים של Encryption key, בוחרים את המפתחות.
    • בשדה Password, מזינים את הסיסמה של מפתח ההצפנה.
    • לוחצים על שמירה ויציאה.

gcloud

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

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

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

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

  • ‫REGION במזהה האזור שבו נשמר פרופיל החיבור.
  • ‫COMMA_SEPARATED_DATABASE_ID_LIST ברשימה מופרדת בפסיקים של מזהי מסדי הנתונים של SQL Server שרוצים להעביר מקובצי הגיבוי. המזהים האלה צריכים להיות זהים לשמות התיקיות של מסד הנתונים ב-Cloud Storage.

    לדוגמה: --sqlserver-databases=my-business-database,my-other-database

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

‫Linux,‏ macOS או Cloud Shell

gcloud database-migration migration-jobs \
update MIGRATION_JOB_ID \
  --region=REGION \
  --sqlserver-databases=COMMA_SEPARATED_DATABASE_ID_LIST

‏Windows (PowerShell)

gcloud database-migration migration-jobs `
update MIGRATION_JOB_ID `
  --region=REGION `
  --sqlserver-databases=COMMA_SEPARATED_DATABASE_ID_LIST

Windows‏ (cmd.exe)

gcloud database-migration migration-jobs ^
update MIGRATION_JOB_ID ^
  --region=REGION ^
  --sqlserver-databases=COMMA_SEPARATED_DATABASE_ID_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'}
כדי לבדוק אם הפעולה הצליחה, אפשר לשלוח שאילתה לאובייקט הפעולה שהוחזר, או לבדוק את הסטטוס של משימת ההעברה: