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

‫MySQL   |  PostgreSQL   |  PostgreSQL ל-AlloyDB

תצוגה מקדימה

השימוש בתכונה הזו כפוף לתנאי השימוש במוצרים בגרסת טרום-GA, שמפורטים בחלק "תנאי שירות הכלליים" בתנאים הספציפיים של השירות. השימוש בתכונות בגרסת טרום-GA הוא "כפי שהן" (As is), ויכול להיות שהתמיכה בהן תהיה מוגבלת. מידע נוסף זמין בקטע תיאור שלבי ההשקה.

בדף הזה מוסבר איך לבצע העברות מהירות של PostgreSQL הומוגני אל Cloud SQL ל-PostgreSQL.

סקירה כללית

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

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

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

• מעבר ממקורות עם כתובת IP פרטית ברשת של הענן הווירטואלי הפרטי (VPC) Google Cloudשלכם, כמו מסדי נתונים בניהול עצמי ב-Compute Engine או מופעים של Cloud SQL ל-PostgreSQL שמופעלת בהם רשת פרטית.

  יכול להיות שיהיה צורך ברכיבי רשת נוספים (כמו חיבור Cloud VPN) כדי להגיע למקורות שמארחים מחוץ ל- Google Cloud בכתובת IP פרטית ברשת ה-VPC.

• השיטה היחידה שנתמכת לקישוריות למסד נתונים היא ממשקי Private Service Connect עם הגדרות קישוריות פרטיות של Database Migration Service. צריך להקצות לנתוני מסד הנתונים כתובת IP פרטית ברשת VPC. שיטות אחרות לחיבור למקור הומוגני (כמו רשימות היתרים של כתובות IP ציבוריות, מנהרות SSH הפוכות או VPC peering) לא נתמכות בהעברות מהירות.

מידע נוסף על העברות מהירות זמין במאמר סקירה כללית של העברות מהירות במסמכי התיעוד העיקריים של Database Migration Service.

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

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

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Roles required to select or create a project

   • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
   • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.
   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Verify that billing is enabled for your Google Cloud project.

4. מפעילים את ממשקי ה-API של Database Migration Service,‏ Compute Engine,‏ Network Connectivity Center ו-Cloud SQL Admin.

   הפעלת ממשקי ה-API

התפקידים הנדרשים

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

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

תפקידים והרשאות בפרויקט המקור

מקצים לחשבונות ספציפיים את התפקידים הבאים ב Google Cloud פרויקט שבו נמצא מסד הנתונים של המקור:

• לחשבון המשתמש שמבצע את ההעברה: התפקיד 'אדמין של רשת מחשוב' (roles/compute.networkAdmin)
• עבור חשבון השירות של Database Migration Service בפרויקט היעד: צפייה ברשת Compute (roles/compute.networkViewer)

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

  service-DESTINATION_PROJECT_NUMBER@gcp-sa-datamigration.

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

ההרשאות הנדרשות (מקור)

כדי לבצע העברות מהירות והומוגניות באמצעות Database Migration Service, נדרשות ההרשאות הבאות:

עבור חשבון המשתמש שמבצע את ההעברה:

• compute.networks.*
• compute.subnetworks.*
• compute.networkAttachments.*

בחשבון השירות של Database Migration Service בפרויקט היעד: ‫compute.networkAttachments.get.

תפקידים והרשאות בפרויקט היעד

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

• אדמין של Database Migration Service (roles/datamigration.admin)
• ‫ Cloud SQL Admin ‏ (roles/cloudsql.admin)

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

ההרשאות הנדרשות (יעד)

כדי לבצע העברות מהירות והומוגניות באמצעות Database Migration Service, נדרשות ההרשאות הבאות:

• datamigration.*
• cloudsql.instances.create
• cloudsql.instances.delete
• cloudsql.instances.get
• cloudsql.instances.list
• cloudsql.instances.update
• cloudsql.instances.connect
• cloudsql.instances.executeSql
• cloudsql.instances.export
• cloudsql.instances.import
• cloudsql.instances.login
• cloudsql.operations.get
• cloudsql.users.get
• cloudsql.users.list
• cloudsql.users.create
• cloudsql.users.update
• cloudsql.users.delete

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

כדי להגדיר את מסד הנתונים של PostgreSQL כמקור:

