יצירת עותקים לקריאה

המסוף

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

   כניסה לדף Cloud SQL Instances

2. מחפשים את המופע שרוצים ליצור לו העתק, ואז פותחים את התפריט more actions לצד כרטיס המוצר.
3. בוחרים באפשרות יצירת עותק לקריאה.

   אם האפשרות הזו לא מופיעה, סימן שהמופע הוא העתק. אי אפשר ליצור העתק של העתק.

4. אם במופע הופעלו גיבויים ורישום ביומן בינארי, ממשיכים לשלב הבא. אחרת, בוחרים באפשרות Automate backups (אוטומציה של גיבויים) וEnable binary logging (הפעלת רישום בינארי), לוחצים על Continue (המשך) ואז על Save and restart (שמירה והפעלה מחדש) כדי להפעיל מחדש את המופע.

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

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

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

   לדוגמה, כדי לאפשר לשירותים אחרים, כמו BigQuery, לגשת לנתונים ב-Cloud SQL ולשלוח שאילתות לגבי הנתונים האלה דרך חיבור פנימי, מרחיבים את הקבוצה Connections ומבטלים את הסימון בתיבת הסימון Public IP. Cloud de Confiance by S3NS

6. לוחצים על יצירת העתק.

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

gcloud

1. בודקים את הסטטוס של המופע הראשי:

   gcloud sql instances describe PRIMARY_INSTANCE_NAME
         

   אם המאפיין databaseReplicationEnabled הוא true, המופע הוא העתק, ואי אפשר ליצור העתק של העתק.

2. אם המאפיין enabled בקטע backupConfiguration הוא false, צריך להפעיל עכשיו גיבויים למופע הראשי:

   gcloud sql instances patch PRIMARY_INSTANCE_NAME \
   --backup-start-time=>HH:MM
         

   הפרמטר backup-start-time מצוין בפורמט של 24 שעות, באזור הזמן UTC±00, ומציין את ההתחלה של חלון גיבוי של 4 שעות. הגיבויים יכולים להתחיל בכל שלב במהלך חלון הגיבוי.
3. אם המאפיין binaryLogEnabled הוא false, מפעילים את יומני הבינארי במופע הראשי:

   gcloud sql instances patch PRIMARY_INSTANCE_NAME \
   --enable-bin-log

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

   gcloud sql instances create REPLICA_NAME \
   --master-instance-name=PRIMARY_INSTANCE_NAME

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

   אפשר לציין אזור אחר באמצעות הפרמטר --region.

   אפשר להוסיף עוד פרמטרים להגדרות אחרות של המופע. מידע נוסף זמין במאמר בנושא gcloud sql instances create.

   אם למופע הראשי יש רק כתובת IP פנימית, ואתם רוצים לאפשר לשירותים אחרים, כמו BigQuery, לגשת לנתונים ב-Cloud SQL ולבצע שאילתות על הנתונים האלה דרך חיבור פנימי, אתם צריכים להוסיף את הפרמטר --enable-google-private-path לפקודה. Cloud de Confiance by S3NS

   צריך ליצור את העותק המשוכפל באותה רשת VPC שבה נמצאת המכונה הראשית. אפשר גם לציין allocated-ip-range-name ברשת ה-VPC הזו. אם לא מציינים טווח, העותק המשוכפל נוצר בטווח אקראי.

• רישום בינארי נתמך במופעי העתקה לקריאה (MySQL 5.7 ואילך בלבד). לא נתמך בשכפול לגיבוי במעבר אוטומטי (failover) של HA מדור קודם). מפעילים רישום ביומן בינארי ברפליקה באמצעות אותה פקודה gcloud CLI, אבל משתמשים בשם המכונה של הרפליקה במקום בשם המכונה של השרת הראשי.

  gcloud sql instances patch REPLICA_INSTANCE_NAME \
  --enable-bin-log \
  --enforce-new-sql-network-architecture
      

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

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

  תקופת השמירה של קובץ ה-binlog במופעי העתקה מוגדרת אוטומטית ליום אחד, בניגוד לשבעה ימים במופעים ראשיים.

