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

‫MySQL   |  PostgreSQL   |  PostgreSQL ל-AlloyDB

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

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

לפני שמתחילים

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

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

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

   להעברות מ-MySQL 8.0 ל-8.4: כשיוצרים את מכונת היעד, צריך לוודא שהגדרתם את הדגל local_infile לערך ON.

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

הגדרת הגדרות לעבודת ההעברה

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

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

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

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

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

3. בדף תחילת העבודה, מזינים את הפרטים הבאים:
   1. שם משימת ההעברה

      זהו שם קריא לבני אדם של עבודת ההעברה. הערך הזה מוצג במסוף Google Cloud .

   2. מזהה משימת ההעברה

      זהו מזהה שניתן לקריאה על ידי מכונה של משימת ההעברה. משתמשים בערך הזה כדי לעבוד עם משימות העברה באמצעות פקודות או API של Google Cloud CLI של Database Migration Service.

   3. ברשימה המנוע של מסד הנתונים של המקור, בוחרים באפשרות MySQL.

      השדה Destination database engine (המנוע של מסד הנתונים של היעד) מאוכלס באופן אוטומטי ואי אפשר לשנות אותו.

   4. בוחרים את האזור שבו שומרים את משימת ההעברה.

      Database Migration Service הוא מוצר אזורי לחלוטין, כלומר כל הישויות שקשורות למיגרציה (פרופילים של חיבור למקור וליעד, משימות מיגרציה, מסדי נתונים של היעד) צריכות להישמר באזור יחיד. בוחרים את האזור בהתאם למיקום של השירותים שזקוקים לנתונים שלכם, כמו מכונות וירטואליות של Compute Engine או אפליקציות של App Engine, ושירותים אחרים. אחרי שתבחרו את אזור היעד, לא תוכלו לשנות את הבחירה הזו.

      חשוב: אם אתם מתכננים להשתמש במהדורת Cloud SQL ל-MySQL Enterprise Plus, ודאו שהאזור שלכם נתמך במהדורה הזו. אפשר לעיין ב רשימת האזורים שנתמכים במהדורת Enterprise Plus של Cloud SQL ל-MySQL.
4. לוחצים על שמירה והמשך.

ציון מידע על פרופיל החיבור למקור

בדף Define a source, מבצעים את השלבים הבאים:

1. בתפריט הנפתח פרופיל חיבור למקור, בוחרים את פרופיל החיבור למסד הנתונים של המקור.
2. בקטע התאמה אישית של הגדרת הגיבוי המלא, לוחצים על עריכת ההגדרה.
3. בחלונית Edit full dump configuration, בתפריט הנפתח Full dump method, בוחרים באחת מהאפשרויות הבאות:
   • מבוסס על פיזיקה: בוחרים באפשרות הזו אם רוצים להשתמש בכלי Percona XtraBackup כדי לספק קובץ גיבוי משלכם. הגישה הזו דורשת שלבי הכנה נוספים. מדריך מלא לשימוש בקובצי גיבוי פיזיים שנוצרו על ידי Percona XtraBackup זמין במאמר העברת מסדי נתונים באמצעות קובץ פיזי של Percona XtraBackup.
   • מבוסס על לוגיקה: בוחרים באפשרות הזו אם רוצים להשתמש בקובץ גיבוי לוגי שנוצר על ידי כלי השירות mysqldump. Database Migration Service יכול ליצור בשבילכם באופן אוטומטי את קובץ הגיבוי הזה, או שאתם יכולים לספק עותק משלכם.