1. יוצרים בחשבון משתמש ייעודי להעברה.
   • למקורות Cloud SQL ל-PostgreSQL, אפשר לעיין במאמר בנושא יצירת משתמש בתיעוד של Cloud SQL.
   • לגבי מקורות אחרים, אפשר לעיין במסמכי התיעוד של ספק מסד הנתונים או ליצור ולנהל משתמשים במסמכי התיעוד של PostgreSQL.
2. מקצים את ההרשאות הנדרשות לחשבון המשתמש הייעודי להעברה. מריצים את הפקודות הבאות לכל מסד נתונים שרוצים להעביר:

   -- Grant the REPLICATION attribute
   ALTER ROLE MIGRATION_USER REPLICATION;
   
   -- Grant database-level permissions.
   -- Repeat for each database you want to migrate.
   GRANT CONNECT, CREATE ON DATABASE DATABASE_NAME TO MIGRATION_USER;
   
   -- Grant schema-level usage.
   -- Repeat for each schema in each database you want to migrate.
   GRANT USAGE ON SCHEMA SCHEMA_NAME TO MIGRATION_USER;

   מחליפים את מה שכתוב בשדות הבאים:

   • ‫MIGRATION_USER עם השם של חשבון המשתמש להעברה.
   • ‫DATABASE_NAME בשם מסד הנתונים שרוצים להעביר.
   • ‫SCHEMA_NAME בשם הסכימה במסד הנתונים שרוצים להעביר.
3. למשתמש בחשבון ההעברה צריכה להיות גישת בעלות לטבלאות שאתם מעבירים. כדי לתת את רמת הגישה הזו, מבצעים אחת מהפעולות הבאות:
   • רק למקורות שאינם Cloud SQL ל-PostgreSQL: מקצים את SUPERUSER תפקיד PostgreSQL לחשבון ההעברה.
   • לכל המקורות: מוסיפים את חשבון המשתמש להעברה לקבוצת המשתמשים שבבעלותה הטבלאות. מריצים את הפקודה הבאה:

     -- Grant table ownership.
     GRANT TABLE_OWNER_GROUP_NAME TO MIGRATION_USER;

     מחליפים את מה שכתוב בשדות הבאים:

     • ‫TABLE_OWNER_GROUP_NAME עם שם קבוצת המשתמשים שהיא הבעלים של כל טבלה שרוצים להעביר.
     • ‫MIGRATION_USER עם השם של חשבון המשתמש להעברה.
4. בטבלאות שאין להן מפתחות ראשיים: שירות Database Migration Service לא משכפל פעולות UPDATE או DELETE בטבלאות ללא מפתחות ראשיים במהלך השלב של סימון נתונים שהשתנו (CDC). אם רוצים לכלול פעולות כאלה בשכפול, צריך לשנות את הטבלאות בלי מפתחות ראשיים באמצעות REPLICA IDENTITY:

   ALTER TABLE TABLE_NAME REPLICA IDENTITY FULL;
   ALTER TABLE TABLE_NAME REPLICA IDENTITY USING INDEX INDEX_NAME;

   מחליפים את מה שכתוב בשדות הבאים:

   • ‫TABLE_NAME הוא שם הטבלה שלא מוגדרים בה מפתחות ראשיים.
   • ‫INDEX_NAME הוא האינדקס הייחודי שאפשר לעקוב אחרי שורות מטבלאות בלי מפתחות ראשיים.