• משתמשים בדגל enforce-new-network-architecture כדי לאכוף את השימוש בארכיטקטורת הרשת החדשה עבור המכונה עם היצירה שלה, גם אם הפרויקט לא שודרג באופן מלא. פרטים נוספים על ארכיטקטורת הרשת החדשה וההשלכות שלה מופיעים במאמרים שדרוג מכונה לארכיטקטורת הרשת החדשה והקצאת טווח כתובות IP.

Terraform

כדי ליצור העתק לקריאה, משתמשים במשאב של Terraform.

resource "google_sql_database_instance" "read_replica" {
  name                 = "mysql-replica-instance-name"
  master_instance_name = google_sql_database_instance.primary.name
  region               = "europe-west4"
  database_version     = "MYSQL_8_0"

  replica_configuration {
    failover_target = false
  }

  settings {
    tier              = "db-n1-standard-2"
    availability_type = "ZONAL"
    disk_size         = "100"
  }
  # set `deletion_protection` to true, will ensure that one cannot accidentally delete this instance by
  # use of Terraform whereas `deletion_protection_enabled` flag protects this instance at the GCP level.
  deletion_protection = false
}

החלה של השינויים

כדי להחיל את הגדרות Terraform בפרויקט ב- Cloud de Confiance , מבצעים את השלבים בקטעים הבאים.

הכנת Cloud Shell

1. מפעילים את Cloud Shell.

2. מגדירים את פרויקט ברירת המחדל שבו רוצים להחיל את ההגדרות של Terraform. Cloud de Confiance

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

   export GOOGLE_CLOUD_PROJECT=PROJECT_ID

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

הכנת הספרייה

לכל קובץ תצורה של Terraform צריכה להיות ספרייה משלו (שנקראת גם מודול ברמה הבסיסית).

1. יוצרים ספרייה חדשה ב-Cloud Shell ובה יוצרים קובץ חדש. שם הקובץ חייב לכלול את הסיומת .tf, למשל main.tf. במדריך הזה, הקובץ נקרא main.tf.

   mkdir DIRECTORY && cd DIRECTORY && touch main.tf

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

   מעתיקים את הקוד לדוגמה בקובץ main.tf החדש שיצרתם.

   לחלופין, אפשר גם להעתיק את הקוד מ-GitHub. כדאי לעשות את זה כשקטע הקוד של Terraform הוא חלק מפתרון מקצה לקצה.

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

   terraform init

   אופציונלי: תוכלו לכלול את האפשרות -upgrade, כדי להשתמש בגרסה העדכנית ביותר של הספק של Google:

   terraform init -upgrade

החלה של השינויים

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

   terraform plan

   מתקנים את ההגדרות לפי הצורך.

2. מריצים את הפקודה הבאה ומזינים yes בהודעה שמופיעה, כדי להחיל את הגדרות Terraform:

   terraform apply

   ממתינים עד שב-Terraform תוצג ההודעה "Apply complete!‎".

3. פותחים את Cloud de Confiance הפרויקט כדי לראות את התוצאות. במסוף Cloud de Confiance , נכנסים למשאבים בממשק המשתמש כדי לוודא שהם נוצרו או עודכנו ב-Terraform.

מחיקת השינויים

כדי למחוק את השינויים:

1. כדי להשבית את ההגנה מפני מחיקה, מגדירים בקובץ התצורה של Terraform את הארגומנט deletion_protection לערך false.

   deletion_protection =  "false"

2. מריצים את הפקודה הבאה ומזינים yes בהודעה שמופיעה, כדי להחיל את הגדרות Terraform המעודכנות:

   terraform apply

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

   terraform destroy

REST v1

1. קבלת הגדרות הגיבוי הנוכחיות

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

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

   • ‫project-id: מזהה הפרויקט
   • ‫primary-instance-name: השם של המופע הראשי

   ה-method של ה-HTTP וכתובת ה-URL:

   GET https://sqladmin.googleapis.com/v1/projects/project-id/instances/primary-instance-name

   כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

   ‫Curl (Linux,‏ macOS או Cloud Shell)

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

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        "https://sqladmin.googleapis.com/v1/projects/project-id/instances/primary-instance-name"

   ‎PowerShell (Windows)

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

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri "https://sqladmin.googleapis.com/v1/projects/project-id/instances/primary-instance-name" | Select-Object -Expand Content

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

   תשובה

   "backupConfiguration": {
       "kind": "sql#backupConfiguration",
       "startTime": "12:00",
       "enabled": false,
       "binaryLogEnabled": false
   }
   

