קריאה של נתוני התאמה אוטומטית לעומס (autoscaling) של מאגר

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

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

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

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

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

בטבלה הבאה מפורטות המגבלות של כל מדד יעד:

שם מדד היעד מגבלות מדד ציבורי קשור
ממוצע ניצול המעבד בין 0.1 ל-0.9. ממוצע ניצול המעבד (cloudsql.googleapis.com/database/cpu/utilization) בצמתים של מאגר הקריאה במאגר הקריאה.
חיבורים ממוצעים למסד נתונים בין 10 ל-100,000. הערה: הערך המקסימלי הקביל תואם לערך המקסימלי שמוגדר על ידי דגל מסד הנתונים max_connections. מייצג ממוצע של חיבורי לקוחות למסד נתונים (cloudsql.googleapis.com/database/network/connections) בצמתים של מאגר הקריאה במאגר הקריאה.

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

קריאת מאפייני התאמה אוטומטית של גודל המאגר

המאפיינים הבאים רלוונטיים:

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

מגבלות

יש הגבלות:

  • אם רוצים ליצור מאגר קריאה חדש או לשנות את הגודל של מאגר קריאה קיים, צריך לחכות עד שהפעולות הקודמות של יצירה ושינוי גודל יושלמו. זה חל על פעולות שמשויכות למאגר הקריאה וגם על מאגרי קריאה אחרים שמשויכים לאותו מופע ראשי. אם מנסים להפעיל פעולות בו-זמניות, יכול להיות שתופיע הודעת השגיאה הבאה: 
    Operation failed because another operation was already in progress.

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

יצירת מאגר קריאה עם הפעלה של התאמה אוטומטית לעומס

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

gcloud

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

  gcloud sql instances create READ_POOL_NAME \
  --tier=MACHINE_TIER --edition=ENTERPRISE_PLUS \
  --instance-type=READ_POOL_INSTANCE --node-count=NODE_COUNT \
  --database-version=DATABASE_VERSION \
  --master-instance-name=PRIMARY_INSTANCE_NAME \
  --region=REGION --network=NETWORK_NAME \
  --no-assign-ip \
  --auto-scale-enabled \
  --auto-scale-max-node-count=MAX_NODE_COUNT \
  --auto-scale-min-node-count=MIN_NODE_COUNT \
  --auto-scale-target-metrics=TARGET_METRIC_1=VALUE_1

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

  • ‫READ_POOL_NAME: השם שרוצים להקצות למאגר הקריאה.
  • ‫MACHINE_TIER: רמת המכונה שרוצים להשתמש בה, למשל db-perf-optimized-N-2.
  • ‫NODE_COUNT: מספר הצמתים במאגר הקריאה שרוצים להתחיל איתו.
  • ‫DATABASE_VERSION: גרסת מסד הנתונים שרוצים להשתמש בה, כמו POSTGRES_16.
  • ‫PRIMARY_INSTANCE_NAME: השם של המכונה הראשית שרוצים להשתמש בה.
  • ‫REGION: האזור שבו רוצים להשתמש, למשל us-east1.
  • ‫NETWORK_NAME: השם של הרשת שבה רוצים להשתמש.
  • ‫MAX_NODE_COUNT: המספר המקסימלי של צמתי מאגר קריאה שרוצים להשתמש בהם במאגר הקריאה, למשל 5.
  • ‫MIN_NODE_COUNT: מספר הצמתים המינימלי במאגר הקריאה שרוצים להשתמש בו, למשל 1.
  • ‫TARGET_METRIC_1: מדד היעד שרוצים להשתמש בו, למשל:
    • AVERAGE_CPU_UTILIZATION
    • AVERAGE_DB_CONNECTIONS
    צריך להגדיר לפחות אחד משני המדדים שזמינים.
  • ‫VALUE_1: הערך שרוצים להקצות למדד היעד שצוין קודם. לדוגמה, למדד היעד AVERAGE_CPU_UTILIZATION אפשר להקצות את הערך 0.50.

Terraform

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

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