5. מגדירים את הגדרות השכפול באמצעות דגלים של מסד הנתונים.

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

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

   1. מגדירים את הפרמטר wal_level לערך logical. מריצים את הפקודה הבאה:

      ALTER SYSTEM SET wal_level = 'logical';

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

      ALTER SYSTEM SET wal_sender_timeout = 0;
          

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

      לדוגמה, אם מעבירים 5 מסדי נתונים ונוצרו 2 משימות העברה עבור מופע המקור, מספר משבצות השכפול צריך להיות לפחות 5 * 2 = 10, ועוד מספר משבצות השכפול שכבר נמצאות בשימוש.

      כדי להגדיר את הפרמטר הזה, מריצים את הפקודה הבאה:

      ‫

      ALTER SYSTEM SET max_replication_slots = NUMBER_OF_SLOTS;
          

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

      לדוגמה, אם הפרמטר max_replication_slots מוגדר לערך 10, ואתם כבר משתמשים בשני שולחים, מספר התהליכים של WAL sender שפועלים בו-זמנית יהיה 10 + 2 = 12.

      כדי להגדיר את הפרמטר הזה, מריצים את הפקודה הבאה:

      ‫

      ALTER SYSTEM SET max_wal_senders = NUMBER_OF_SENDERS;
          

      כאשר NUMBER_OF_SENDERS מייצג את מספר התהליכים של WAL sender שפועלים בו-זמנית.
   5. מגדירים את הערך של max_worker_processes למספר של לפחות מספר מסדי הנתונים שרוצים להעביר, ועוד מספר max_worker_processes שכבר נמצא בשימוש במופע. כדי להגדיר את הפרמטר הזה, מריצים את הפקודה הבאה:

      ALTER SYSTEM SET max_worker_processes = NUMBER_OF_PROCESSES;
          

      כאשר NUMBER_OF_PROCESSES מייצג את מספר מסדי הנתונים שיועברו.

   מקורות Cloud SQL ל-PostgreSQL

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

   1. מגדירים את הדגל cloudsql.logical_decoding לערך on.
   2. מגדירים את הפרמטר wal_sender_timeout לערך 0. הערך הזה משבית את מנגנון פסק הזמן שמשמש לסיום חיבורי שכפול לא פעילים.
   3. מגדירים את המספר המקסימלי של משבצות השכפול באמצעות הפרמטר max_replication_slots. הפרמטר הזה צריך להיות מוגדר לפחות כמספר מסדי הנתונים שמעבירים בכל משימת העברה, בתוספת כמה עתודות לסינכרון טבלאות.

      לדוגמה, אם מעבירים 5 מסדי נתונים ונוצרו 2 משימות העברה עבור מופע המקור, מספר משבצות השכפול צריך להיות לפחות 5 * 2 = 10, ועוד מספר משבצות השכפול שכבר נמצאות בשימוש.

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

      לדוגמה, אם הפרמטר max_replication_slots מוגדר לערך 10, ואתם כבר משתמשים ב-2 שולחים, מספר התהליכים של WAL sender שפועלים בו-זמנית יהיה 10 + 2 = 12.

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

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

המסוף

כדי ליצור ולהריץ העברה מהירה באמצעות Google Cloud המסוף:

1. נכנסים לדף Get started במסוף Google Cloud .

   לדף 'איך מתחילים'

2. בתפריט מנוע המקור, בוחרים באפשרות PostgreSQL.
3. בתפריט מנוע היעד, בוחרים באפשרות CloudSQL for PostgreSQL.

   מופיע הקטע הצגת העברה מהירה של PostgreSQL.

4. בקטע היכרות עם העברה מהירה של PostgreSQL, לוחצים על התחלת ההעברה.

   הדף Migrate to Cloud SQL for PostgreSQL (מעבר ל-Cloud SQL ל-PostgreSQL) ייפתח.

5. בקטע Configure migration (הגדרת ההעברה), מבצעים את הפעולות הבאות:
   1. בתפריט אזור היעד, בוחרים את האזור של מופע היעד ב-Cloud SQL.
   2. בתיבה Migration prefix (קידומת להעברה), מזינים מחרוזת שנוחה לקריאה על ידי בני אדם, שתתווסף לשמות של כל ישויות ההעברה שנוצרו להעברה מהירה: פרופילי חיבור, הגדרת קישוריות פרטית, רשת מצורפת ורשת המשנה שלה ועבודת ההעברה.
   3. בתפריט סוג ההגדרה, בוחרים באחת מהאפשרויות הבאות:
      1. הגדרת קישוריות קיימת: בוחרים באפשרות הזו אם כבר יש לכם קובץ מצורף עם הרשת והגדרת קישוריות פרטית שמשתמשת בשיטת הממשקים של Private Service Connect. האפשרות הזו מתאימה במיוחד אם השתמשתם בעבר בהעברות מהירות ואתם רוצים להשתמש מחדש באותם משאבי רשת.
      2. הגדרת קישוריות חדשה: בוחרים באפשרות הזו כדי ליצור קובץ מצורף חדש לרשת ואת רשת המשנה של הקובץ המצורף לרשת ברשת ה-VPC של מסד הנתונים של המקור. ההגדרה של הקישוריות הפרטית תיצור באותו פרויקט כמו מופע היעד.
   4. לוחצים על Continue.