2. מוודאים שהשדות של השכפול מוגדרים

   אם הערך של enabled או pointInTimeEnabled הוא false, צריך להשתמש בשיטה patch של משאב המופעים כדי להפעיל את שניהם. בבקשה, מציינים את המאפיינים של הגדרת הגיבוי שרוצים לשנות.

   כדי להפעיל גיבויים, מגדירים את enabled ל-true ואת startTime לשעה ביום בפורמט HH:MM. הפרמטר startTime מצוין בפורמט של 24 שעות, באזור הזמן UTC±00, ומציין את ההתחלה של חלון גיבוי של 4 שעות. הגיבויים יכולים להתחיל בכל שלב במהלך חלון הגיבוי.

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

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

   • ‫PROJECT_ID: המזהה או מספר הפרויקט של פרויקט Cloud de Confiance שמכיל את המופע
   • ‫INSTANCE_NAME: השם של המופע הראשי או של העותק לקריאה שאתם מגדירים עבור זמינות גבוהה
   • ‫START_TIME: השעה (בדקות ושעות)

   ה-method של ה-HTTP וכתובת ה-URL:

   PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME

   תוכן בקשת JSON:

   {
     "settings":
     {
       "backupConfiguration":
       {
         "startTime": "START_TIME",
         "enabled": true,
         "binaryLogEnabled": true
       }
     }
   }
   

   כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

   ‫Curl (Linux,‏ macOS או Cloud Shell)

   שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

   curl -X PATCH \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "Content-Type: application/json; charset=utf-8" \
        -d @request.json \
        "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME"

   ‎PowerShell (Windows)

   שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method PATCH `
       -Headers $headers `
       -ContentType: "application/json; charset=utf-8" `
       -InFile request.json `
       -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

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

   תשובה

   {
     "kind": "sql#operation",
     "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME",
     "status": "PENDING",
     "user": "user@example.com",
     "insertTime": "2020-01-21T22:43:37.981Z",
     "operationType": "UPDATE",
     "name": "OPERATION_ID",
     "targetId": "INSTANCE_NAME",
     "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
     "targetProject": "PROJECT_ID"
   }
   

3. יצירת העתק לקריאה

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

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

   • ‫project-id: מזהה הפרויקט
   • ‫database-version: מחרוזת גרסת ה-Enum (לדוגמה, MYSQL_8_0)
   • ‫primary-instance-name: השם של המופע הראשי
   • ‫primary-instance-region: האזור של המכונה הראשית
   • ‫replica-region: האזור של מכונת הרפליקה
   • ‫replica-name: השם של מכונת הרפליקה
   • ‫machine-type: מחרוזת enum של סוג המכונה. לדוגמה: db-custom-1-3840
   • ‫private-network: הרשת המורשית שמוסיפים או בוחרים כדי ליצור חיבור פרטי.

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

   ה-method של ה-HTTP וכתובת ה-URL:

   POST https://sqladmin.googleapis.com/v1/projects/project-id/instances

   תוכן בקשת JSON:

   {
     "masterInstanceName": "primary-instance-name",
     "project": "project-id",
     "databaseVersion": "database-version",
     "name": "replica-name",
     "region": "replica-region",
     "settings":
     {
       "tier": "machine-type",
       "settingsVersion": 0,
       "ipConfiguration": {
       object (IpConfiguration)
     },
     {
     "ipv4Enabled": false,
     "privateNetwork": private-network,
     "requireSsl": boolean,
     "authorizedNetworks": [
       {
         object (AclEntry)
       }
     ],
     "allocatedIpRange": string
       }
     },
     "sqlNetworkArchitecture": "NEW_NETWORK_ARCHITECTURE"
   }
   

   כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

   ‫Curl (Linux,‏ macOS או Cloud Shell)

   שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

   curl -X POST \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "Content-Type: application/json; charset=utf-8" \
        -d @request.json \
        "https://sqladmin.googleapis.com/v1/projects/project-id/instances"

   ‎PowerShell (Windows)

   שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method POST `
       -Headers $headers `
       -ContentType: "application/json; charset=utf-8" `
       -InFile request.json `
       -Uri "https://sqladmin.googleapis.com/v1/projects/project-id/instances" | Select-Object -Expand Content

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

   תשובה

   {
     "kind": "sql#operation",
     "targetLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id",
     "status": "PENDING",
     "user": "user@example.com",
     "insertTime": "2020-01-21T22:43:37.981Z",
     "operationType": "CREATE_REPLICA",
     "name": "operation-id",
     "targetId": "instance-id",
     "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id",
     "targetProject": "project-id"
   }
   