resource "google_sql_database_instance" "primary" {
  name             = "mysql-primary"
  database_version = "MYSQL_8_4"
  region           = "europe-west4"

  instance_type = "CLOUD_SQL_INSTANCE"

  settings {
    tier    = "db-perf-optimized-N-2"
    edition = "ENTERPRISE_PLUS"

    backup_configuration {
      enabled            = true
      binary_log_enabled = true
    }

    ip_configuration {
      ipv4_enabled = true
    }
  }
}

resource "google_sql_database_instance" "replica" {
  name             = "mysql-replica"
  database_version = "MYSQL_8_4"
  region           = "europe-west4"

  master_instance_name = google_sql_database_instance.primary.name
  instance_type        = "READ_POOL_INSTANCE"
  node_count           = 2

  settings {
    tier    = "db-perf-optimized-N-2"
    edition = "ENTERPRISE_PLUS"

    ip_configuration {
      ipv4_enabled = true
    }
    read_pool_auto_scale_config {
      enabled                    = true
      disable_scale_in           = false
      max_node_count             = 20
      min_node_count             = 2
      scale_in_cooldown_seconds  = 600
      scale_out_cooldown_seconds = 600
      target_metrics {
        metric       = "AVERAGE_CPU_UTILIZATION"
        target_value = 0.5
      }
    }
  }
}

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

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

הכנת Cloud Shell

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

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

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

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

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

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

  1. כדי להשבית את ההגנה מפני מחיקה, בקובץ התצורה של Terraform מגדירים את הארגומנט deletion_protection לערך false. 
    deletion_protection =  "false"
  2. מריצים את הפקודה הבאה ומזינים yes בהודעה שמופיעה, כדי להחיל את הגדרות Terraform המעודכנות: 
    terraform apply

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

    terraform destroy

REST v1

כדי ליצור מאגר קריאה עם הפעלה של התאמה אוטומטית לעומס, משתמשים בבקשת POST עם ה-method‏ instances:insert.

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

  • ‫READ_POOL_NAME: השם שרוצים להקצות למאגר הקריאה.
  • ‫REGION: האזור שבו רוצים שהמכונה תמוקם, למשל us-central1.
  • ‫PRIMARY_INSTANCE_ID: המזהה של המכונה הראשית שרוצים להשתמש בה.
  • ‫PROJECT_ID: מזהה הפרויקט שבו רוצים למקם את מאגר הקריאה, למשל my-project-name.
  • ‫DATABASE_VERSION: גרסת מסד הנתונים שרוצים להשתמש בה, כמו MYSQL_8_0_37.
  • ‫MACHINE_TIER: רמת המכונה שרוצים להשתמש בה, למשל db-perf-optimized-N-2.
  • ‫FULL_NETWORK_NAME: השם של הרשת שבה רוצים להשתמש.
  • ‫MAX_NODE_COUNT: המספר המקסימלי של צמתים במאגר הקריאה שרוצים להשתמש בהם, למשל 10.
  • ‫MIN_NODE_COUNT: מספר הצמתים המינימלי במאגר הקריאה שרוצים להשתמש בו, למשל 2.
  • ‫TARGET_METRIC_1: מדד היעד שרוצים להשתמש בו, כמו AVERAGE_CPU_UTILIZATION או AVERAGE_DB_CONNECTIONS. צריך להגדיר לפחות אחד משני המדדים שזמינים.
  • ‫VALUE_1: הערך שרוצים להקצות למדד היעד שצוין קודם. לדוגמה, למדד היעד AVERAGE_CPU_UTILIZATION אפשר להקצות את הערך 0.50.
  • ‫NODE_COUNT: מספר הצמתים במאגר הקריאה שרוצים להתחיל איתו, למשל 3.

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

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

תוכן בקשת JSON: 