6. בקטע Connect source (חיבור המקור), מבצעים את הפעולות הבאות:
   1. מזינים שם מארח או כתובת IP פרטית של מסד הנתונים של המקור. צריכה להיות אפשרות להגיע לכתובת של מסד הנתונים של המקור מרשת ה-VPC של המקור.
   2. מזינים את היציאה שמשמשת לגישה למארח. יציאת ברירת המחדל של PostgreSQL היא 5432.
   3. מזינים את שם המשתמש והסיסמה של חשבון ההעברה הייעודי במסד הנתונים של המקור.
   4. בתפריט סוג ההצפנה, בוחרים אחת מהאפשרויות הבאות:
      • ללא: אם מסד הנתונים של המקור לא דורש חיבורים מוצפנים באמצעות SSL/TLS.
      • חובה: אם מסד הנתונים של המקור דורש חיבורים מוצפנים באמצעות SSL/TLS. באפשרות הזאת לא נדרש אימות של אישורים.
   5. בתפריט Databases to migrate (מסדי נתונים להעברה), לוחצים על Customize (התאמה אישית). משתמשים בחלונית הצדדית כדי לבחור רק את מסדי הנתונים שרוצים להעביר ל-Cloud SQL.
   6. לוחצים על Continue.
7. בקטע Configure destination (הגדרת יעד), אפשר ליצור מופע חדש של יעד או לבחור יעד קיים.

   מופעים חדשים

   כדי ליצור מופע חדש של יעד:

   1. בתפריט סוג היעד של המופע, בוחרים באפשרות מופע חדש.

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

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

   מכונות קיימות

   אפשר להעביר מסדי נתונים למופע שכבר קיים. מוודאים שהמכונה של היעד מופעלת עבור Private Service Connect ושלא נאכפים בה חיבורי mTLS. צריך לבצע את הפעולות הבאות:

   1. בתפריט סוג יעד של מופע, בוחרים באפשרות מופע קיים.
   2. בתפריט Existing instance ID (מזהה מופע קיים), בוחרים את מזהה המופע.
8. לוחצים על התחלת ההעברה.

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

gcloud