4. עורכים את שאר ההגדרות של ה-dump. מבצעים אחת מהפעולות הבאות:
   • אם משתמשים בקובץ הגיבוי הפיזי, בקטע Provide your folder לוחצים על Browse, ואז בוחרים את התיקייה שאליה העליתם את קובץ ה-dump המלא. מקפידים לבחור את התיקייה הייעודית שמכילה את קובץ הגיבוי המלא, ולא את מאגר האחסון עצמו.

   • אם אתם משתמשים בקובץ גיבוי לוגי, אתם צריכים להגדיר את המקביליות של dump הנתונים או את דגלי ה-dump.

     הרחבת הקטע הזה כדי לראות את השלבים המלאים של קובץ הגיבוי הלוגי

     בקטע Choose how to generate your dump file, בוחרים באחת מהאפשרויות הבאות:

     1. יצירה אוטומטית (מומלץ)

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

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

        אם משתמשים בקובץ ה-dump שנוצר אוטומטית, בוחרים את סוג הפעולה ש-Database Migration Service צריך לבצע בקטע Configure data dump operation (הגדרת פעולת יצירת קובץ dump של נתונים):

        • מקביליות של גיבוי נתונים: אפשר להשתמש באפשרות מקביליות עם ביצועים גבוהים, שזמינה כשמבצעים העברה לגרסאות MySQL 5.7 או 8.
          אם בוחרים להשתמש בהעברת נתונים מקבילית, צריך לוודא שסיפקתם את ההרשאות הנדרשות במסד הנתונים של המקור לתרחיש שלכם (למשל LOCK_TABLES). מידע נוסף על ההרשאות הנדרשות למסדי נתונים של מקורות זמין במאמר הגדרת מסד נתונים של מקור.

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

          • אופטימלי (מומלץ): ביצועים מאוזנים עם עומס אופטימלי על מסד הנתונים של המקור.
          • מקסימלית: מספקת את מהירויות ההעברה הגבוהות ביותר, אבל עלולה לגרום לעומס מוגבר על מסד הנתונים של המקור.
          • מינימלי: משתמש בכמות הכי נמוכה של משאבי מחשוב במסד הנתונים של המקור, אבל יכול להיות שקצב העברת הנתונים יהיה איטי יותר.
        • Dump flags: האפשרות הזו בלעדית ל-Data dump parallelism. ההגדרה הזו מאפשרת להגדיר ישירות את הדגלים של כלי השירות mysqldump שמשמש ליצירת קובץ ה-dump.

          כדי להוסיף דגל:

          1. לוחצים על הוספת סימון.

          2. בוחרים באחד מהדגלים הבאים:

             • ‫add-locks: כל טבלה שנכללת בקובץ ה-dump מוקפת בתגי LOCK TABLES ו-UNLOCK TABLES. כך ההוספות מהירות יותר כשקובץ ה-dump נטען למופע היעד.
             • ignore-error: משתמשים בדגל הזה כדי להזין רשימה של מספרי שגיאות שמופרדים בפסיקים. המספרים האלה מייצגים את השגיאות שכלי השירות mysqldump יתעלם מהן.
             • max-allowed-packet: משתמשים בדגל הזה כדי להגדיר את הגודל המקסימלי של המאגר (buffer) לתקשורת בין לקוח MySQL לבין מסד הנתונים של MySQL כמקור. גודל ברירת המחדל של מאגר הנתונים הזמני הוא 24MB, והגודל המקסימלי הוא 1GB.
               אם משתמשים בעמודות גדולות של BLOB או במחרוזות ארוכות בטבלאות של מסד הנתונים של המקור, צריך להגדיל את גודל המאגר של הדגל הזה.
             מידע נוסף על הדגלים האלה זמין במאמר בנושא כלי השירות mysqldump במדריך למשתמש של MySQL 8.0.
          3. לוחצים על סיום.
          4. חוזרים על השלבים האלה לכל דגל שרוצים להוסיף.

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

     2. הוספת הצעה משלך

        לא מומלץ להשתמש באפשרות הזו, כי כברירת מחדל, Database Migration Service מבצע dump ראשוני כחלק מהרצת משימת ההעברה.

        אם רוצים להשתמש בקובץ dump משלכם, בוחרים באפשרות Provide your own (אספקת קובץ משלכם), לוחצים על BROWSE (עיון), בוחרים את הקובץ (או את תיקיית Cloud Storage כולה אם משתמשים בכמה קבצים) ואז לוחצים על SELECT (בחירה).

        חשוב לוודא שהקובץ נוצר ב-24 השעות האחרונות ועומד בדרישות לגבי קובץ ה-dump.

5. לוחצים על שמירה והמשך.