REST v1beta4

1. קבלת הגדרות הגיבוי הנוכחיות

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

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

   • ‫project-id: מזהה הפרויקט
   • ‫primary-instance-name: השם של המופע הראשי

   ה-method של ה-HTTP וכתובת ה-URL:

   GET https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/primary-instance-name

   כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

   ‫Curl (Linux,‏ macOS או Cloud Shell)

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

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/primary-instance-name"

   ‎PowerShell (Windows)

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

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/primary-instance-name" | Select-Object -Expand Content

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

   תשובה

   "backupConfiguration": {
       "kind": "sql#backupConfiguration",
       "startTime": "12:00",
       "enabled": false,
       "binaryLogEnabled": false
   }
   

2. מוודאים שהשדות של השכפול מוגדרים

   אם enabled או binaryLogEnabled מוגדרים כ-false במופע הראשי, צריך להשתמש בשיטה patch של משאב המופעים כדי להפעיל את שניהם. בבקשה, מציינים את המאפיינים של הגדרת הגיבוי שרוצים לשנות.

   כדי להפעיל גיבויים, מגדירים את enabled ל-true ואת startTime לשעה ביום בפורמט HH:MM. הפרמטר startTime מצוין בפורמט של 24 שעות, באזור הזמן UTC±00, ומציין את ההתחלה של חלון גיבוי של 4 שעות. הגיבויים יכולים להתחיל בכל שלב במהלך חלון הגיבוי.

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

   רישום בינארי נתמך במופעי העתקה לקריאה (ב-MySQL 5.7 ואילך בלבד). מפעילים רישום בינארי ברפליקה באמצעות אותו API, ומזינים את מזהה המופע של הרפליקה במקום מזהה המופע של השרת הראשי.

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

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

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

   • ‫PROJECT_ID: המזהה או מספר הפרויקט של פרויקט Cloud de Confiance שמכיל את המופע
   • ‫INSTANCE_NAME: השם של המופע הראשי או של העותק לקריאה שאתם מגדירים עבור זמינות גבוהה
   • ‫START_TIME: השעה (בדקות ושעות)

   ה-method של ה-HTTP וכתובת ה-URL:

   PATCH https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME

   תוכן בקשת JSON:

   {
     "settings":
     {
       "backupConfiguration":
       {
         "startTime": "START_TIME",
         "enabled": true,
         "binaryLogEnabled": true
       }
     }
   }
   

   כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

   ‫Curl (Linux,‏ macOS או Cloud Shell)

   שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

   curl -X PATCH \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "Content-Type: application/json; charset=utf-8" \
        -d @request.json \
        "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME"

   ‎PowerShell (Windows)

   שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method PATCH `
       -Headers $headers `
       -ContentType: "application/json; charset=utf-8" `
       -InFile request.json `
       -Uri "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

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

   תשובה

   {
     "kind": "sql#operation",
     "targetLink": "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME",
     "status": "PENDING",
     "user": "user@example.com",
     "insertTime": "2020-01-21T22:43:37.981Z",
     "operationType": "UPDATE",
     "name": "OPERATION_ID",
     "targetId": "INSTANCE_NAME",
     "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
     "targetProject": "PROJECT_ID"
   }
   