{
  "name":"READ_POOL_NAME",
  "region":"REGION",
  "masterInstanceName":"PRIMARY_INSTANCE_ID",
  "project":"PROJECT_ID",
  "databaseVersion":"DATABASE_VERSION",
  "settings":{
    "tier":"MACHINE_TIER",
    "edition":"ENTERPRISE_PLUS",
    "ipConfiguration":{
      "privateNetwork":"FULL_NETWORK_NAME",
      "ipv4Enabled": false
    },
    "readPoolAutoScaleConfig":{
      "enabled": true,
      "minNodeCount": MIN_NODE_COUNT,
      "maxNodeCount": MAX_NODE_COUNT,
      "targetMetrics": [
        {
          "metric":"TARGET_METRIC_1",
          "targetValue": VALUE_1
        }
      ]
    }
  },
  "instanceType":"READ_POOL_INSTANCE",
  "nodeCount": NODE_COUNT
}

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

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

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/PRIMARY_INSTANCE_ID",
  "status": "RUNNING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "startTime": "2023-06-14T18:48:35.499Z",
  "operationType": "CREATE",
  "name": "OPERATION_ID",
  "targetId": "PRIMARY_INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta4

כדי ליצור מאגר קריאה עם הפעלה של התאמה אוטומטית לעומס, משתמשים בבקשת POST עם ה-method‏ instances:insert.

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

  • ‫READ_POOL_NAME: השם שרוצים להקצות למאגר הקריאה.
  • ‫REGION: האזור שבו רוצים שהמכונה תמוקם, למשל us-central1.
  • ‫PRIMARY_INSTANCE_ID: המזהה של המכונה הראשית שרוצים להשתמש בה.
  • ‫PROJECT_ID: מזהה הפרויקט שבו רוצים למקם את מאגר הקריאה, למשל my-project-name.
  • ‫DATABASE_VERSION: גרסת מסד הנתונים שרוצים להשתמש בה, כמו MYSQL_8_0_37.
  • ‫MACHINE_TIER: רמת המכונה שרוצים להשתמש בה, למשל db-perf-optimized-N-2.
  • ‫FULL_NETWORK_NAME: השם של הרשת שבה רוצים להשתמש.
  • ‫MAX_NODE_COUNT: המספר המקסימלי של צמתים במאגר הקריאה שרוצים להשתמש בהם, למשל 10.
  • ‫MIN_NODE_COUNT: מספר הצמתים המינימלי במאגר הקריאה שרוצים להשתמש בו, למשל 2.
  • ‫TARGET_METRIC_1: מדד היעד שרוצים להשתמש בו, למשל:
    • AVERAGE_CPU_UTILIZATION
    • AVERAGE_DB_CONNECTIONS
    צריך להגדיר לפחות אחד משני המדדים שזמינים.
  • ‫VALUE_1: הערך שרוצים להקצות למדד היעד שצוין קודם. בדוגמה הזו, למדד היעד AVERAGE_CPU_UTILIZATION מוקצה הערך 0.50.
  • ‫NODE_COUNT: מספר הצמתים במאגר הקריאה שרוצים להתחיל איתו, למשל 3.

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

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

תוכן בקשת JSON: 

{
  "name":"READ_POOL_NAME",
  "region":"REGION",
  "masterInstanceName":"PRIMARY_INSTANCE_ID",
  "project":"PROJECT_ID",
  "databaseVersion":"DATABASE_VERSION",
  "settings":{
    "tier":"MACHINE_TIER",
    "edition":"ENTERPRISE_PLUS",
    "ipConfiguration":{
      "privateNetwork":"FULL_NETWORK_NAME",
      "ipv4Enabled": false
    },
    "readPoolAutoScaleConfig":{
      "enabled": true,
      "minNodeCount": MIN_NODE_COUNT,
      "maxNodeCount": MAX_NODE_COUNT,
      "targetMetrics": [
        {
          "metric":"TARGET_METRIC_1",
          "targetValue": VALUE_1
        }
      ]
    }
  },
  "instanceType":"READ_POOL_INSTANCE",
  "nodeCount": NODE_COUNT
}

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

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

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/PRIMARTY_INSTANCE_ID",
  "status": "RUNNING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "startTime": "2023-06-14T18:48:35.499Z",
  "operationType": "CREATE",
  "name": "OPERATION_ID",
  "targetId": "PRIMARTY_INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

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

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

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

