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

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

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

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

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

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

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

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

המסוף

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

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

    מעבר אל Migration jobs

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

      1. יצירה אוטומטית של קובץ ה-dump הראשוני (מומלץ)

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

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

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

        • העברה מקבילה של נתונים: אפשרות להעברה מקבילה של נתונים בביצועים גבוהים, שזמינה כשעוברים לגרסאות 5.7 או 8 של MySQL.

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

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

          כדי להוסיף סימון:

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

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

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

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

      2. הצעת חוק משלך

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

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

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

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

הגדרה ויצירה של מכונת היעד ב-Cloud SQL

  1. בדף הגדרת יעד, בתפריט הנפתח סוג היעד מופע, בוחרים באפשרות מופע חדש. מגדירים את כל ההגדרות הרלוונטיות:
    1. בשדה Destination Instance ID, מזינים מזהה למכונה של Cloud SQL או משתמשים במזהה שנוצר אוטומטית.

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

    2. בשדה Password, מזינים סיסמה אלפאנומרית למכונה של Cloud SQL ביעד. זו הסיסמה לחשבון האדמין root במכונה.

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

    3. בתפריט הנפתח Database version (גרסת מסד הנתונים), בוחרים את גרסת מסד הנתונים של מופע היעד.

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

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

      מהדורות Cloud SQL ל-MySQL כוללות קבוצות שונות של תכונות, סוגים של מכונות זמינות ותמחור. חשוב לעיין במסמכי התיעוד של Cloud SQL כדי לבחור את המהדורה שמתאימה לצרכים שלכם. מידע נוסף זמין במאמר מבוא למהדורות של Cloud SQL ל-MySQL.

    5. בתפריט Region מוצג אותו אזור שבחרתם בדף Get started.

      אם אתם מגדירים את המופע לזמינות גבוהה, בוחרים באפשרות Multiple zones (Highly available). אפשר לבחור גם את האזור הראשי וגם את האזור המשני. התנאים הבאים חלים כשמשתמשים באזור המשני במהלך יצירת המכונה:

      • כברירת מחדל, האזורים מוגדרים לAny (כל אזור) עבור האזור הראשי, ולAny (different from primary) (כל אזור ששונה מהאזור הראשי) עבור האזור המשני.
      • אם מציינים גם את האזור הראשי וגם את האזור המשני, הם צריכים להיות אזורים שונים.
    6. בקטע Connections, בוחרים אם להוסיף כתובת IP ציבורית או פרטית למכונה של היעד. אפשר להגדיר את המופע כך שיכלול את שני סוגי כתובות ה-IP, אבל נדרש לפחות סוג אחד לצורך ההעברה. בוחרים אחת מהאפשרויות הבאות:
      • אם רוצים להעביר באמצעות קישור בין רשתות VPC שכנות (peering) או מנהרת SSH הפוכה, בוחרים באפשרות Private IP.

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

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

          • ‫Service Networking API מופעל. אפשר להפעיל את Service Networking API באמצעות מסוף Google Cloud .
          • יש לכם את הרשאת ה-IAM‏ servicenetworking.services.addPeering.
          • הגדרתם גישה לשירותים פרטיים בפרויקט, ולשם כך אתם צריכים את תפקיד ה-IAM‏ compute.networkAdmin.
          • יש לפחות רשת VPC אחת שאינה מדור קודם בפרויקט, או רשת VPC משותפת.
          • אם אתם משתמשים ברשת VPC משותפת, אתם צריכים גם לבצע את הפעולות הבאות:
            • מפעילים את Service Networking API בפרויקט המארח.
            • מוסיפים את המשתמש לפרויקט המארח.
            • נותנים למשתמש את compute.networkAdmin תפקיד ה-IAM בפרויקט המארח.
        • בוחרים את רשת ה-VPC המשויכת כדי ליצור קישור בין רשתות שכנות (peering). אם אתם מתכננים להתחבר למקור ההעברה באמצעות VPC Peering, צריך לבחור את ה-VPC שבו נמצא המופע.
        • אם אף פעם לא הוגדרה רשת של שירות מנוהל עבור ה-VPC שנבחר, אפשר לבחור טווח כתובות IP וללחוץ על Connect (קישור), או להשתמש בטווח כתובות IP שנבחר באופן אוטומטי וללחוץ על Allocate & Connect (הקצאה וקישור).
      • אם רוצים לבצע מיגרציה דרך האינטרנט באמצעות רשימת היתרים של כתובות IP, בוחרים באפשרות Public IP.

        אופציונלי: בקטע כתובת IP ציבורית, לוחצים על השדה רשתות מורשות ומאשרים רשת או שרת proxy להתחבר למכונת Cloud SQL. הרשתות מורשות רק עם הכתובות שסיפקת. מידע נוסף על הגדרת כתובת IP ציבורית בתיעוד של Cloud SQL.

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

  2. בוחרים את סוג המכונה של Cloud SQL. גודל הדיסק צריך להיות שווה לגודל של מסד הנתונים במקור או גדול ממנו. MySQL
  3. ב-Cloud SQL ל-MySQL מהדורת Enterprise Plus: מסמנים את התיבה Enable data cache אם רוצים להשתמש בתכונת מטמון הנתונים במסד הנתונים של היעד.

    מטמון נתונים הוא תכונה אופציונלית שזמינה במופעים של Cloud SQL ל-MySQL במהדורת Enterprise Plus. התכונה מוסיפה כונן מקומי מהיר מסוג SSD למסד הנתונים של היעד. השימוש בתכונה הזו עשוי להוביל לעלויות נוספות ב-Cloud SQL. מידע נוסף על מטמון נתונים זמין במאמר סקירה כללית על מטמון נתונים במאמרי העזרה של Cloud SQL.

  4. מציינים את סוג האחסון של מכונת Cloud SQL. אתם יכולים לבחור כונן SSD או כונן קשיח (HDD).
  5. מציינים את נפח האחסון (ב-GB) של המכונה ב-Cloud SQL.

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

  6. (אופציונלי) מגדירים אפשרויות להצפנת נתונים או תוויות של משאבים עבור יעד המיגרציה.

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

    לוחצים על Show optional configurations, ואז:

    1. מציינים אם רוצים לנהל את ההצפנה של הנתונים שמועברים מהמקור ליעד. כברירת מחדל, הנתונים מוצפנים באמצעות מפתח שמנוהל על ידי Google Cloud. אם אתם רוצים לנהל את ההצפנה, אתם יכולים להשתמש במפתח הצפנה בניהול הלקוח (CMEK). כדי לעשות את זה:

      1. מסמנים את התיבה Use a customer-managed encryption key (CMEK).
      2. בתפריט Select a customer-managed key (בחירת מפתח בניהול הלקוח), בוחרים את מפתח ה-CMEK.

      אם המפתח לא מופיע, לוחצים על Enter key resource name (הזנת שם משאב של מפתח) כדי לספק את שם המשאב של המפתח שרוצים להשתמש בו. שם לדוגמה של משאב מפתח: projects/my-project-name/locations/my-location/keyRings/my-keyring/cryptoKeys/my-key.

    2. מוסיפים את כל הדגלים שצריך להחיל על שרת מסד הנתונים. אם אפשר, מוודאים שדגלים לניהול מסד נתונים במכונת היעד של Cloud SQL זהים לאלה של מסד הנתונים המקורי. MySQL
    3. מוסיפים תוויות שספציפיות למכונה של Cloud SQL.

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

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