3. יצירת העתק לקריאה

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

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

   • ‫project-id: מזהה הפרויקט
   • ‫database-version: מחרוזת גרסת ה-Enum (לדוגמה, MYSQL_8_0)
   • ‫primary-instance-name: השם של המופע הראשי
   • ‫primary-instance-region: האזור של המכונה הראשית
   • ‫replica-region: האזור של מכונת הרפליקה
   • ‫replica-name: השם של מכונת הרפליקה
   • ‫machine-type: מחרוזת enum של סוג המכונה. לדוגמה: db-custom-1-3840
   • ‫private-network: הרשת המורשית שמוסיפים או בוחרים כדי ליצור חיבור פרטי.

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

   ה-method של ה-HTTP וכתובת ה-URL:

   POST https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances

   תוכן בקשת JSON:

   {
     "masterInstanceName": "primary-instance-name",
     "project": "project-id",
     "databaseVersion": "database-version",
     "name": "replica-name",
     "region": "replica-region",
     "settings":
     {
       "tier": "machine-type",
       "settingsVersion": 0,
       
       "ipConfiguration": {
       object (IpConfiguration)
     },
     {
     "ipv4Enabled": false,
     "privateNetwork": private-network,
     "requireSsl": boolean,
     "authorizedNetworks": [
       {
         object (AclEntry)
       }
     ],
     "allocatedIpRange": string
       }
       
     },
     "sqlNetworkArchitecture": "NEW_NETWORK_ARCHITECTURE"
   }
   

   כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

   ‫Curl (Linux,‏ macOS או Cloud Shell)

   שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

   curl -X POST \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "Content-Type: application/json; charset=utf-8" \
        -d @request.json \
        "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances"

   ‎PowerShell (Windows)

   שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method POST `
       -Headers $headers `
       -ContentType: "application/json; charset=utf-8" `
       -InFile request.json `
       -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances" | Select-Object -Expand Content

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

   תשובה

   {
     "kind": "sql#operation",
     "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id",
     "status": "PENDING",
     "user": "user@example.com",
     "insertTime": "2020-01-21T22:43:37.981Z",
     "operationType": "CREATE_REPLICA",
     "name": "operation-id",
     "targetId": "instance-id",
     "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
     "targetProject": "project-id"
   }
   

gcloud

כדי ליצור העתק לקריאה של מכונה, משתמשים בפקודה gcloud sql instances create:

gcloud sql instances create REPLICA_INSTANCE_NAME \
--master-instance-name=PRIMARY_INSTANCE_NAME \
--project=PROJECT_ID \
--region=REGION_NAME \
--enable-private-service-connect \
--allowed-psc-projects=ALLOWED_PROJECTS \
--availability-type=AVAILABILITY_TYPE \
--no-assign-ip

מחליפים את הפרטים הבאים:

• ‫REPLICA_INSTANCE_NAME: השם של מופע ההעתקה.
• ‫PRIMARY_INSTANCE_NAME: השם של המכונה הראשית.
• ‫PROJECT_ID: המזהה או מספר הפרויקט של פרויקט Cloud de Confiance שמכיל את המופע.
• ‫REGION_NAME: שם האזור של מכונת הרפליקה.

• ‫ALLOWED_PROJECTS: רשימה של מספרי פרויקטים או מזהי פרויקטים מותרים, מופרדים בפסיקים. אם פרויקט לא מופיע ברשימה הזו, אי אפשר להשתמש בו כדי ליצור מופע ולהפעיל בו את Private Service Connect.

  ‫Cloud SQL לא מעתיק את הפרויקטים המורשים למופע הראשי אל העותק המשוכפל. לכל העתק צריך ליצור נקודת קצה מסוג Private Service Connect. אם אתם משתמשים בשרת proxy ל-Cloud SQL Auth או במחברי שפות ל-Cloud SQL, אתם צריכים ליצור תחום DNS ורשומת DNS לרפליקות.

• ‫AVAILABILITY_TYPE: הפעלת זמינות גבוהה של המכונה. לפרמטר הזה, מציינים אחד מהערכים הבאים:
  • ‫REGIONAL: הפעלה של זמינות גבוהה. מומלץ למופעים בסביבת ייצור. המופע עובר לזמינות חלקית באזור אחר בתוך האזור שנבחר.
  • ZONAL: לא מספקות יכולת מעבר לגיבוי (failover). זה ערך ברירת המחדל.

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

REST v1

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