בחירת מופע היעד ב-Cloud SQL

1. בתפריט Type of destination instance, בוחרים באפשרות Existing instance.
2. בקטע Select destination instance, בוחרים את מכונת היעד.

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

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

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

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

בתפריט הנפתח Connectivity method (שיטת קישוריות), בוחרים שיטת קישוריות לרשת. בשיטה הזו מוגדר איך מכונת Cloud SQL החדשה תתחבר למסד הנתונים של המקור. השיטות הקיימות לקישוריות בין רשתות כוללות רשימת היתרים של IP, מנהרת SSH הפוכה, ממשקי Private Service Connect וקישור בין רשתות VPC שכנות.

אם רוצים להשתמש ב...	ואז...
שיטת הקישוריות לרשת של רשימת היתרים לכתובות IP,	צריך לציין את כתובת ה-IP היוצאת של מופע היעד. אם מכונת Cloud SQL שיצרתם היא מכונה עם זמינות גבוהה, צריך לכלול את כתובות ה-IP היוצאות של המכונה הראשית ושל המכונה המשנית.
שיטת הקישוריות לרשת של מנהרת SSH הפוכה,	צריך לבחור את מכונת ה-VM של Compute Engine שתארח את המנהרה. אחרי שמציינים את המופע, Google מספקת סקריפט שמבצע את השלבים להגדרת המנהרה בין מסדי הנתונים של המקור והיעד. צריך להריץ את הסקריפט ב-Google Cloud CLI. מריצים את הפקודות ממכונה שיש לה קישוריות גם למסד הנתונים של המקור וגם ל- Google Cloud.
שיטת הקישוריות של ממשקי Private Service Connect,	Database Migration Service יוצר אוטומטית את החיבורים הנדרשים. שיטת הקישוריות הזו זמינה רק אם יש לכם מופע עם Private Service Connect מופעל וקובץ מצורף עם הרשת. מידע נוסף על ממשקי Private Service Connect זמין במאמר חיבורים יוצאים של Private Service Connect במסמכי Cloud SQL.
שיטת הקישור בין רשתות VPC שכנות (peering)	צריך לבחור את רשת ה-VPC שבה נמצא מסד הנתונים של המקור. המופע של Cloud SQL יעודכן כדי להתחבר לרשת הזו.

אחרי שבוחרים ומגדירים את קישוריות הרשת, לוחצים על הגדרה והמשך.

הגדרת מסדי נתונים להעברה

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

1. ברשימה Databases to migrate (מסדי נתונים להעברה), בוחרים באחת מהאפשרויות הבאות:
   • כל מסדי הנתונים: בחירה של כל מסדי הנתונים שקיימים במקור.
   • מסדי נתונים ספציפיים: מאפשרת לבחור מסדי נתונים ספציפיים מכל מסדי הנתונים שקיימים במקור.

2. אם רוצים להעביר מסדי נתונים ספציפיים, אפשר לסנן את הרשימה שמופיעה ולבחור את מסדי הנתונים שרוצים ש-Database Migration Service יעביר ליעד.

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

3. לוחצים על שמירה והמשך.

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

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

1. בדף Test and create migration job (בדיקה ויצירה של משימת העברה), לוחצים על Test job (בדיקת המשימה).

   אם הבדיקה נכשלת, אפשר לטפל בבעיה בחלק המתאים בתהליך ולחזור לבדיקה חוזרת. מידע על פתרון בעיות בבדיקה של משימת העברה שנכשלה זמין במאמר אבחון בעיות ב-MySQL.

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

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

   ההעברה מתבצעת עכשיו. כשמתחילים את עבודת ההעברה, שירות העברת מסדי נתונים מתחיל את הגיבוי המלא, ונועל את מסד הנתונים של המקור לזמן קצר. אם המקור שלכם נמצא ב-Amazon RDS או ב-Amazon Aurora, Database Migration Service דורש בנוסף השבתה קצרה (בערך פחות מדקה) של פעולות כתיבה בתחילת ההעברה. מידע נוסף זמין במאמר בנושא מגבלות ידועות.

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