כדי ליצור ולהריץ העברה מהירה באמצעות ה-CLI של gcloud:

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

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

     gcloud compute network-attachments create

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

     • ‫NETWORK_ATTACHMENT בשם של מחבר הרשת שרוצים ליצור.
     • ‫REGION עם האזור של הרשת המצורפת.
     • ‫DEST_PROJECT_ID במזהה הפרויקט של פרויקט היעד.
     • ‫SOURCE_PROJECT_ID במזהה הפרויקט שבו נמצאת רשת המקור.

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

     ‫Linux,‏ macOS או Cloud Shell

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

     gcloud compute network-attachments create NETWORK_ATTACHMENT \
       --region=REGION \
       --connection-preference=ACCEPT_MANUAL \
       --producer-accept-list=DEST_PROJECT_ID \
       --subnets=default \
       --project=SOURCE_PROJECT_ID

     ‏Windows (PowerShell)

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

     gcloud compute network-attachments create NETWORK_ATTACHMENT `
       --region=REGION `
       --connection-preference=ACCEPT_MANUAL `
       --producer-accept-list=DEST_PROJECT_ID `
       --subnets=default `
       --project=SOURCE_PROJECT_ID

     Windows‏ (cmd.exe)

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

     gcloud compute network-attachments create NETWORK_ATTACHMENT ^
       --region=REGION ^
       --connection-preference=ACCEPT_MANUAL ^
       --producer-accept-list=DEST_PROJECT_ID ^
       --subnets=default ^
       --project=SOURCE_PROJECT_ID

   • אם רוצים לעשות שימוש חוזר בחיבור רשת קיים, עוברים לשלב הבא.

2. מאפשרים לפרויקט הדייר של Database Migration Service לגשת למחבר הרשת.
   החיבור לרשת צריך לאפשר חיבורים מפרויקט הדייר של Database Migration Service. כך עושים את זה:

   1. כדי לאחזר את מזהה פרויקט הדייר של Database Migration Service, מבצעים יצירה של חיבור פרטי בהרצה יבשה (לוחצים כדי להרחיב):

      gcloud database-migration private-connections create --validate-only

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

      • ‫PRIVATE_CONN בשם של משאב החיבור הפרטי.
      • ‫REGION עם האזור של החיבור הפרטי.
      • ‫NETWORK_ATTACHMENT_URI עם ה-URI של קובץ הרשת המצורף.

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

      ‫Linux,‏ macOS או Cloud Shell

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

      gcloud database-migration private-connections create PRIVATE_CONN \
        --region=REGION \
        --network-attachment=NETWORK_ATTACHMENT_URI \
        --display-name=PRIVATE_CONN \
        --format="value(metadata.metadata.tenant_project_id)" \
        --validate-only

      ‏Windows (PowerShell)

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

      gcloud database-migration private-connections create PRIVATE_CONN `
        --region=REGION `
        --network-attachment=NETWORK_ATTACHMENT_URI `
        --display-name=PRIVATE_CONN `
        --format="value(metadata.metadata.tenant_project_id)" `
        --validate-only

      Windows‏ (cmd.exe)

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

      gcloud database-migration private-connections create PRIVATE_CONN ^
        --region=REGION ^
        --network-attachment=NETWORK_ATTACHMENT_URI ^
        --display-name=PRIVATE_CONN ^
        --format="value(metadata.metadata.tenant_project_id)" ^
        --validate-only

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

   2. מתן הרשאה לפרויקט דייר (tenant) של Database Migration Service ולפרויקט היעד להתחבר למחבר הרשת (לוחצים כדי להרחיב):

      gcloud compute network-attachments update

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

      • ‫NETWORK_ATTACHMENT בשם הקובץ המצורף לרשת.
      • REGION עם האזור.
      • ‫DEST_PROJECT_ID במזהה הפרויקט של פרויקט היעד.
      • ‫DMS_TENANT_ID במזהה פרויקט הדייר של Database Migration Service שאוחזר.
      • ‫SOURCE_PROJECT_ID במזהה הפרויקט שבו נמצאת רשת המקור.

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

      ‫Linux,‏ macOS או Cloud Shell

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

      gcloud compute network-attachments update NETWORK_ATTACHMENT \
        --region=REGION \
        --producer-accept-list=DEST_PROJECT_ID,DMS_TENANT_ID \
        --project=SOURCE_PROJECT_ID

      ‏Windows (PowerShell)

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

      gcloud compute network-attachments update NETWORK_ATTACHMENT `
        --region=REGION `
        --producer-accept-list=DEST_PROJECT_ID,DMS_TENANT_ID `
        --project=SOURCE_PROJECT_ID

      Windows‏ (cmd.exe)

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

      gcloud compute network-attachments update NETWORK_ATTACHMENT ^
        --region=REGION ^
        --producer-accept-list=DEST_PROJECT_ID,DMS_TENANT_ID ^
        --project=SOURCE_PROJECT_ID

3. יוצרים את משאב הקישוריות הפרטית של Database Migration Service.
   מריצים את הפקודה הבאה (לוחצים להרחבה):

   gcloud database-migration private-connections create

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

   • ‫PRIVATE_CONN בשם של משאב החיבור הפרטי.
   • ‫REGION עם האזור של החיבור הפרטי.
   • ‫NETWORK_ATTACHMENT_URI עם ה-URI של קובץ הרשת המצורף.

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

   ‫Linux,‏ macOS או Cloud Shell

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

   gcloud database-migration private-connections create PRIVATE_CONN \
     --region=REGION \
     --network-attachment=NETWORK_ATTACHMENT_URI \
     --display-name=PRIVATE_CONN

   ‏Windows (PowerShell)

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

   gcloud database-migration private-connections create PRIVATE_CONN `
     --region=REGION `
     --network-attachment=NETWORK_ATTACHMENT_URI `
     --display-name=PRIVATE_CONN

   Windows‏ (cmd.exe)

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

   gcloud database-migration private-connections create PRIVATE_CONN ^
     --region=REGION ^
     --network-attachment=NETWORK_ATTACHMENT_URI ^
     --display-name=PRIVATE_CONN