gcloud

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

  gcloud sql instances patch INSTANCE
  --auto-scale-enabled
  --auto-scale-max-node-count=MAX_NODE_COUNT
  --auto-scale-min-node-count=MIN_NODE_COUNT
  --auto-scale-out-cooldown-seconds=COOLDOWN_SECONDS_SCALE_OUT
  --auto-scale-in-cooldown-seconds=COOLDOWN_SECONDS_SCALE_IN
  --auto-scale-target-metrics=TARGET_METRIC_1=VALUE_1

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

  • ‫INSTANCE_NAME: שם המכונה שמשויך למאגר הקריאה שרוצים לשנות.
  • ‫MAX_NODE_COUNT: המספר המקסימלי של צמתים במאגר הקריאה שרוצים להשתמש בהם, למשל 10.
  • ‫MIN_NODE_COUNT: מספר הצמתים המינימלי במאגר הקריאה שרוצים להשתמש בו, למשל 2.
  • ‫COOLDOWN_SECONDS_SCALE_OUT: אופציונלי: זמן ההמתנה בשניות בין יצירה או מחיקה של צומת במאגר הקריאה, כמו 180. נדרש תקופת צינון מינימלית של 60 שניות. ערך ברירת המחדל הוא 600 שניות.
  • ‫COOLDOWN_SECONDS_SCALE_IN: אופציונלי: זמן ההמתנה בשניות בין יצירה או מחיקה של צומת במאגר הקריאה, כמו 180. נדרש תקופת צינון מינימלית של 60 שניות. ערך ברירת המחדל הוא 600 שניות.
  • ‫TARGET_METRIC_1: מדד היעד שרוצים להשתמש בו, למשל:
    • AVERAGE_CPU_UTILIZATION
    • AVERAGE_DB_CONNECTIONS
    צריך להגדיר לפחות אחד משני המדדים שזמינים.
  • ‫VALUE_1: הערך שרוצים להקצות למדד היעד שצוין קודם. בדוגמה הזו, למדד היעד AVERAGE_DB_CONNECTIONS מוקצה הערך 50.

REST v1

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

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

  • ‫PROJECT_ID: המזהה או מספר הפרויקט של Google Cloud הפרויקט שמכיל את המופע.
  • ‫INSTANCE_ID: המזהה של המכונה שמשויכת למאגר הקריאה.
  • ‫MAX_NODE_COUNT: המספר המקסימלי של צמתים במאגר הקריאה שרוצים להשתמש בהם, למשל 10.
  • ‫MIN_NODE_COUNT: מספר הצמתים המינימלי במאגר הקריאה שרוצים להשתמש בו, למשל 2.
  • ‫COOLDOWN_SECONDS: אופציונלי: זמן ההמתנה בשניות בין יצירה או מחיקה של צומת במאגר הקריאה, כמו 180.
  • SCALE_IN_DISABLED: אופציונלי: מאפשר להשבית את ההתנהגות של הקטנת המאגר לקריאה. כדי להשבית את ההקטנה של מאגר הקריאה, מגדירים את הערך ל-true.
  • ‫TARGET_METRIC_1: מדד היעד שרוצים להשתמש בו, למשל:
    • AVERAGE_CPU_UTILIZATION
    • AVERAGE_DB_CONNECTIONS
    צריך להגדיר לפחות אחד משני המדדים שזמינים.
  • ‫VALUE_1: הערך שרוצים להקצות למדד היעד שצוין קודם. בדוגמה הזו, למדד היעד AVERAGE_DB_CONNECTIONS מוקצה הערך 50.

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

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

תוכן בקשת JSON: 