• ‫PRIMARY_INSTANCE_NAME: השם של המכונה הראשית.
• ‫PROJECT_ID: המזהה או מספר הפרויקט של פרויקט Cloud de Confiance שמכיל את המופע.
• ‫REPLICA_INSTANCE_NAME: השם של מופע ההעתקה.
• ‫REGION_NAME: שם האזור של מכונת הרפליקה.
• ‫MACHINE_TYPE: סוג המכונה של המופע.
• ‫AVAILABILITY_TYPE: הפעלת זמינות גבוהה של המכונה. לפרמטר הזה, מציינים אחד מהערכים הבאים:
  • ‫REGIONAL: הפעלה של זמינות גבוהה. מומלץ למופעים בסביבת ייצור. המופע עובר לזמינות חלקית באזור אחר בתוך האזור שנבחר.
  • ZONAL: לא מספקות יכולת מעבר לגיבוי (failover). זה ערך ברירת המחדל.

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

• ‫ALLOWED_PROJECTS: רשימה של מספרי פרויקטים או מזהי פרויקטים מותרים, מופרדים בפסיקים. אם פרויקט לא מופיע ברשימה הזו, אי אפשר להשתמש בו כדי ליצור מופע ולהפעיל בו את Private Service Connect.

  ‫Cloud SQL לא מעתיק את הפרויקטים המורשים למופע הראשי אל העותק המשוכפל. לכל העתק צריך ליצור נקודת קצה מסוג Private Service Connect. אם אתם משתמשים בשרת proxy ל-Cloud SQL Auth או במחברי שפה ל-Cloud SQL, אתם צריכים ליצור תחום DNS ורשומת DNS עבור הרפליקות.

ה-method של ה-HTTP וכתובת ה-URL:

POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances

תוכן בקשת JSON:

{
  "masterInstanceName": "PRIMARY_INSTANCE_NAME",
  "project": "PROJECT_ID",
  "databaseVersion": "MYSQL_8_0",
  "name": "REPLICA_INSTANCE_NAME",
  "region": "REGION_NAME",
  "kind": "sql#instance",
  "settings":
  {
    "tier": "MACHINE_TYPE",
    "availabilityType": "AVAILABILITY_TYPE",
    "settingsVersion": 0,
    "ipConfiguration": {
      "ipv4Enabled": false,
      "pscConfig": {
        "allowedConsumerProjects": [ALLOWED_PROJECTS],
        "pscEnabled": true
      }
    },
    "kind": "sql#settings",
    "pricingPlan": "PER_USE",
    "replicationType": "ASYNCHRONOUS",
    "tier": "MACHINE_TYPE"
  }
}

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances" | Select-Object -Expand Content

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

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/REPLICA_INSTANCE_NAME",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "operationType": "CREATE_REPLICA",
  "name": "OPERATION_ID",
  "targetId": "REPLICA_INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta4

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

• ‫PRIMARY_INSTANCE_NAME: השם של המכונה הראשית.
• ‫PROJECT_ID: המזהה או מספר הפרויקט של פרויקט Cloud de Confiance שמכיל את המופע.
• ‫REPLICA_INSTANCE_NAME: השם של מופע ההעתקה.
• ‫REGION_NAME: שם האזור של מכונת הרפליקה.
• ‫MACHINE_TYPE: סוג המכונה של המופע.
• ‫AVAILABILITY_TYPE: הפעלת זמינות גבוהה של המכונה. לפרמטר הזה, מציינים אחד מהערכים הבאים:
  • ‫REGIONAL: הפעלה של זמינות גבוהה. מומלץ למופעים בסביבת ייצור. המופע עובר לזמינות חלקית באזור אחר בתוך האזור שנבחר.
  • ZONAL: לא מספקות יכולת מעבר לגיבוי (failover). זה ערך ברירת המחדל.

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

• ‫ALLOWED_PROJECTS: רשימה של מספרי פרויקטים או מזהי פרויקטים מותרים, מופרדים בפסיקים. אם פרויקט לא מופיע ברשימה הזו, אי אפשר להשתמש בו כדי ליצור מופע ולהפעיל בו את Private Service Connect.

  ‫Cloud SQL לא מעתיק את הפרויקטים המורשים למופע הראשי אל העותק המשוכפל. לכל העתק צריך ליצור נקודת קצה מסוג Private Service Connect. אם אתם משתמשים בשרת proxy ל-Cloud SQL Auth או במחברי שפה ל-Cloud SQL, אתם צריכים ליצור תחום DNS ורשומת DNS עבור הרפליקות.