4. יוצרים את פרופיל החיבור למקור.
   מריצים את הפקודה הבאה (לוחצים להרחבה):

   gcloud database-migration connection-profiles create postgresql

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

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

   • ‫SOURCE_CONN_ID עם מזהה פרופיל חיבור המקור.
   • ‫REGION באזור שבו רוצים לשמור את פרופיל החיבור.
   • ‫SOURCE_PRIVATE_IP עם כתובת ה-IP הפרטית של מסד הנתונים של המקור.
   • ‫SOURCE_PORT עם היציאה של מסד הנתונים של המקור (ברירת המחדל היא 5432).
   • ‫SOURCE_USER עם שם המשתמש של המשתמש להעברה במסד הנתונים של המקור.
   • ‫SOURCE_PASSWORD עם הסיסמה של המשתמש להעברה במסד הנתונים של המקור.
   • ‫PRIVATE_CONN עם השם של משאב החיבור הפרטי.

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

   ‫Linux,‏ macOS או Cloud Shell

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

   gcloud database-migration connection-profiles create postgresql \
     SOURCE_CONN_ID \
     --region=REGION \
     --role=SOURCE \
     --host=SOURCE_PRIVATE_IP \
     --port=SOURCE_PORT \
     --username=SOURCE_USER \
     --password=SOURCE_PASSWORD \
     --private-connection=PRIVATE_CONN \
     --no-async

   ‏Windows (PowerShell)

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

   gcloud database-migration connection-profiles create postgresql `
     SOURCE_CONN_ID `
     --region=REGION `
     --role=SOURCE `
     --host=SOURCE_PRIVATE_IP `
     --port=SOURCE_PORT `
     --username=SOURCE_USER `
     --password=SOURCE_PASSWORD `
     --private-connection=PRIVATE_CONN `
     --no-async

   Windows‏ (cmd.exe)

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

   gcloud database-migration connection-profiles create postgresql ^
     SOURCE_CONN_ID ^
     --region=REGION ^
     --role=SOURCE ^
     --host=SOURCE_PRIVATE_IP ^
     --port=SOURCE_PORT ^
     --username=SOURCE_USER ^
     --password=SOURCE_PASSWORD ^
     --private-connection=PRIVATE_CONN ^
     --no-async

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

   מופעים חדשים

   כדי להשתמש במופע יעד חדש להעברה מהירה, קודם צריך ליצור את המופע באמצעות Google Cloud CLI של Cloud SQL, ואז ליצור את פרופיל החיבור של היעד. איך לעשות את זה?

   1. יצירת מכונה באמצעות Cloud SQL Google Cloud CLI. חשוב להשתמש בדגל --enable-private-service-connect כדי להפעיל את Private Service Connect במכונת היעד. העברות מהירות תומכות רק במופעים שמופעל בהם Private Service Connect.
   2. יוצרים את פרופיל החיבור ליעד עבור המופע החדש. לפרטים מלאים על הפקודה, מרחיבים את הקטע הבא.

      gcloud database-migration connection-profiles create postgresql

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

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

      • ‫DEST_CONN_ID עם מזהה פרופיל החיבור ליעד.
      • ‫REGION עם האזור שבו רוצים לשמור את פרופיל החיבור. האזור הזה צריך להיות זהה לאזור של מכונת היעד.
      • ‫DEST_INSTANCE עם המזהה של מכונת היעד ב-Cloud SQL שנוצרה מראש.
      • ‫DEST_USER עם שם המשתמש של המשתמש להעברה במסד הנתונים של היעד.
      • ‫DEST_PASSWORD מחליפים בסיסמה של משתמש ההעברה במסד הנתונים של היעד.

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

      ‫Linux,‏ macOS או Cloud Shell

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

      gcloud database-migration connection-profiles create postgresql DEST_CONN_ID \
        --region=REGION \
        --cloudsql-instance=DEST_INSTANCE \
        --username=DEST_USER \
        --password=DEST_PASSWORD \
        --role=DESTINATION \
        --no-async

      ‏Windows (PowerShell)

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

      gcloud database-migration connection-profiles create postgresql DEST_CONN_ID `
        --region=REGION `
        --cloudsql-instance=DEST_INSTANCE `
        --username=DEST_USER `
        --password=DEST_PASSWORD `
        --role=DESTINATION `
        --no-async

      Windows‏ (cmd.exe)

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

      gcloud database-migration connection-profiles create postgresql DEST_CONN_ID ^
        --region=REGION ^
        --cloudsql-instance=DEST_INSTANCE ^
        --username=DEST_USER ^
        --password=DEST_PASSWORD ^
        --role=DESTINATION ^
        --no-async

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

      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]
      

   מכונות קיימות

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

   gcloud database-migration connection-profiles create postgresql

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

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

   • ‫DEST_CONN_ID עם מזהה פרופיל החיבור ליעד.
   • ‫REGION עם האזור שבו רוצים לשמור את פרופיל החיבור. האזור הזה צריך להיות זהה לאזור של מכונת היעד.
   • ‫DEST_INSTANCE עם המזהה של מכונת היעד ב-Cloud SQL שנוצרה מראש.
   • ‫DEST_USER עם שם המשתמש של המשתמש להעברה במסד הנתונים של היעד.
   • ‫DEST_PASSWORD מחליפים בסיסמה של משתמש ההעברה במסד הנתונים של היעד.

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

   ‫Linux,‏ macOS או Cloud Shell

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

   gcloud database-migration connection-profiles create postgresql DEST_CONN_ID \
     --region=REGION \
     --cloudsql-instance=DEST_INSTANCE \
     --username=DEST_USER \
     --password=DEST_PASSWORD \
     --role=DESTINATION \
     --no-async

   ‏Windows (PowerShell)

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

   gcloud database-migration connection-profiles create postgresql DEST_CONN_ID `
     --region=REGION `
     --cloudsql-instance=DEST_INSTANCE `
     --username=DEST_USER `
     --password=DEST_PASSWORD `
     --role=DESTINATION `
     --no-async

   Windows‏ (cmd.exe)

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

   gcloud database-migration connection-profiles create postgresql DEST_CONN_ID ^
     --region=REGION ^
     --cloudsql-instance=DEST_INSTANCE ^
     --username=DEST_USER ^
     --password=DEST_PASSWORD ^
     --role=DESTINATION ^
     --no-async

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

   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]
   

6. יוצרים את עבודת ההעברה.
   מריצים את הפקודה הבאה (לוחצים להרחבה):

   gcloud database-migration migration-jobs create

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

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

   • ‫MIGRATION_JOB_ID מחליפים במזהה של עבודת ההעברה.
   • ‫REGION עם האזור שבו רוצים לשמור את עבודת ההעברה.
   • ‫SOURCE_CONN_ID עם מזהה פרופיל חיבור המקור.
   • ‫DEST_CONN_ID עם מזהה פרופיל החיבור ליעד.
   • ‫DATABASES_LIST ברשימה מופרדת בפסיקים של מסדי הנתונים שרוצים להעביר.

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

   ‫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 \
     --region=REGION \
     --type=CONTINUOUS \
     --source=SOURCE_CONN_ID \
     --destination=DEST_CONN_ID \
     --use-postgres-native \
     --postgres-max-additional-subscriptions=10 \
     --databases-filter=DATABASES_LIST \
     --no-async

   ‏Windows (PowerShell)

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

   gcloud database-migration migration-jobs create `
     MIGRATION_JOB_ID `
     --region=REGION `
     --type=CONTINUOUS `
     --source=SOURCE_CONN_ID `
     --destination=DEST_CONN_ID `
     --use-postgres-native `
     --postgres-max-additional-subscriptions=10 `
     --databases-filter=DATABASES_LIST `
     --no-async

   Windows‏ (cmd.exe)

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

   gcloud database-migration migration-jobs create ^
     MIGRATION_JOB_ID ^
     --region=REGION ^
     --type=CONTINUOUS ^
     --source=SOURCE_CONN_ID ^
     --destination=DEST_CONN_ID ^
     --use-postgres-native ^
     --postgres-max-additional-subscriptions=10 ^
     --databases-filter=DATABASES_LIST ^
     --no-async

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

   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]
   

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

   gcloud database-migration migration-jobs start

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

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

   • ‫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 כדי לראות את הסטטוס של הפעולה עצמה.

סיום ההעברה

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

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

המאמרים הבאים

• מידע נוסף על Cloud SQL