יצירת משימת מיגרציה באמצעות Google Cloud CLI

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

יצירת פרופיל של חיבור ליעד

כדי ליצור את פרופיל החיבור של היעד עבור מופע היעד הקיים, מריצים את הפקודה gcloud database-migration connection-profiles create:

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

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

• CONNECTION_PROFILE_ID עם מזהה שניתן לקריאה על ידי מכונה של פרופיל החיבור.
• ‫REGION עם המזהה של האזור שבו רוצים לשמור את פרופיל החיבור.
• ‫DESTINATION_INSTANCE_ID במזהה המכונה של מכונת היעד.
• (אופציונלי) CONNECTION_PROFILE_NAME עם שם שקל לקרוא של פרופיל הקישור. הערך הזה מוצג במסוף Google Cloud .

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

‫Linux,‏ macOS או Cloud Shell

הערה: חשוב לוודא שהפעלתם את Google Cloud CLI עם אימות ופרויקט באמצעות אחת מהפקודות הבאות: gcloud init; או gcloud auth login ו- gcloud config set project.

gcloud database-migration connection-profiles \
create mysql CONNECTION_PROFILE_ID \
  --no-async \
  --cloudsql-instance=DESTINATION_INSTANCE_ID \
  --region=REGION \
  --display-name=CONNECTION_PROFILE_NAME

‏Windows (PowerShell)

הערה: חשוב לוודא שהפעלתם את Google Cloud CLI עם אימות ופרויקט באמצעות אחת מהפקודות הבאות: gcloud init; או gcloud auth login ו- gcloud config set project.