בתפריט הנפתח Connectivity method, בוחרים שיטת קישוריות לרשת. בשיטה הזו מוגדר איך מכונת Cloud SQL החדשה תתחבר למסד הנתונים של המקור. השיטות הקיימות לחיבור רשת לצורך העברה למופע חדש כוללות: רשימת כתובות IP שאפשר לגשת אליהן, מנהרת SSH הפוכה, קישור בין רשתות VPC שכנות וקישור בין רשתות VPC שכנות שמתאים רק למקורות Cloud SQL ל-MySQL.

אם רוצים להשתמש ב...ואז...
שיטת החיבור לרשת באמצעות רשימת היתרים של כתובות IP, צריך לציין את כתובת ה-IP היוצאת של מכונת היעד. אם מכונת Cloud SQL שיצרתם היא מכונה עם זמינות גבוהה, צריך לכלול את כתובות ה-IP היוצאות של המכונה הראשית ושל המכונה המשנית.
שיטת הקישוריות לרשת של מנהרת SSH הפוכה, צריך לבחור את המכונה הווירטואלית (VM) של Compute Engine שתארח את המנהרה.

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

מריצים את הפקודות ממכונה שמחוברת גם למסד הנתונים של המקור וגם ל- Google Cloud.
שיטת הקישוריות לרשת של קישור בין רשתות 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. כשהבדיקה של משימת ההעברה מסתיימת, לוחצים על Create and start job כדי ליצור את משימת ההעברה ולהתחיל אותה מיד, או על Create job כדי ליצור את משימת ההעברה בלי להתחיל אותה מיד.

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

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

  3. עוברים לקטע בדיקת משימת ההעברה.