{
  "settings": {
    "readPoolAutoScaleConfig": {
      "enabled": true,
      "minNodeCount": MIN_NODE_COUNT,
      "maxNodeCount": MAX_NODE_COUNT,
      "scaleOutCooldownSeconds": COOLDOWN_SECONDS,
      "disableScaleIn": SCALE_IN_DISABLED,
      "targetMetrics": [
        {
          "metric": "TARGET_METRIC_1",
          "targetValue": VALUE_1
        }
      ]
    }
  }
}

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

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

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "RUNNING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "startTime": "2023-06-14T18:48:35.499Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta4

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

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

  • ‫PROJECT_ID: המזהה או מספר הפרויקט של Google Cloud הפרויקט שמכיל את המופע.
  • ‫INSTANCE_ID: המזהה של המכונה שמשויכת למאגר הקריאה.
  • ‫MAX_NODE_COUNT: המספר המקסימלי של צמתים במאגר הקריאה שרוצים להשתמש בהם, למשל 10.
  • ‫MIN_NODE_COUNT: מספר הצמתים המינימלי במאגר הקריאה שרוצים להשתמש בו, למשל 2.
  • ‫COOLDOWN_SECONDS: אופציונלי: זמן ההמתנה בשניות בין יצירה או מחיקה של צומת במאגר הקריאה, כמו 180.
  • SCALE_IN_DISABLED: אופציונלי: מאפשר להשבית את ההתנהגות של הקטנת המאגר לקריאה. כדי להשבית את ההקטנה של מאגר הקריאה, מגדירים את הערך ל-true.
  • ‫TARGET_METRIC_1: מדד היעד שרוצים להשתמש בו, למשל:
    • AVERAGE_CPU_UTILIZATION
    • AVERAGE_DB_CONNECTIONS
    צריך להגדיר לפחות אחד משני המדדים שזמינים.
  • ‫VALUE_1: הערך שרוצים להקצות למדד היעד שצוין קודם. בדוגמה הזו, למדד היעד AVERAGE_DB_CONNECTIONS מוקצה הערך 50.

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

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

תוכן בקשת JSON: 

{
  "settings": {
    "readPoolAutoScaleConfig": {
      "enabled": true,
      "minNodeCount": MIN_NODE_COUNT,
      "maxNodeCount": MAX_NODE_COUNT,
      "scaleOutCooldownSeconds": COOLDOWN_SECONDS,
      "disableScaleIn": SCALE_IN_DISABLED,
      "targetMetrics": [
        {
          "metric": "TARGET_METRIC_1",
          "targetValue": VALUE_1
        }
      ]
    }
  }
}

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

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

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "RUNNING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "startTime": "2023-06-14T18:48:35.499Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

השבתת שינוי גודל אוטומטי של מאגר קריאה במאגר קריאה

כדי להשבית את התאמה אוטומטית לעומס (automatic scaling) של מאגר הקריאה:

gcloud

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

  gcloud sql instances patch INSTANCE_NAME
  --no-auto-scale-enabled

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

  • ‫INSTANCE_NAME: שם המכונה שמשויך למאגר הקריאה שרוצים לשנות.

REST v1

כדי להשבית את ההתאמה האוטומטית לעומס של מאגר הקריאה, משתמשים בשיטת PATCH.

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

  • ‫PROJECT_ID: המזהה או מספר הפרויקט של הפרויקט שמכיל את המופע. Google Cloud
  • ‫INSTANCE_ID: המזהה של המכונה שמשויכת למאגר הקריאה.

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

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

תוכן בקשת JSON: 

{
  "settings":{
    "readPoolAutoScaleConfig":{
      "enabled": false
    }
  }
}

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

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

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "RUNNING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "startTime": "2023-06-14T18:48:35.499Z",
  "operationType": "CREATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta4

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

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

  • ‫PROJECT_ID: המזהה או מספר הפרויקט של הפרויקט שמכיל את המופע. Google Cloud
  • ‫INSTANCE_ID: המזהה של המכונה שמשויכת למאגר הקריאה.

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

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

תוכן בקשת JSON: 

{
  "settings":{
    "readPoolAutoScaleConfig":{
      "enabled": false
    }
  }
}

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

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

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "RUNNING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "startTime": "2023-06-14T18:48:35.499Z",
  "operationType": "CREATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

הצגת המדדים

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

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

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

מעקב אחר פעולות של התאמה אוטומטית לעומס (autoscaling) של מאגר קריאה

כשמתקיימים התנאים להפעלת אירוע של התאמה אוטומטית לעומס של מאגר קריאה, מופעלת פעולה במופע.UPDATE אפשר לראות את הפעולה הזו במסוף Google Cloud .

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

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

  Operation failed because another operation was already in progress.

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

  gcloud sql instances describe READ_POOL_NAME
  | grep nodeCount

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

  • ‫READ_POOL_NAME: השם של מאגר הקריאה שעבורו רוצים לקבל מידע.

יומני ביקורת System Event

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

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