gcloud database-migration connection-profiles `
create mysql CONNECTION_PROFILE_ID `
  --no-async `
  --cloudsql-instance=DESTINATION_INSTANCE_ID `
  --region=REGION `
  --display-name=CONNECTION_PROFILE_NAME

Windows‏ (cmd.exe)

הערה: חשוב לוודא שהפעלתם את Google Cloud CLI עם אימות ופרויקט באמצעות אחת מהפקודות הבאות: gcloud init; או gcloud auth login ו- gcloud config set project.

gcloud database-migration connection-profiles ^
create mysql CONNECTION_PROFILE_ID ^
  --no-async ^
  --cloudsql-instance=DESTINATION_INSTANCE_ID ^
  --region=REGION ^
  --display-name=CONNECTION_PROFILE_NAME

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

Waiting for connection profile [CONNECTION_PROFILE_ID]
to be created with [OPERATION_ID]

Waiting for operation [OPERATION_ID] to complete...done.

Created connection profile CONNECTION_PROFILE_ID [OPERATION_ID]

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

הערה: הדוגמאות הבאות מייצגות תרחיש העברה שבו משתמשים בקישוריות של כתובת IP פרטית בין מסד הנתונים של המקור לבין מסד הנתונים של היעד. אם אתם משתמשים בסוג אחר של קישוריות (לדוגמה, VPC peering או מנהרת SSH הפוכה), הקפידו להוסיף את הדגלים הנדרשים, כמו --peer-vpc או --vm, --vm-ip, --vm-port, --vpc. מידע נוסף זמין במאמרים הגדרת קישוריות ודוגמאות ל-Google Cloud CLI.

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

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

• ‫MIGRATION_JOB_ID מחליפים במזהה שניתן לקריאה על ידי מכונה של משימת ההעברה. משתמשים בערך הזה כדי לעבוד עם משימות העברה באמצעות פקודות Google Cloud CLI או API של Database Migration Service.
• ‫REGION עם מזהה האזור שבו רוצים לשמור את עבודת ההעברה.
• ‫MIGRATION_JOB_NAME עם שם קריא של עבודת המיגרציה. הערך הזה מוצג ב-Database Migration Service במסוף Google Cloud .
• SOURCE_CONNECTION_PROFILE_ID עם מזהה קריא למכונה של פרופיל חיבור המקור.
• ‫DESTINATION_CONNECTION_PROFILE_ID עם מזהה קריא על ידי מכונה של פרופיל חיבור היעד.

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

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

  אפשר לערוך בהמשך משימות העברה שיצרתם באמצעות --database-filter flag באמצעות הפקודה gcloud database-migration migration-jobs update.

• ‫MIGRATION_JOB_TYPE בסוג של עבודת ההעברה. הערכים המותרים הם ONE_TIME או CONTINUOUS. מידע נוסף זמין במאמר סוגי העברה.

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

‫Linux,‏ macOS או Cloud Shell

הערה: חשוב לוודא שהפעלתם את Google Cloud CLI עם אימות ופרויקט באמצעות אחת מהפקודות הבאות: gcloud init; או gcloud auth login ו- gcloud config set project.

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 \
  --type=MIGRATION_JOB_TYPE \

‏Windows (PowerShell)

הערה: חשוב לוודא שהפעלתם את Google Cloud CLI עם אימות ופרויקט באמצעות אחת מהפקודות הבאות: gcloud init; או gcloud auth login ו- gcloud config set project.

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 `
  --type=MIGRATION_JOB_TYPE `

Windows‏ (cmd.exe)

הערה: חשוב לוודא שהפעלתם את Google Cloud CLI עם אימות ופרויקט באמצעות אחת מהפקודות הבאות: gcloud init; או gcloud auth login ו- gcloud config set project.

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 ^
  --type=MIGRATION_JOB_TYPE ^

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

Waiting for migration job [MIGRATION_JOB_ID]
to be created with [OPERATION_ID]

Waiting for operation [OPERATION_ID] to complete...done.

Created migration job MIGRATION_JOB_ID [OPERATION_ID]

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

כדי להשתמש בשירות להעברת מסדי נתונים, צריך לוודא שמופע מסד הנתונים של היעד פועל כעותק לקריאה בזמן ההעברה. לפני שמתחילים את משימת ההעברה, מריצים את הפקודה gcloud database-migration migration-jobs demote-destination כדי להוריד את רמת ההרשאות של מופע מסד הנתונים של היעד.

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

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

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

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

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

‫Linux,‏ macOS או Cloud Shell

הערה: חשוב לוודא שהפעלתם את Google Cloud CLI עם אימות ופרויקט באמצעות אחת מהפקודות הבאות: gcloud init; או gcloud auth login ו- gcloud config set project.

gcloud database-migration migration-jobs \
demote-destination MIGRATION_JOB_ID \
  --region=REGION

‏Windows (PowerShell)

הערה: חשוב לוודא שהפעלתם את Google Cloud CLI עם אימות ופרויקט באמצעות אחת מהפקודות הבאות: gcloud init; או gcloud auth login ו- gcloud config set project.

gcloud database-migration migration-jobs `
demote-destination MIGRATION_JOB_ID `
  --region=REGION

Windows‏ (cmd.exe)

הערה: חשוב לוודא שהפעלתם את Google Cloud CLI עם אימות ופרויקט באמצעות אחת מהפקודות הבאות: gcloud init; או gcloud auth login ו- gcloud config set project.

gcloud database-migration migration-jobs ^
demote-destination 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: demote-destination
name: OPERATION_ID

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

• משתמשים בפקודה gcloud database-migration migration-jobs describe כדי לראות את הסטטוס של משימת ההעברה.
• אפשר להשתמש בשיטה gcloud database-migration operations describe עם OPERATION_ID כדי לראות את הסטטוס של הפעולה עצמה.

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

בשלב הזה, משימת ההעברה מוגדרת ומחוברת למופע של מסד הנתונים של היעד. אפשר לנהל אותו באמצעות הפעולות verify,‏ start,‏ stop,‏ restart ו-resume.

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

מומלץ קודם לוודא שהעברת הנתונים תקינה על ידי הפעלת הפקודה gcloud database-migration migration-jobs verify.

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

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

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

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

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

‫Linux,‏ macOS או Cloud Shell

הערה: חשוב לוודא שהפעלתם את Google Cloud CLI עם אימות ופרויקט באמצעות אחת מהפקודות הבאות: gcloud init; או gcloud auth login ו- gcloud config set project.

gcloud database-migration migration-jobs \
verify MIGRATION_JOB_ID \
  --region=REGION

‏Windows (PowerShell)

הערה: חשוב לוודא שהפעלתם את Google Cloud CLI עם אימות ופרויקט באמצעות אחת מהפקודות הבאות: gcloud init; או gcloud auth login ו- gcloud config set project.

gcloud database-migration migration-jobs `
verify MIGRATION_JOB_ID `
  --region=REGION

Windows‏ (cmd.exe)

הערה: חשוב לוודא שהפעלתם את Google Cloud CLI עם אימות ופרויקט באמצעות אחת מהפקודות הבאות: gcloud init; או gcloud auth login ו- gcloud config set project.

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

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

• משתמשים בפקודה gcloud database-migration migration-jobs describe עם הדגל MIGRATION_JOB_ID כדי לראות את הסטטוס של משימת המיגרציה.
• משתמשים בפקודה gcloud database-migration operations describe עם הדגל OPERATION_ID כדי לראות את הסטטוס של הפעולה עצמה.

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

מריצים את הפקודה gcloud database-migration migration-jobs start כדי להתחיל את עבודת ההעברה.

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

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

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

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

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

‫Linux,‏ macOS או Cloud Shell

הערה: חשוב לוודא שהפעלתם את Google Cloud CLI עם אימות ופרויקט באמצעות אחת מהפקודות הבאות: gcloud init; או gcloud auth login ו- gcloud config set project.

gcloud database-migration migration-jobs \
start MIGRATION_JOB_ID \
  --region=REGION

‏Windows (PowerShell)

הערה: חשוב לוודא שהפעלתם את Google Cloud CLI עם אימות ופרויקט באמצעות אחת מהפקודות הבאות: gcloud init; או gcloud auth login ו- gcloud config set project.

gcloud database-migration migration-jobs `
start MIGRATION_JOB_ID `
  --region=REGION

Windows‏ (cmd.exe)

הערה: חשוב לוודא שהפעלתם את Google Cloud CLI עם אימות ופרויקט באמצעות אחת מהפקודות הבאות: gcloud init; או gcloud auth login ו- gcloud config set project.

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

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

• משתמשים בפקודה gcloud database-migration migration-jobs describe עם הדגל MIGRATION_JOB_ID כדי לראות את הסטטוס של משימת המיגרציה.
• משתמשים בפקודה gcloud database-migration operations describe עם הדגל OPERATION_ID כדי לראות את הסטטוס של הפעולה עצמה.

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

אחרי שההעברה מגיעה לשלב של לכידת שינויי נתונים (CDC), אפשר להפוך את מופע מסד הנתונים של היעד ממופע לקריאה בלבד למופע עצמאי. מריצים את הפקודה gcloud database-migration migration-jobs promote:

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

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

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

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

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

‫Linux,‏ macOS או Cloud Shell

הערה: חשוב לוודא שהפעלתם את Google Cloud CLI עם אימות ופרויקט באמצעות אחת מהפקודות הבאות: gcloud init; או gcloud auth login ו- gcloud config set project.

gcloud database-migration migration-jobs \
promote MIGRATION_JOB_ID \
  --region=REGION

‏Windows (PowerShell)

הערה: חשוב לוודא שהפעלתם את Google Cloud CLI עם אימות ופרויקט באמצעות אחת מהפקודות הבאות: gcloud init; או gcloud auth login ו- gcloud config set project.

gcloud database-migration migration-jobs `
promote MIGRATION_JOB_ID `
  --region=REGION

Windows‏ (cmd.exe)

הערה: חשוב לוודא שהפעלתם את Google Cloud CLI עם אימות ופרויקט באמצעות אחת מהפקודות הבאות: gcloud init; או gcloud auth login ו- gcloud config set project.

gcloud database-migration migration-jobs ^
promote 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

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

• משתמשים בפקודה gcloud database-migration migration-jobs describe עם הדגל MIGRATION_JOB_ID כדי לראות את הסטטוס של משימת המיגרציה.
• משתמשים בפקודה gcloud database-migration operations describe עם הדגל OPERATION_ID כדי לראות את הסטטוס של הפעולה עצמה.