gcloud

  1. יוצרים את פרופיל החיבור של היעד.
    כשמעבירים למכונה חדשה של יעד באמצעות Google Cloud CLI, יוצרים את מכונת היעד ואת פרופיל החיבור בפעולה אחת.
    מריצים את הפקודה הבאה (לוחצים על הקישור כדי להרחיב):

    gcloud database-migration connection-profiles create cloudsql

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

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

    • CONNECTION_PROFILE_ID עם מזהה בפורמט קריא למכונה עבור פרופיל החיבור שלך.
    • DATABASE_VERSION בגרסת MySQL שבה רוצים להשתמש במכונה של היעד. גרסאות של מסד נתונים מצוינות כמחרוזות שכוללות גם את הגרסה הראשית וגם את הגרסה המשנית. לדוגמה: MYSQL_8_0, MYSQL_8_0_32, MYSQL_8_0_36.

      לרשימה של כל הגרסאות האפשריות של MySQL, עיינו ב מאמרי העזרה בנושא הדגל database-version--.

    • (אופציונלי) EDITION כברירת מחדל, מכונות חדשות שיוצרים באמצעות Google Cloud CLI משתמשות במהדורת Cloud SQL ל-MySQL Enterprise Plus. אם אתם מתכננים להשתמש במהדורת Enterprise Plus של Cloud SQL ל-MySQL, ודאו שהאזור שלכם נתמך במהדורה הזו. מידע נוסף זמין במאמר בנושא תמיכה באזורים במהדורת Cloud SQL ל-MySQL Enterprise Plus.

      כדי לשנות את המהדורה, אפשר להשתמש בדגל --edition עם אחד מהערכים הבאים:

      • ‫enterprise-plus למהדורת Cloud SQL ל-MySQL Enterprise Plus
      • ‫enterprise למהדורת Cloud SQL ל-MySQL Enterprise
    • ‫TIER בשם של סוג המכונה ב-Cloud SQL שרוצים להשתמש בו. סוגי המכונות מצוינים כמחרוזות בהתאם למוסכמות של Cloud SQL, לדוגמה db-n1-standard-1, ‏ db-perf-optimized-N-2. במאמר סוגי מכונות שבמסמכי התיעוד של Cloud SQL ל-MySQL מופיעה רשימה מלאה של סוגי המכונות הזמינים והמזהים שלהם לשימוש עם Google Cloud CLI.

      כברירת מחדל, מכונות שנוצרות באמצעות Google Cloud CLI משתמשות במהדורת Cloud SQL ל-MySQL Enterprise Plus, שבה יש סוגי מכונות שונים. אם רוצים להשתמש בסוג מכונה שזמין רק במהדורת Enterprise של Cloud SQL ל-MySQL, צריך להשתמש בדגל האופציונלי --edition=enterprise כדי לציין את המהדורה.

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

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

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

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

      אם רוצים להשתמש בקישוריות של כתובות IP ציבוריות, לא צריך להשתמש בדגלים נוספים. אם אתם רוצים להשתמש בקישוריות של כתובת IP פרטית עם קישור בין רשתות VPC שכנות (peering) או מנהרת SSH הפוכה, ודאו שאתם עומדים בדרישות הרשת הנוספות הבאות להפעלת קישוריות של כתובת IP פרטית, וכללו דגלים נוספים בפקודה.

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

      אם רוצים להשתמש בקישור דרך IP פרטי (עם קישור בין רשתות VPC שכנות או עם מנהרת SSH הפוכה במכונה וירטואלית של Compute Engine), צריך לכלול את הדגלים הנוספים הבאים:

      • --no-enable-ip-v4: (אופציונלי) כדי לא להקצות כתובת IP ציבורית למופע היעד. יכול להיות שיוקצו לכם כתובת IP ציבורית וכתובת IP פרטית למכונת היעד, אבל אם אתם משתמשים בקישוריות של כתובות IP פרטיות, יכול להיות שלא תרצו כתובת IP ציבורית.
      • --private-network: כדי להקצות כתובת IP פרטית למכונה של היעד, מציינים את השם של הענן הפרטי הווירטואלי (VPC) שבו רוצים להקצות כתובת IP פרטית.

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

    ‫Linux,‏ macOS או Cloud Shell

    gcloud database-migration connection-profiles \
create mysql CONNECTION_PROFILE_ID \
  --no-async \
  --region=REGION \
  --database-version=DATABASE_VERSION \
  --tier=TIER \
  --display-name=CONNECTION_PROFILE_NAME

    ‏Windows (PowerShell)

    gcloud database-migration connection-profiles `
create mysql CONNECTION_PROFILE_ID `
  --no-async `
  --region=REGION `
  --database-version=DATABASE_VERSION `
  --tier=TIER `
  --display-name=CONNECTION_PROFILE_NAME

    Windows‏ (cmd.exe)

    gcloud database-migration connection-profiles ^
create mysql CONNECTION_PROFILE_ID ^
  --no-async ^
  --region=REGION ^
  --database-version=DATABASE_VERSION ^
  --tier=TIER ^
  --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]

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

    gcloud database-migration migration-jobs create

    בדוגמה הזו נעשה שימוש בדגל האופציונלי --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

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

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

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

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

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