ה-method של ה-HTTP וכתובת ה-URL:

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances

תוכן בקשת JSON:

{
  "masterInstanceName": "PRIMARY_INSTANCE_NAME",
  "project": "PROJECT_ID",
  "databaseVersion": "MYSQL_8_0",
  "name": "REPLICA_INSTANCE_NAME",
  "region": "REGION_NAME",
  "kind": "sql#instance",
  "settings":
  {
    "tier": "MACHINE_TYPE",
    "availabilityType": "AVAILABILITY_TYPE",
    "settingsVersion": 0,
    "ipConfiguration": {
      "ipv4Enabled": false,
      "pscConfig": {
        "allowedConsumerProjects": [ALLOWED_PROJECTS],  
        "pscEnabled": true
      }
    },
    "kind": "sql#settings",
    "pricingPlan": "PER_USE",
    "replicationType": "ASYNCHRONOUS",
    "tier": "MACHINE_TYPE"
  }
}

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances" | Select-Object -Expand Content

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

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/REPLICA_INSTANCE_NAME",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "operationType": "CREATE_REPLICA",
  "name": "OPERATION_ID",
  "targetId": "REPLICA_INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

המסוף

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

   כניסה לדף Cloud SQL Instances

2. ב-MySQL 5.7 ואילך, מפעילים שכפול.
3. לוחצים על הכרטיסייה Replicas (עותקים) של העותק שישמש כעותק אב לעותק שרוצים ליצור.
4. לוחצים על יצירת העתק.
5. בדף Create read replica (יצירת רפליקה לקריאה), מעדכנים את מזהה המופע ואת כל אפשרויות ההגדרה האחרות, כולל השם, האזור והתחום.
6. לוחצים על יצירה.

   מערכת Cloud SQL יוצרת רפליקה. אתם חוזרים לדף המופע של העותק הראשי.

7. חוזרים על שלבים 4-6 לכל העתק חדש של נתונים שרוצים ליצור.

gcloud

1. אם אתם משתמשים ב-MySQL בגרסה 5.7 ואילך, צריך להפעיל את קובצי ה-binlog עבור השרת הראשי של העותק החדש:
   
   ‫

   gcloud sql instances patch --enable-bin-log PARENT_REPLICA_NAME

   מחליפים את PARENT_REPLICA_NAME בשם של העותק הראשי.
2. יוצרים את העותק החדש על ידי ציון העותק הראשי כמכונה הראשית באמצעות הדגל --master-instance-name:

gcloud sql instances create REPLICA_NAME \
      --master-instance-name=PARENT_REPLICA_NAME \

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

• ‫REPLICA_NAME: המזהה הייחודי של העותק שאתם יוצרים
• ‫PARENT_REPLICA_NAME: השם של העותק הראשי
3. אחרי שיוצרים את העותק המשוכפל המדורג, אפשר לראות שהשינויים שבוצעו במופע הראשי משוכפלים בכל העותקים המשוכפלים בשרשרת של העותקים המשוכפלים המדורגים.

curl

1. אם אתם משתמשים ב-MySQL בגרסה 5.7 ואילך, צריך להפעיל רישום ביומן בינארי:
   
   כדי להפעיל רישום ביומן בינארי, שומרים את ה-JSON הבא בקובץ בשם request.JSON, ואז מפעילים את פקודת ה-curl כדי להפעיל רישום ביומן בינארי.
   

   {
     "settings":
     {
       "backupConfiguration":
       {
         "enabled": false,
         "binaryLogEnabled": true
       }
     }
   }

2. כדי ליצור העתק משוכפל מתחת להעתק האב, עורכים את קוד ה-JSON לדוגמה הבא ושומרים אותו בקובץ בשם request.json:

   {
     "masterInstanceName": "PARENT_REPLICA_NAME",
     "project": "PROJECT_ID",
     "name": "REPLICA_NAME",
     "region": "REPLICA_REGION",
     "settings":
       {
         "tier": "MACHINE_TYPE",
       }
   }

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

   curl -X POST
   -H "Authorization: Bearer "$(gcloud auth print-access-token)
   -H "Content-Type: application/json; charset=utf-8"
   -d @request.json
   "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances"